Dokumentation für Wohltätigkeitsorganisationen

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

Charitable Tributes: Einstellungen, Integrationen und Entwicklerreferenz

Erfordert: 

  • Charitable Pro 1.8.16+
  • Karitative Ehrungen 1.0.0+

Diese Seite ist die vollständige Referenz für Charitable Tributes: jede Einstellung, die Sie ändern können, wie sie mit den anderen Charitable Add-ons funktioniert und die vollständige Entwickler-Oberfläche von Hooks, AJAX-Aktionen, REST-Endpunkten und Vorlagen.

Wenn Sie nach einer bestimmten Aufgabe suchen, sind die fokussierten Anleitungen normalerweise ein besserer Ausgangspunkt. Diese Seite ist die Karte von allem.

Tributes Einstellungen

Alle Einstellungen befinden sich unter Charitable » Tributes » Settings und sind in Tabs organisiert.

Allgemein

  • Standard-Datenschutzniveau – das Datenschutzniveau, das für neue Geehrte gilt (öffentlich, Familienzustimmung, Mitglieder oder privater Link).
  • Standard-Tribute-Label – die Formulierung, die verwendet wird, wenn ein Tribute-Typ keine eigene angibt.
  • Formularmuster – das Standardlayout für Tribute-Felder auf Spendenformularen.
  • Spender-Kontextzeile – der Hilfetext, der über den Tribute-Feldern angezeigt wird.
  • DSGVO-Zustimmungstext – der Zustimmungstext, der angezeigt wird, wenn ein Spender beschließt, einen Angehörigen zu benachrichtigen.

Spendenformular

  • Formularmuster – wählen Sie Blöcke inline (Tribute-Felder im Betragsbereich) oder Blöcke Schritt für Schritt (Tribute-Felder in einem eigenen Schritt).
  • Spender-Kontextzeile – passen Sie den Hilfetext mit Ihrer eigenen Stimme an.

Integrationen

Ein Schalter für jede der fünf Integrationen, damit Sie jede einzelne deaktivieren können. Sehen Sie im Abschnitt  Integrationen  unten nach, was jede einzelne bewirkt.

Tributes E-Mails

  • Aktivieren und konfigurieren Sie die Tribute-Benachrichtigung, einschließlich Absendername, Absender-E-Mail und Betreffzeilen und Textkörper pro Tribute-Typ.
  • Konfigurieren Sie den Zeitplan für den Familien-Digest (aus, wöchentlich, zweiwöchentlich oder monatlich), den Tag, an dem er gesendet wird, und dessen Betreff.

Tributes E-Card

  • Aktivieren Sie das reichhaltigere E-Card-Format und legen Sie die Überschrift, die Zuschreibungszeile und die Akzentfarbe fest.
  • Legen Sie pro Tribute-Typ Betreff, Augenbraue und Schlussformulierungen fest.
  • Senden Sie eine Test-E-Card, um das Ergebnis in der Vorschau anzuzeigen.

Benutzerdefinierte Felder

Ein AJAX-gesteuerter Manager zur Definition eigener Felder für Geehrte und Tribute-Kampagnen. Benutzerdefinierte Felder erscheinen in den Datensätzen und sind als E-Mail-Tags verfügbar.

Einstellungen werden in der Option charitable_tributes_settings gespeichert; benutzerdefinierte Felddefinitionen in charitable_tributes_custom_fields.

Tributes Integrationen mit anderen Add-ons

Tributes erkennt jedes zugehörige Add-on und fügt ein Tribute-bewusstes Verhalten hinzu. Wenn ein Add-on nicht installiert ist, tut diese Integration einfach nichts. Jede kann unter Einstellungen > Integrationen ausgeschaltet werden.

