Dokumentation für Wohltätigkeitsorganisationen

Erfahren Sie, wie Sie mit klaren Schritt-für-Schritt-Anleitungen das Beste aus Charitable herausholen.

Charitable_User

Die Klasse Charitable_User ermöglicht Ihnen den Zugriff auf Informationen über einen bestimmten Benutzer.

Charitable_User ist eine Unterklasse von WP_User.

Abrufen einer Instanz von Charitable_User

Bei einer Benutzer-ID können Sie eine Charitable_User-Instanz auf eine von zwei Arten abrufen:

$user_id = 123;

// Get instance from cache
$user = charitable_get_user( $user_id );

// Direct instantiation
$user = new Charitable_User( $user_id );

Der Vorteil der Verwendung von charitable_get_user besteht darin, dass der Objektcache verwendet wird, um die Instanz von Charitable_User beizubehalten.

Eigenschaften

Charitable_User hat Zugriff auf alle gleichen Eigenschaften wie WP_User:

https://codex.wordpress.org/Class_Reference/WP_User

Methoden

get_donor_id()

Gibt die Spender-ID für diesen Benutzer zurück. Wenn dieser Benutzer noch nie gespendet hat, wird false zurückgegeben.

get_donor()

Dies gibt einen einzelnen Datensatz aus der Tabelle wp_charitable_donor für den Spender zurück.

is_donor()

Dies gibt zurück, ob der Benutzer ein Spender ist.

is_verified()

Dies gibt zurück, ob der Benutzer seine E-Mail-Adresse verifiziert hat.

mark_as_verified( $verified )

Dies legt fest, ob das Konto des Benutzers verifiziert ist.

Parameter
$verified
Boolean. Ob das Konto des Benutzers verifiziert ist.

get_email()

Gibt die E-Mail-Adresse des Benutzers zurück.

get_name()

Gibt den vollständigen Namen des Benutzers zurück. Beachten Sie, dass, wenn der Benutzer keinen Vornamen angegeben hat, nur der Nachname zurückgegeben wird; und umgekehrt.

get_first_name()

Gibt den Vornamen des Benutzers zurück.

get_last_name()

Gibt den Nachnamen des Benutzers zurück.

get_location()

Gibt den Standort des Benutzers zurück.

Wenn verfügbar, wird hier die Stadt des Benutzers gefolgt von seinem Land angezeigt; wenn keine Stadt angegeben ist, wird der Bundesstaat des Benutzers gefolgt von seinem Land angezeigt. Wenn weder Stadt noch Bundesstaat angezeigt werden, wird das Land des Benutzers zurückgegeben.

Wenn kein Land angegeben ist, werden nur die Stadt oder der Bundesstaat angezeigt.

get_address( $donation_id = '' )

Gibt die druckbare Adresse des Benutzers zurück. Wenn eine Spenden-ID angegeben ist, wird die für die Spende verwendete Adresse zurückgegeben.

Parameter
$donation_id
Optional. Wenn gesetzt, wird die Adresse für die Spende zurückgegeben. Andernfalls wird die im Spenderprofil gespeicherte Adresse zurückgegeben.

get_donations( $distinct_donations = false)

Gibt ein Array aller Spenden des Benutzers zurück.

Parameter
$distinct_donations
Boolean. Wenn true, werden nur eindeutige Spenden angezeigt.

count_donations( $distinct_donations = false)

Gibt die Anzahl der vom Spender getätigten Spenden zurück.

Parameter
$distinct_donations
Boolean. Wenn true, werden nur eindeutige Spenden gezählt.

count_campaigns_supported()

Gibt die Anzahl der Kampagnen zurück, an denen der Benutzer gespendet hat.

get_total_donated( $campaign_id = false )

Gibt den Gesamtbetrag zurück, der vom Benutzer gespendet wurde, oder den Gesamtbetrag, der von dem Benutzer für eine bestimmte Kampagne gespendet wurde.

Parameter:
$campaign_id
Optional. Wenn gesetzt, wird nur der Gesamtbetrag abgerufen, der vom Spender für die angegebene Kampagne gespendet wurde. Standardmäßig ist dies auf false gesetzt.

get_avatar( $size = 100 )

Gibt das HTML zur Anzeige des Avatars des Spenders zurück. Standardmäßig wird der mit der E-Mail-Adresse des Spenders verknüpfte Gravatar zurückgegeben.

Parameter
$size
Optional. Legt die Breite und Höhe des zurückzugebenden Avatars fest. Standardmäßig wird der Avatar mit einer Breite und Höhe von 100 Pixel zurückgegeben.

get_avatar_src( $size = 100 )

