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.
| Addon | Was Tributes hinzufügt | Einstellung |
|---|---|---|
| Wiederkehrende Spenden | Die 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 |
| DonorTrust | Unterdrückt DonorTrust-Abzeichen auf Ehrungsseiten, die ihre eigene Spenderzuordnung haben. | donortrust_unterdrücken |
| PDF-Belege | Ein formatierter Ehrungsabschnitt in der generierten PDF-Quittung. Benötigt PDF Receipts 1.1.3+. | PDF-Beleg-Tribut-Abschnitt |
| Automatisierungsverbindung | Registriert 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
| Aktion | Wird ausgelöst, wenn |
|---|---|
Wohltätigkeits-Tribute-Initialisierung | Der Addon-Container ist bereit. Der sicherste Ort, um Erweiterungen zu registrieren. |
Wohltätigkeits-Tribute-Kampagne erstellt | Eine Ehrungskampagne wird erstellt. |
Wohltätigkeits-Tribute-Spende verknüpft | Eine Spende wird mit einer geehrten Person verknüpft (Back-Compat-Ereignis). |
Wohltätigkeits-Tribute-Spende abgeschlossen | Eine Ehrungsspende wird abgeschlossen (kanonisches Ereignis, breiter Payload). |
Wohltätigkeits-Tribute-Spende zurückerstattet | Eine Ehrungsspende wird zurückerstattet. |
Wohltätigkeits-Tribute-Geehrte Person erstellt | Ein Datensatz für eine geehrte Person wird erstellt. |
Wohltätigkeits-Tribute-Geehrte Person zusammengeführt | Zwei geehrte Personen werden zusammengeführt. |
Wohltätigkeits-Tribute-Jahreserinnerung gesendet | Eine jährliche Spenden-Erinnerung wird gesendet. |
Wohltätigkeits-Tribute-Familien-Digest gesendet | Eine Familien-Digest-E-Mail wird gesendet. |
Wohltätigkeits-Tribute-Benachrichtigung konnte nicht gesendet werden | Eine 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
| Filter | Standard | Zweck |
|---|---|---|
Wohltätigkeits-Tribute-Admin-Registerkarten | Array | Ändere die Admin-Seiten-Tabliste. |
Wohltätigkeits-Tribute-Admin-Unterregisterkarten | Array | Ändere die Unter-Tabs der Einstellungen. |
Wohltätigkeits-Tribute-Vorlagen | Array | Registriere benutzerdefinierte Ehrungsvorlagen. |
Wohltätigkeits-Tribute-URL-Basis | Tribut | Ändere den Rewrite-Slug für Ehrungs- und Geehrten-URLs. |
Wohltätigkeits-Tribute-Optionen für den Typ | Array | Filtere die verfügbaren Ehrungstypen, optional pro Kampagne. |
Wohltätigkeits-Tribute-Nachrichten-Maximallänge | 500 | Zeichenlimit für Spenderbotschaften. |
Wohltätigkeits-Tribute-Spenderkommentar ausblenden | false | Verstecke das Feld für Spenderbotschaften. |
Wohltätigkeits-Tribute-Fallback für den Kontext der geehrten Person | Kontext | Stelle den Kontext des Geehrten für Blöcke ohne expliziten Geehrten bereit. |
Wohltätigkeits-Tribute-Maximale Gültigkeitsdauer des Abmelde-Tokens | 30 Tage | Lebensdauer von Abmelde-Tokens. |
charitable_tributes_receipt_email_enabled | wahr | Zeige den Ehrungsabschnitt in Empfangsbestätigungs-E-Mails an. |
Wohltätigkeits-Tribute-Beleg-E-Mail: Foto anzeigen | wahr | Füge das Foto des Geehrten in die Empfangsbestätigung ein. |
Wohltätigkeits-Tribute-Beleg-E-Mail: Nachricht anzeigen | wahr | Füge die Spenderbotschaft in die Empfangsbestätigung ein. |
Wohltätigkeits-Tribute-Beleg-E-Mail: E-Card anzeigen | wahr | E-Card-Stil auf der Quittung widerspiegeln. |
Wohltätigkeits-Tribute-Beleg-E-Mail: Link zum Tribut anzeigen | wahr | Link zur Tributseite von der Quittung. |
charitable_send_tribute_notification | wahr | Standardbenachrichtigung pro Spende steuern. |
charitable_send_tribute_ecard | wahr | E-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.
| Aktion | Zweck |
|---|---|
charitable_tributes_wizard_open | Wizard-Sitzung initialisieren. |
charitable_tributes_wizard_step | Einen Wizard-Schritt rendern und bearbeiten. |
charitable_tributes_wizard_set_campaign_status | Die neue Kampagne veröffentlichen oder als Entwurf speichern. |
charitable_tributes_wizard_discard | Die Wizard-Sitzung verwerfen. |
charitable_tributes_save_honoree_notes | Admin-Notizen zu einem Geehrten speichern. |
charitable_tributes_save_custom_fields | Benutzerdefinierte Felddefinitionen speichern. |
charitable_tributes_add_family_contact | Einen Familienkontakt hinzufügen. |
charitable_tributes_update_family_contact | Einen Familienkontakt aktualisieren. |
charitable_tributes_delete_family_contact | Einen Familienkontakt löschen. |
charitable_tributes_honoree_merge | Zwei Geehrte zusammenführen. |
charitable_tributes_honoree_search | Geehrte nach Namen suchen. |
charitable_tributes_dismiss_banner | Begrüßungsbanner ausblenden. |
charitable_tributes_ecard_test_action | Test-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-Parameter | Beispiel | Filtert nach |
|---|---|---|
tribute_type | in-memory-of | Art der Ehrung. |
Vorlage | in-loving-memory | Verwendete Vorlage. |
Gefeierter | 123 | ID des Geehrten. |
date_from / date_to | 2026-01-01 | Datumsbereich. |
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-Parameter | Beispiel | Filtert nach |
|---|---|---|
Vorlage | in-loving-memory | Verknüpfte Ehrungsvorlage. |
has_donations | 1 oder 0 | Nur 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
| Tabelle | Zweck |
|---|---|
wp_charitable_honoree_donations | Eine denormalisierte Zeile pro Spende, verknüpft mit einem Geehrten. |
wp_charitable_honoree_family_contacts | Familienkontakt-Datensätze. |
wp_charitable_honoree_totals_cache | Zwischengespeicherte 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.phptemplates/emails/tribute-notification.php(und-plain.php)templates/emails/tribute-ecard.phptemplates/emails/family-digest.php(und-plain.php)blocks/<block>/render.phpfü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
- Das Tribut-Spenden-Erlebnis: Was Spender sehen
- So erstellen Sie eine Ehrungskampagne in Charitable
- Ehrungsseiten und -blöcke
- Charitable Tributes E-Mails, E-Cards und Quittungen
- Ehrungsdatensätze und das CRM
- Leitfaden für karitative Ehrungen
Hilfreiche Links
🤝 Holen Sie sich Hilfe, wenn Sie sie brauchen
📑 Finden Sie die Anleitung, die Sie benötigen
Durchsuchen Sie den Dokumentations-Hub →
⬇️ Laden Sie bewährte Strategien, Kampagnenideen und Experten-Tools herunter
Holen Sie sich das Fundraising-Kit →
💸 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→