AddonWas Tributes hinzufügtEinstellung
Wiederkehrende SpendenDie jährliche Tribute-Opt-in-Funktion, die eine einmalige Spende in eine wiederkehrende Spende umwandelt, wobei die Tribute-Details bei jeder Verlängerung erhalten bleiben.wiederkehrendes Upselling
Spenderwand(Core)Ein Tag „In Gedenken an [Geehrte Person]“, der dem Namen des Spenders auf der Hauptspenderwand Ihrer Website angehängt wird.Spenderwand-Tribut-Tag
DonorTrustUnterdrückt DonorTrust-Abzeichen auf Ehrungsseiten, die ihre eigene Spenderzuordnung haben.donortrust_unterdrücken
PDF-BelegeEin formatierter Ehrungsabschnitt in der generierten PDF-Quittung. Benötigt PDF Receipts 1.1.3+.PDF-Beleg-Tribut-Abschnitt
AutomatisierungsverbindungRegistriert Ehrungsveranstaltungen (Spende abgeschlossen, Kampagne erstellt, Geehrte Person erstellt) für Webhooks und Automatisierungen.Automatisierungs-Verbindungsereignisse

Datenschutz und Barrierefreiheit

  • DSGVO – Ehrungen nehmen an den Werkzeugen von WordPress zum Exportieren und Löschen personenbezogener Daten teil, sodass eine Datenanfrage Ehrungs- und Geehrteninformationen enthält, die mit der Person verknüpft sind.
  • Einwilligung – Benachrichtigungen an die Familie werden nur gesendet, wenn der Spender die Einwilligung bestätigt, und Familien-Digests erfordern eine ausdrückliche Zustimmung.
  • Barrierefreiheit – die für Spender sichtbaren Oberflächen sind nach WCAG 2.1 AA aufgebaut.

Entwicklerreferenz für Ehrungen

Aktionen

AktionWird ausgelöst, wenn
Wohltätigkeits-Tribute-InitialisierungDer Addon-Container ist bereit. Der sicherste Ort, um Erweiterungen zu registrieren.
Wohltätigkeits-Tribute-Kampagne erstelltEine Ehrungskampagne wird erstellt.
Wohltätigkeits-Tribute-Spende verknüpftEine Spende wird mit einer geehrten Person verknüpft (Back-Compat-Ereignis).
Wohltätigkeits-Tribute-Spende abgeschlossenEine Ehrungsspende wird abgeschlossen (kanonisches Ereignis, breiter Payload).
Wohltätigkeits-Tribute-Spende zurückerstattetEine Ehrungsspende wird zurückerstattet.
Wohltätigkeits-Tribute-Geehrte Person erstelltEin Datensatz für eine geehrte Person wird erstellt.
Wohltätigkeits-Tribute-Geehrte Person zusammengeführtZwei geehrte Personen werden zusammengeführt.
Wohltätigkeits-Tribute-Jahreserinnerung gesendetEine jährliche Spenden-Erinnerung wird gesendet.
Wohltätigkeits-Tribute-Familien-Digest gesendetEine Familien-Digest-E-Mail wird gesendet.
Wohltätigkeits-Tribute-Benachrichtigung konnte nicht gesendet werdenEine Benachrichtigung oder E-Card wird gesendet (Payload: Spenden-ID + Throwable).

Die charitable_tributes_donation_completed Payload:

add_action( 'charitable_tributes_donation_completed', function ( $donation_id, $data ) {
    // $data: donation_id, honoree_id, campaign_id, amount, currency,
    //        tribute_type, donor_id, donor_display
}, 10, 2 );

Filter