Gibt die Bildquelldatei des Avatars zurück.

Parameter
$size
Optional. Legt die Breite und Höhe des zurückzugebenden Avatars fest. Standardmäßig wird der Avatar mit einer Breite und Höhe von 100 Pixel zurückgegeben.

get_campaigns( $args = array() )

Gibt ein WP_Query-Objekt mit allen vom Spender erstellten Kampagnen zurück.

Parameter
$args
Optional. Zusätzliche Argumente, die an WP_Query übergeben werden sollen.

get_current_campaigns( $args = array() )

Gibt ein WP_Query-Objekt mit allen vom Spender erstellten Kampagnen zurück, die derzeit aktiv sind.

Parameter
$args
Optional. Zusätzliche Argumente, die an WP_Query übergeben werden sollen.

has_current_campaigns()

Gibt zurück, ob der Spender aktuelle Kampagnen hat.

get_activity( $args = array() )

Gibt ein WP_Query-Objekt mit allen Spenden und Kampagnen zurück, die vom Spender erstellt wurden, sortiert nach Datum.

Parameter
$args
Optional. Zusätzliche Argumente, die an WP_Query übergeben werden sollen.

Haben Sie noch Fragen? Wir helfen Ihnen gerne weiter!

Zuletzt geändert:

Was ist neu bei Charitable

Die neuesten Updates anzeigen
🔔 Abonnieren Sie, um unsere neuesten Updates zu erhalten
📧 E-Mails abonnieren

E-Mail-Abonnement

Abonnieren Sie unseren Newsletter

Wir werden Sie nicht spammen. Wir senden nur eine E-Mail, wenn wir glauben, dass sie Ihnen wirklich hilft. Abmeldung jederzeit möglich!

Neu Vorlagen

🤩 Neue Beacon Kampagnenvorlagen mit „Hero“-Block!

Mit den neuen Beacon Kampagnenvorlagen für Charitable Pro können Sie eine beeindruckende, bildschirmfüllende Spendenaktion starten, die sofort die Aufmerksamkeit der Besucher oberhalb der Falz erregt.

Spendenaktions-Header für Save Maple Grove Park mit einem Spenden-Widget und einem kleinen quadratischen Foto eines sonnenbeschienenen Baumes als Miniaturansicht links.

🔦 Wirkung oberhalb der Falz: Beginnen Sie mit einem bildschirmfüllenden Hero-Bild, Ihrem Logo und Ihrem Spendenziel mit einem Spenden-Widget, das direkt über dem Banner platziert ist, sodass Ihre Bitte und Ihr Schwung sofort ohne Scrollen registriert werden.

📐 Zwei flexible Layouts: Wählen Sie zwischen einem strukturierten Zwei-Spalten-Layout für nebeneinanderliegende Storys und unterstützende Details oder einer übersichtlichen Ein-Spalten-Ansicht für ununterbrochene Langform-Erzählungen.

⚡ All-in-One Hero-Feld: Angetrieben durch das neue Campaign Hero-Feld, das Hintergrundmedien, Live-Fortschrittsbalken, benutzerdefinierte Spendenbeträge und wiederkehrende Spendentabs in einem einzigen zusammenhängenden Block vereint, der in jedes Layout eingefügt werden kann.

🎨 Automatische Theme-Anpassung: Das Hero-Banner und das Spenden-Widget übernehmen automatisch die Button- und Akzentfarben Ihres Kampagnen-Themes, sodass Ihre gesamte Präsentation perfekt im Markenstil bleibt, ohne eine Zeile CSS anfassen zu müssen.

Hier mehr erfahren.

Spendenformular Funktion Neu

📝 Spendenformular-Block: Ein funktionierendes Spendenformular überall einbetten

Mit dem neuen Spendenformular-Block für Charitable Pro können Sie ein voll funktionsfähiges Spendenformular direkt auf jeder Seite oder jedem Beitrag im WordPress-Block-Editor platzieren. Keine Weiterleitungen, keine Seitenaktualisierungen und null Reibung zwischen dem Lesen Ihrer Geschichte und dem Leisten eines Beitrags.

📝 Formulare überall platzieren: Platzieren Sie ein funktionierendes Formular direkt auf Ihrer Homepage, in einem Story-basierten Blogbeitrag, auf einer speziellen Landingpage oder innerhalb einer Kampagnenankündigung.

🎯 Dynamische Kampagnenbindung: Wählen Sie einfach eine bestimmte Kampagne aus der Blockseitenleiste aus oder stellen Sie sie so ein, dass sie automatisch an die gerade angezeigte Kampagne gebunden wird.

