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, sodass Sie jede davon ausschalten können. Sehen Sie sich den Abschnitt Integrationen unten an, um zu erfahren, was jede einzelne tut.

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.	recurring_upsell
Spenderwand(Core)	Ein Tag „In Gedenken an [Geehrte Person]“, der dem Namen des Spenders auf der Hauptspenderwand Ihrer Website angehängt wird.	donor_wall_tribute_tag
DonorTrust	Unterdrückt DonorTrust-Abzeichen auf Ehrungsseiten, die ihre eigene Spenderzuordnung haben.	donortrust_suppress
PDF-Belege	Ein formatierter Ehrungsabschnitt in der generierten PDF-Quittung. Benötigt PDF Receipts 1.1.3+.	pdf_receipts_tribute_section
Automatisierungsverbindung	Registriert Ehrungsveranstaltungen (Spende abgeschlossen, Kampagne erstellt, Geehrte Person erstellt) für Webhooks und Automatisierungen.	automation_connect_events

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
charitable_tributes_init	Der Addon-Container ist bereit. Der sicherste Ort, um Erweiterungen zu registrieren.
charitable_tributes_campaign_created	Eine Ehrungskampagne wird erstellt.
charitable_tributes_donation_linked	Eine Spende wird mit einer geehrten Person verknüpft (Back-Compat-Ereignis).
charitable_tributes_donation_completed	Eine Ehrungsspende wird abgeschlossen (kanonisches Ereignis, breiter Payload).
charitable_tributes_donation_refunded	Eine Ehrungsspende wird zurückerstattet.
charitable_tributes_honoree_created	Ein Datensatz für eine geehrte Person wird erstellt.
charitable_tributes_honoree_merged	Zwei geehrte Personen werden zusammengeführt.
charitable_tributes_annual_reminder_sent	Eine jährliche Spenden-Erinnerung wird gesendet.
charitable_tributes_family_digest_sent	Eine Familien-Digest-E-Mail wird gesendet.
charitable_tributes_notification_send_failed	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
charitable_tributes_admin_tabs	Array	Ändere die Admin-Seiten-Tabliste.
charitable_tributes_admin_sub_tabs	Array	Ändere die Unter-Tabs der Einstellungen.
charitable_tributes_templates	Array	Registriere benutzerdefinierte Ehrungsvorlagen.
charitable_tributes_url_base	tribute	Ändere den Rewrite-Slug für Ehrungs- und Geehrten-URLs.
charitable_tributes_type_options	Array	Filtere die verfügbaren Ehrungstypen, optional pro Kampagne.
charitable_tributes_message_max_length	500	Zeichenlimit für Spenderbotschaften.
charitable_tributes_hide_donor_comment	false	Verstecke das Feld für Spenderbotschaften.
charitable_tributes_honoree_context_fallback	context	Stelle den Kontext des Geehrten für Blöcke ohne expliziten Geehrten bereit.
charitable_tributes_unsubscribe_token_max_age	30 Tage	Lebensdauer von Abmelde-Tokens.
charitable_tributes_receipt_email_enabled	wahr	Zeige den Ehrungsabschnitt in Empfangsbestätigungs-E-Mails an.
charitable_tributes_receipt_email_show_photo	wahr	Füge das Foto des Geehrten in die Empfangsbestätigung ein.
charitable_tributes_receipt_email_show_message	wahr	Füge die Spenderbotschaft in die Empfangsbestätigung ein.
charitable_tributes_receipt_email_show_ecard	wahr	E-Card-Stil auf der Quittung widerspiegeln.
charitable_tributes_receipt_email_show_tribute_link	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.
template	in-loving-memory	Verwendete Vorlage.
honoree	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
template	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.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

• Leitfaden für karitative Ehrungen
• Erstellen von Ehrungskampagnen
• Ehrungsdatensätze und das CRM
• Tribute-E-Mails, E-Cards und Belege