FilterStandardZweck
Wohltätigkeits-Tribute-Admin-RegisterkartenArrayÄndere die Admin-Seiten-Tabliste.
Wohltätigkeits-Tribute-Admin-UnterregisterkartenArrayÄndere die Unter-Tabs der Einstellungen.
Wohltätigkeits-Tribute-VorlagenArrayRegistriere benutzerdefinierte Ehrungsvorlagen.
Wohltätigkeits-Tribute-URL-BasisTributÄndere den Rewrite-Slug für Ehrungs- und Geehrten-URLs.
Wohltätigkeits-Tribute-Optionen für den TypArrayFiltere die verfügbaren Ehrungstypen, optional pro Kampagne.
Wohltätigkeits-Tribute-Nachrichten-Maximallänge500Zeichenlimit für Spenderbotschaften.
Wohltätigkeits-Tribute-Spenderkommentar ausblendenfalseVerstecke das Feld für Spenderbotschaften.
Wohltätigkeits-Tribute-Fallback für den Kontext der geehrten PersonKontextStelle den Kontext des Geehrten für Blöcke ohne expliziten Geehrten bereit.
Wohltätigkeits-Tribute-Maximale Gültigkeitsdauer des Abmelde-Tokens30 TageLebensdauer von Abmelde-Tokens.
charitable_tributes_receipt_email_enabledwahrZeige den Ehrungsabschnitt in Empfangsbestätigungs-E-Mails an.
Wohltätigkeits-Tribute-Beleg-E-Mail: Foto anzeigenwahrFüge das Foto des Geehrten in die Empfangsbestätigung ein.
Wohltätigkeits-Tribute-Beleg-E-Mail: Nachricht anzeigenwahrFüge die Spenderbotschaft in die Empfangsbestätigung ein.
Wohltätigkeits-Tribute-Beleg-E-Mail: E-Card anzeigenwahrE-Card-Stil auf der Quittung widerspiegeln.
Wohltätigkeits-Tribute-Beleg-E-Mail: Link zum Tribut anzeigenwahrLink zur Tributseite von der Quittung.
charitable_send_tribute_notificationwahrStandardbenachrichtigung pro Spende steuern.
charitable_send_tribute_ecardwahrE-Card pro Spende steuern.

AJAX-Endpunkte

Alle sind wp_ajax_ nur (kein öffentlicher Zugriff), erfordern einen Nonce und prüfen die manage_charitable_settings Berechtigung.

AktionZweck
charitable_tributes_wizard_openWizard-Sitzung initialisieren.
charitable_tributes_wizard_stepEinen Wizard-Schritt rendern und bearbeiten.
charitable_tributes_wizard_set_campaign_statusDie neue Kampagne veröffentlichen oder als Entwurf speichern.
charitable_tributes_wizard_discardDie Wizard-Sitzung verwerfen.
charitable_tributes_save_honoree_notesAdmin-Notizen zu einem Geehrten speichern.
charitable_tributes_save_custom_fieldsBenutzerdefinierte Felddefinitionen speichern.
charitable_tributes_add_family_contactEinen Familienkontakt hinzufügen.
charitable_tributes_update_family_contactEinen Familienkontakt aktualisieren.
charitable_tributes_delete_family_contactEinen Familienkontakt löschen.
charitable_tributes_honoree_mergeZwei Geehrte zusammenführen.
charitable_tributes_honoree_searchGeehrte nach Namen suchen.
charitable_tributes_dismiss_bannerBegrüßungsbanner ausblenden.
charitable_tributes_ecard_test_actionTest-E-Card senden.

REST-API

Schreibgeschützte Endpunkte zum Synchronisieren von Ehrungsdaten in ein externes CRM oder eine Reporting-Umgebung.

Ehrungs-Kampagnen – GET /wp-json/wp/v2/tribute_campaigns

Query-ParameterBeispielFiltert nach
tribute_typein-memory-ofArt der Ehrung.
Vorlagein-loving-memoryVerwendete Vorlage.
Gefeierter123ID des Geehrten.
date_from / date_to2026-01-01Datumsbereich.

Jede Antwort enthält ein tribute_meta Objekt mit honoree_id, template_id, total_raised, und donor_count.

Geehrte – GET /wp-json/wp/v2/charitable-honorees

Query-ParameterBeispielFiltert nach
Vorlagein-loving-memoryVerknüpfte Ehrungsvorlage.
has_donations1 oder 0Nur Geehrte mit oder ohne Spenden.

Jede Antwort enthält ein tribute_meta Objekt mit total_raised, donor_count, gift_count, last_donation_at, und linked_campaigns_count.

Datenbankschema

