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!

Verbesserung Zahlungen

💰 Wiederkehrende Spenden mit Windcave und Charitable akzeptieren

Ein Spender richtet seine Spende einmalig auf der sicheren Zahlungsseite von Windcave ein, und Charitable stellt danach pünktlich jede Verlängerung in Rechnung. Warum das wichtig ist:

🏦 In Neuseeland oder Australien ansässige Organisationen: Monatliche Spenden über das Gateway, mit dem Ihre Bank Sie bereits eingerichtet hat, ohne dass ein zweiter Prozessor angebunden werden muss.
⛪ Kirchen, die regelmäßige Zehnten und Opfergaben erhalten: Die Gemeindemitglieder legen einmal ihren eigenen Zeitplan fest, was der einfachste Weg ist, regelmäßige Kirchenspenden ohne eine separate Plattform zu starten.
🌏 Gruppen mit Spendern in verschiedenen Währungen: Windcave unterstützt über 20 Währungen, sodass ein Unterstützer in der Währung spenden kann, die er tatsächlich besitzt.
📅 Betriebsmittel statt einmaliger Kampagnen: Schalten Sie den Nur-wiederkehrenden-Modus ein, und die Einmal-Option verschwindet, sodass jede Spende für diese Kampagne ein Abonnement ist.
🧾 Teams ohne Entwickler im Personal: 3 Anmeldedaten in eine Einstellungsseite eingefügt, und kein Code irgendwo.

Lesen Sie hier unsere Ankündigung.

Automatisierung Aktualisierung

⚡ Visueller Automatisierungs-Builder: Drag & Drop ohne Code!

Charitable Automation Connect 2.3.0 führt den visuellen Automatisierungs-Builder ein, eine Vollbild-Leinwand, die jede Automatisierung als Fluss verbundener Karten darstellt: ein Auslöser, optionale Bedingungen und eine Liste von Aktionen, die der Reihe nach ausgeführt werden.

🧩 Viele Aktionen, ein Auslöser: Markieren Sie einen Spender, senden Sie eine E-Mail, fügen Sie eine Notiz hinzu und lösen Sie einen Webhook von einem einzelnen Ereignis aus, das in beliebiger Reihenfolge gezogen wird.

✉️ Innerhalb von Charitable handeln: Neue Aktionen wie „E-Mail senden“, „Spender markieren“ und „Spenderhinweis hinzufügen“ laufen ohne externen Dienst.

🔤 Zusammenführung-Tags: Personalisieren Sie E-Mails und Notizen mit Live-Feldern wie {first_name}, {total} und {campaign_name}.

🔁 Auf bestehende Spender anwenden: Führen Sie „Spender markieren“ und „Spenderhinweis hinzufügen“ für Ihre vorhandenen Spender aus.

🖥️ Leinwand oder Einfach: Wechseln Sie jederzeit die Ansicht, und Automatisierungen, die vor 2.3.0 erstellt wurden, funktionieren weiterhin unverändert.

Lesen Sie hier mehr.

Integration aktualisiert

📬 Brevo für Charitable vorstellen: Spender automatisch zu Abonnenten machen

Der Moment, in dem ein Unterstützer eine Spende tätigt, ist der Moment, in dem er am engagiertesten ist. Mit der neuen Brevo-Integration für Charitable können Sie einmalige Spender automatisch in langfristige Abonnenten verwandeln, ohne eine einzige Tabelle anfassen zu müssen.

Sammeln Sie einfach die Zustimmung der Spender direkt auf Ihrem Spendenformular und starten Sie sofort Ihre Willkommensserie.

Was ist neu:

🔄 Automatischer Abonnenten-Sync: Neue Spender, die zustimmen, werden sofort Ihrer Brevo-Kontaktliste hinzugefügt, sobald ihre Zahlung abgewickelt ist – keine manuellen Exporte oder CSV-Importe erforderlich.

🎯 Detaillierte Zustimmungs- & Opt-In-Kontrolle: Passen Sie die Bezeichnung Ihrer Checkbox an, wählen Sie, ob sie standardmäßig aktiviert oder deaktiviert ist, oder aktivieren Sie die Brevo-Double-Opt-In, um Ihre Liste sauber und konform zu halten.