📐 Vollständige vs. Minimale Formularansichten: Wechseln Sie zwischen einem vollständigen Layout oder einer kompakten Minimalansicht, um Seitenleisten, schmale Spalten oder breite Landingpages perfekt anzupassen.

🎨 Geltungsbereichspezifische No-Code-Stile: Passen Sie Typografie, Container-Abstände, Randradius, Betragsbuttons und Akzentfarben für jede Formularinstanz unabhängig voneinander an, ohne eine Zeile CSS zu berühren.

Hier mehr erfahren.

Botschafter Neu

👤 Erstellerprofile: Geben Sie jeder Peer-to-Peer-Kampagne ein Gesicht

Ambassadors 3.3.0 bietet jetzt Erstellerprofile – geben Sie Ihren Unterstützern ein permanentes, teilbares öffentliches Zuhause, das einmalige Spendenaktionen in dauerhafte Beziehungen verwandelt.

👤 Öffentliche Erstellerseiten: Geben Sie jedem Spendenwerber eine sofortige, übersichtliche Landingpage unter /creator/ihr-name/, um ihren benutzerdefinierten Avatar, ihre Biografie und ein durchsuchbares Raster ihrer Kampagnen zu präsentieren.

📊 Erfolgsnachweis: Steigern Sie das Vertrauen der Spender, indem Sie standortweite Meilensteine im Profil anzeigen – wie z. B. die insgesamt gesammelten Gelder und die Gesamtzahl der Spender.

💳 Interaktive Hover-Karten: Wenn Spender mit der Maus über den Namen eines Erstellers auf einer Kampagnenseite fahren, erweitert sich eine kompakte Karte mit ihrer Biografie und ihren Social-Media-Handles genau im Moment der Entscheidung.

📍 Verantwortungsvolle Standortfreigabe: Ermöglichen Sie Erstellern, ihren Standort sicher mitzuzeigen, indem Sie nur Stadt-, Bundesland- und Landesdetails verwenden.

🛠️ Eigenständige Anpassung: Spendenwerber können ihre eigenen Profile aktualisieren und bis zu sechs soziale Netzwerke direkt aus dem Hub „Meine Kampagnen“ verknüpfen, was Ihnen Administratorzeit spart.

Bereit, Ihre Fürsprecher zu stärken? Aktualisieren Sie auf Ambassadors 3.3.0 und aktivieren Sie noch heute „Öffentliche Erstellerseite aktivieren“!

Verbesserung Zahlungen

📱 Verwandeln Sie mobile Scroller in Spender: Treffen Sie Charitable's Mollie Upgrade

Verlieren Sie mobile Unterstützer, weil sie es hassen, lange Kartennummern auf ihren Handys einzugeben? Charitable's aktualisierte Mollie-Integration bietet:

⚡ One-Tap Wallet Checkout: Ermöglichen Sie Spendern, ihre Geschenke sofort mit Apple Pay oder Google Pay mit einem einfachen Gesichtsscan, Fingerabdruck oder Tippen abzuschließen.

💰 Keine zusätzliche PCI-Belastung: Überspringen Sie komplexe Domain-Verifizierung und Sicherheitskonformität, da alle Wallet-Transaktionen sicher über den gehosteten Checkout von Mollie abgewickelt werden.

🛠️ Benutzerdefinierte Abbruch-Weiterleitung: Sorgen Sie für ein vorhersehbares Erlebnis, indem Sie Spender, die abbrechen, automatisch an Ihre Abbruchseite weiterleiten, oder verwenden Sie Entwicklerfilter, um sie zu einer benutzerdefinierten Seite weiterzuleiten.

Besuchen Sie diese Seite, um mehr zu erfahren.

Botschafter verbessert Neu

Moderations- und Verzeichnisbildschirme in Ambassadors 3.0

Ambassadors 3.0 hat neue Funktionen: Moderations- und Verzeichnisbildschirme… sehen Sie jetzt ganz einfach diejenigen, die Spenden in Ihrem Peer-to-Peer-Netzwerk erhalten – einschließlich Kampagnenerstellern, die möglicherweise verifiziert werden müssen – alles an einem Ort. Generieren Sie Berichte, senden Sie E-Mails direkt an Botschafter und Kampagnenersteller und mehr.

🚀 Sehen Sie, wann Kampagnenersteller und Botschafter ihre Kampagnen aktualisiert haben, welche Spender/Spenden sie eingebracht haben und mehr.

🎉 Botschafter und Kampagnenersteller manuell hinzufügen und mit einem Klick genehmigen!

Besuchen Sie diese Seite, um mehr zu erfahren.