TabelleZweck
wp_charitable_honoree_donationsEine denormalisierte Zeile pro Spende, verknüpft mit einem Geehrten.
wp_charitable_honoree_family_contactsFamilienkontakt-Datensätze.
wp_charitable_honoree_totals_cacheZwischengespeicherte Summen pro Geehrtem.

Verwenden Sie die Repositories, anstatt direkt abzufragen:

use Charitable\Pro\Tributes\Repositories\Repositories;

Repositories::honorees();
Repositories::honoree_donations();
Repositories::honoree_family_contacts();
Repositories::honoree_totals_cache();

Vorlagen

Überschreiben Sie eine dieser Vorlagen, indem Sie sie in Ihr Theme kopieren und die Konventionen des Charitable-Template-Loaders befolgen:

  • templates/single-tribute_campaign.php
  • templates/emails/tribute-notification.php (und -plain.php)
  • templates/emails/tribute-ecard.php
  • templates/emails/family-digest.php (und -plain.php)
  • blocks/<block>/render.php für jeden der sechs Blöcke.

Automation Connect-Ereignisse

Wenn Automation Connect aktiv ist, registriert Tributes seine Ereignisse über den charitable_automation_connect_events -Filter und stellt Ereignisse wie „Spende für eine Ehrung abgeschlossen“, „Kampagne für eine Ehrung erstellt“ und „Neuer Geehrter“ für No-Code-Automatisierungen bereit.

Verwandt

Hilfreiche Links

🤝 Holen Sie sich Hilfe, wenn Sie sie brauchen

Support kontaktieren →

📑 Finden Sie die Anleitung, die Sie benötigen

Durchsuchen Sie den Dokumentations-Hub →

⬇️ Laden Sie bewährte Strategien, Kampagnenideen und Experten-Tools herunter

Das Fundraising-Kit herunterladen →

🔗 Lassen Sie Ihren KI-Assistenten die Fundraising-Arbeit für Sie erledigen.

Verbinden Sie Charitable mit Ihrem KI-Assistenten →

💸 Holen Sie sich kostenlose Fundraising-Ressourcen
Besuchen Sie den Charitable Fundraising Hub →

🤔 Haben Sie Fragen zu Charitable?
Charitable FAQs →

Benötigen Sie Hilfe beim Verständnis von Begriffen und Fachjargon für gemeinnützige Organisationen?
Siehe unser Glossar für gemeinnützige Organisationen→

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!

Spenden Verbesserung

📊 Ihr Pro Dashboard kann jetzt vergleichen, exportieren und bewerten!

Die meisten Fundraising-Dashboards zeigen Ihnen nur, wie viel Sie eingenommen haben. Charitable Pro 1.8.19 baut das Dashboard und die Berichtsübersicht um die schwierigeren Fragen herum neu auf: ob etwas kaputt ist, ob diese Periode die letzte geschlagen hat und welche einzelne Änderung heute den größten Unterschied machen würde. Warum das wichtig ist:

  • 📈 Jede Zahl hat einen Trend: Wählen Sie eine Periode aus und die Kacheln und das Diagramm bewegen sich zusammen, wobei jede Summe im Vergleich zur Vorperiode angezeigt wird.
  • 🗓️ Lesbare Diagramme: Kurze Zeiträume gruppieren Spenden tageweise, während längere Zeiträume nach Woche oder Monat gruppieren, sodass ein volles Jahr als Kurve und nicht als flache Linie gelesen wird.
  • 🔀 Vergleichen Sie beliebige 2 Perioden: Nicht nur aufeinanderfolgende, sodass Sie fragen können, wie dieser Dezember im Vergleich zum letzten Dezember abgeschnitten hat. Das ist wichtig, da Fundraising saisonabhängig ist.
  • 📤 Fassen Sie die gesamte Zusammenfassung zusammen: Senden Sie die vollständige Übersicht als CSV oder PDF, bereit für ein Board-Paket oder einen Spenderbericht.
  • 🎯 Bewerten Sie Ihr Setup kostenlos: Lassen Sie Ihr Fundraising-Setup bewerten, damit die eine Änderung, die sich als Nächstes lohnt, diejenige ist, die Sie sehen können.