📋 Listen-Mapping pro Kampagne: Leiten Sie Unterstützer zu Ihrer globalen E-Mail-Liste oder ordnen Sie bestimmte Kampagnen gezielten Brevo-Listen zu, um Ihre Folgekommunikation anzupassen.

⚡ 5-Minuten-Einrichtung: Stellen Sie sofort eine Verbindung her, indem Sie Ihren Brevo-API-Schlüssel in die Newsletter-Einstellungen einfügen, Ihre Kontaktfelder zuordnen und Ihre E-Mail-Liste automatisch aufbauen.

Bereit, Ihre Mailingliste zu erweitern? Brevo ist jetzt im Charitable Plus-Plan verfügbar – verbinden Sie noch heute Ihr Konto!

wiederkehrende Spenden aktualisiert

💳 Karten-Updates einführen: Abgelaufene Karten korrigieren, ohne Abos zu verlieren!

Neue abgelaufene oder aktualisierte Kreditkarten sind eines der größten stillen Lecks im wiederkehrenden Fundraising. Mit Card Updates in der Erweiterung Recurring Donations können Spender jetzt ihre Zahlungsdetails direkt aktualisieren – ihre Abonnement-, Zeitplan- und Spendenhistorie bleibt dabei vollständig erhalten.

Keine gekündigten Pläne, keine verlorene Historie und null administrativer Aufwand für Ihr Team.

Was ist neu:

⚡ 30-Sekunden-Self-Service: Spender erhalten in ihrem Dashboard eine spezielle Schaltfläche „Karte aktualisieren“, die das sichere, PCI-konforme Kundenportal von Stripe öffnet, um Kartendetails sofort zu aktualisieren.

🔒 Geltungsbereich & Sicherer Zugriff: Standardmäßig ausschließlich auf Kartenaktualisierungen beschränkt, können Spender ihre Pläne nicht versehentlich aus dem Portal heraus kündigen oder ändern, wodurch Ihre Webhooks und Daten synchron bleiben.

🤝 Unterstützung durch Administratoren: Helfen Sie einem Spender am Telefon? Öffnen Sie sein sicheres Stripe-Portal mit einem Klick von Ihrem Admin-Bildschirm aus oder generieren Sie einen Einmal-Link zur Aktualisierung, den Sie ihm per E-Mail zusenden können.

📋 Automatischer Audit Trail: Jede Aktualisierung der Zahlungsmethode wird automatisch mit einem Zeitstempel sowohl in den systemweiten Protokollen als auch im Profil des einzelnen Spenders aufgezeichnet.

Sind Sie bereit, Ihre wiederkehrenden Einnahmen zu schützen? Holen Sie sich das Plus- oder Pro-Paket, aktualisieren Sie „Wiederkehrende Spenden“ auf Version 2.3.0+ und aktivieren Sie noch heute unter „Einstellungen“ die Option „Zahlungsmethode aktualisieren“!

Integration Seiten-Ersteller

Divi-Fans jubeln! Natives Divi 5 Kampagnen-Fortschrittsbalken-Modul!

Mit unserem neuen nativen Divi 5-Modul können Sie Ihre Microsites mit Echtzeit-Fundraising-Statistiken direkt auf der visuellen Oberfläche verankern. Hier erfahren Sie, wie es funktioniert und warum es sich lohnt, es noch heute zu aktivieren.

Erstellen Sie Kampagnen-Updates, die VISUELL UND LIVE sind. Sie können auch:

📊 Fortschrittsbalken der Kampagne: Fügen Sie einen Live-Fortschrittsbalken in jedes Divi 5-Layout ein und zeigen Sie den Ziel-Fortschritt in Echtzeit an.

🎨 Tiefgreifende Styling-Steuerelemente: Passen Sie die Farbe, Höhe und den Radius des Balkens und der Anzeige einfach an, um sie perfekt an Ihre Marke anzupassen.

👁️ Visual Builder bereit: Konfigurieren und sehen Sie alles direkt auf der Divi-Oberfläche als erstklassiges Modul.

🔁 Identische Darstellung: Dieselbe exakte Engine treibt dieses Modul an, was ein konsistentes Design ohne Legacy-Workarounds bedeutet.

✅ Schnellere Starts: Verlassen Sie niemals die Divi 5-Oberfläche, um Shortcodes zu konfigurieren oder zu erraten, wie Ihre Ziel-Beschriftungen aussehen werden.

Hier mehr erfahren.