Lesen Sie hier unsere Ankündigung.

Funktion Neu

🎟️ Wir stellen vor: Charitable Events: Verkaufen Sie Tickets für Ihre Kampagnen!

Die meisten gemeinnützigen Organisationen verkaufen Event-Tickets in einem Tool und sammeln Spenden in einem anderen, was zu zwei Berichtsdatensätzen und einer manuellen Abgleichung am Jahresende führt. Charitable Events vereint beides, indem es Tickets über dieselben Spendenformulare und Zahlungs-Gateways verkauft, die Sie bereits in Charitable nutzen. Warum das wichtig ist:

  • 🎟️ Jedes Ticket ist eine Spende: Ticketverkäufe laufen über das Gateway, das Sie bereits nutzen, und zählen zum Kampagnenziel, wobei alles unter Charitable » Events verwaltet wird.
  • 📱 QR-Check-in von jedem Telefon: Jeder Teilnehmer erhält seinen eigenen QR-Code auf der Quittung, und Freiwillige scannen ihn am Eingang über einen Check-in-Link, der kein WordPress-Konto benötigt.
  • 🧾 Quittungen bereit für die Steuererklärung: Weisen Sie jedem Ticket-Typ einen fairen Marktwert zu, und Charitable gibt den korrekten steuerlich absetzbaren Betrag auf jeder Spenderquittung an.
  • 📋 Teilnehmerdetails beim Checkout: Fragen Sie jeden Gast nach einer Essenswahl, Hemdgröße oder speziellen Bedürfnissen, wobei für jedes Ticket ein separater Teilnehmerdatensatz erstellt wird.
  • 🗓️ Blöcke und Kalender inklusive: Drei Editor-Blöcke sowie die Unterstützung für Sugar Calendar und The Events Calendar platzieren Ihre Events dort, wo Unterstützer bereits nachsehen.

Lesen Sie hier unsere Ankündigung.

KI Neu

🚀 Entfesseln Sie die KI-Power in Charitable!

Ihr KI-Assistent kann jetzt Ihre Charitable-Spendenkampagnen direkt erstellen, bearbeiten und verwalten – einfach durch Fragen. Mit Charitable Pro, das Schreibunterstützung für die WordPress Abilities API hinzufügt, können Tools wie ChatGPT, Claude und Cursor sicher vollständige administrative Aktionen über MCP durchführen. Warum das wichtig ist:

  • 🤖 Kampagnenerstellung in einfacher Sprache: Fordern Sie Ihren Assistenten mit einem Ziel wie „Richten Sie eine Spendenaktion für das Tierheim mit einem Ziel von 5.000 US-Dollar ein“ auf, und er erstellt einen echten Kampagnenentwurf mit vorgeschlagenen Spendenstufen.
  • 🎨 Sofortige Anpassungen des Spendenformulars: Fügen Sie benutzerdefinierte Felder hinzu, ändern Sie Schaltflächenfarben oder ordnen Sie Elemente neu an, ohne sich mit den Formulareinstellungen befassen zu müssen.
  • 📝 Protokollierung von Offline-Geschenken: Informieren Sie Ihren Assistenten über Bargeld- oder Scheckgeschenke, und er gleicht E-Mail-Adressen von Spendern ab und zeichnet Transaktionen in Ihrer Historie auf.
  • 🛡️ Sicherheit und Kontrolle standardmäßig: Schreibzugriff bleibt streng deaktiviert, bis er unter Charitable » Tools » AI MCP aktiviert wird, wodurch schreibgeschützte Berichte standardmäßig sicher bleiben.
  • 📜 Vollständige Audit-Protokollierung: Jede Änderung, die von einem KI-Assistenten vorgenommen wird, wird unter Charitable » Tools » Logs verfolgt, sodass Sie immer wissen, wer (oder was) Ihre Website aktualisiert hat.

Lesen Sie hier unsere Ankündigung.

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.