Charitable Ambassadors 3.0 ist nicht nur ein Update. Es ist eine Neuerfindung. Dies ist die größte Veröffentlichung, die das Add-on je gesehen hat, mit einem von Grund auf neu gestalteten Admin-Erlebnis und acht leistungsstarken neuen Funktionen, die auf jahrelanger realer Kundenrückmeldung basieren.

Betrachten Sie diese Seite als Ihre Schnelleinführung. Jede Funktion enthält einen direkten Link zur Dokumentation, sodass Sie so tief eintauchen können, wie Sie möchten, wann immer Sie bereit sind.

Upgrade von 2.x? Überspringen Sie nicht den Leitfaden zur Migration von 2.x auf 3.0. Er ist Ihr unverzichtbarer Begleiter für einen reibungslosen Übergang.

Hinweis: Ambassadors 3.0 erfordert Charitable Pro 1.8.16+

Die Änderungen im Gesamtbild

Ambassadors 3.0 berührt fast jede Ecke des Add-ons. Hier ist eine kurze Zusammenfassung dessen, was sich geändert hat und warum es wichtig ist:

Admin & Navigation

Änderung	Warum es wichtig ist
Admin aus Einstellungen verschoben	Ambassadors ist jetzt ein eigenes Hauptmenü (Charitable » Ambassadors), schneller erreichbar, einfacher zu navigieren.
Übersichts-Dashboard	Ein zentraler Knotenpunkt für den Programmstatus auf einen Blick, komplett mit KPI-Kacheln, einem Hauptdiagramm und Highlights der Top-Performer.
Einrichtungsassistent	Drei Wege zum Einstieg (Assistent, Vorlagen oder Schnelleinstieg), damit neue Installationen in wenigen Minuten einsatzbereit sind.

Fundraiser-Verwaltung

Änderung	Warum es wichtig ist
Moderationswarteschlange	Ein dedizierter Workflow zur Überprüfung von Fundraiser-Einreichungen: genehmigen, ablehnen oder Änderungen anfordern, mit einem 30-Sekunden-Rückgängig-Sicherheitsnetz.
Verzeichnis	Eine durchsuchbare Liste aller Botschafter, komplett mit Profilseiten, Verifizierung, E-Mail-Versand, Ansicht als und CSV-Export.
Einladungen	Ein optionales persönliches Einladungslink-Rekrutierungssystem mit Zuordnungsverfolgung, einem Landingpage-Shortcode und einem Rekrutierungs-Widget im Übersichts-Dashboard.

Design & Anzeige

Änderung	Warum es wichtig ist
8 Layout-Varianten + benutzerdefinierter Slot	Fundraiser-Seiten können in acht integrierten Layouts gerendert werden; Theme-Overrides werden als dedizierter benutzerdefinierter Slot angezeigt.
Visueller Vorlagenmodus	Gestalten Sie eine Kampagne im visuellen Editor und alle Fundraiser übernehmen sie automatisch.
Widget einbetten	Ein kleiner HTML-Schnipsel, den Botschafter auf jeder externen Website einfügen können, um den Fortschritt ihrer Spendenaktion und eine Spenden-Schaltfläche anzuzeigen.

Benachrichtigungen & Kommunikation

Änderung	Warum es wichtig ist
Lokale Benachrichtigungen	Vier Benachrichtigungen mit Glockensymbol werden zu wichtigen Zeitpunkten ausgelöst: Status der Moderationswarteschlange, erste Spendenaktion pro Elternteil, erreichtes Ziel und Meilensteine bei erreichten Gesamtbeträgen.
E-Mail-Status-Banner	Fängt den Fall ab, dass eine Transaktions-E-Mail, die aktiviert sein sollte, versehentlich deaktiviert wurde.
Freigabe-Netzwerk-Chip-Raster	10 Freigabe-Netzwerke, die mit einem einzigen Klick ein- oder ausgeschaltet werden können.

Daten & Dienstprogramme

Änderung	Warum es wichtig ist
CSV-Exporte überall	Formelinjektionssichere CSV-Exporte verfügbar auf Übersichts-, Moderations-, Verzeichnis-, Einladungs- und einzelnen Profilseiten.
QR-Codes pro Oberfläche	Die QR-Code-Generierung ist jetzt in Oberflächen-spezifische Schalter unterteilt: Spendenaktionsseite, Freigabe-Popover und Zeile „Meine Kampagnen“.

Wo jede neue Funktion lebt

📊 Übersichts-Dashboard

Charitable » Botschafter » Übersicht

Das Kommandozentrum Ihres Programms. Das Übersichts-Dashboard bringt alles Wichtige an einen Ort: KPI-Kacheln, ein Hauptdiagramm zur Verfolgung von Spenden im Zeitverlauf, Top-Spendenwerber, Botschafter und Eltern, ein Rekrutierungs-Widget, den Feed der letzten Spenden, eine Willkommensmitteilung und eine Kachel für ausstehende Genehmigungen. Wenn Sie jemals Berichte durchsuchen mussten, nur um eine grundlegende Frage zur Gesundheit Ihres Programms zu beantworten, wurde dieser Bildschirm für Sie erstellt.

Mehr über Übersicht lesen

✅ Moderation

Charitable » Botschafter » Moderation

Ein dedizierter Workflow, der darauf ausgelegt ist, Ihr Programm sauber und in Bewegung zu halten. Vier Ansichten (Ausstehend / Aktion erforderlich / Abgelehnt / Genehmigt) ermöglichen eine schnelle Triage. Inline- und Massenaktionen halten die Dinge schnell, eine 30-sekündige Rückgängig-Funktion bewahrt Sie vor kostspieligen Fehlern, und ein nur-anhängendes Audit-Protokoll pro Spendenaktion führt eine vollständige Papierspur. Führt den neuen Beitragsstatus charitable-rejected ein.

Mehr über Moderation lesen | Detaillierte Ansicht der Moderationsaktionen

📋 Verzeichnis

Charitable » Botschafter » Verzeichnis

Eine durchsuchbare, filterbare Liste aller Botschafter in Ihrem Programm. Vier Unteransichten (Alle / Verifiziert / Nicht verifiziert / Inaktiv) erleichtern das Auffinden genau der Person, die Sie suchen. Jeder Botschafter hat eine eigene Profilseite mit vier Registerkarten sowie Aktionen zum Verifizieren/Aufheben der Verifizierung, Senden einer E-Mail, Anzeigen als, Hinzufügen eines Botschafters und zum Massenlöschen und Anonymisieren. Wenn Sie mit dem Spenderbereich in Charitable vertraut sind, werden Sie sich hier sofort wohlfühlen.

Mehr über Verzeichnis lesen | Detaillierte Ansicht der Profilregisterkarten

💌 Einladungen

Charitable » Botschafter » Einladungen

Ein persönliches Einladungslink-System, bei dem man sich anmelden muss und das Ihre besten Botschafter zu Rekrutierern macht. Jede Person erhält ihren eigenen eindeutigen Link zum Teilen, und jeder, der sich darüber anmeldet, wird ihr zugeordnet. Verwalten Sie alles von einem Ort aus: wer rekrutieren kann, die Zielseite, das Fallback-Bild und mehr. Selbstprüfungsbanner kennzeichnen Konfigurationsprobleme, bevor sie zu Problemen werden, und eine saubere Deinstallationsoption ermöglicht es Ihnen, die Funktion bei Bedarf vollständig zu entfernen.

Mehr über Einladungen erfahren | So funktioniert die Zuordnung | Speicher / benutzerdefinierte Tabelle | Shortcode für Landingpage | Anpassung der Rekrutierungskarte

🧙 Einrichtungsassistent

Charitable » Botschafter » Allgemein » Einrichtungsaktionen » Einrichtung öffnen

Drei Wege, um Ihr Programm zum Laufen zu bringen, so schnell wie Sie es brauchen. Folgen Sie dem vollständigen geführten Assistenten über 10 Schritte, wählen Sie eine von sechs vordefinierten Szenariovorlagen (Marathon, Gedenken, Gala, Schule, Geburtstag, Benutzerdefiniert) oder wählen Sie „Schnellstart“ für sinnvolle Standardeinstellungen mit einem Klick. Welchen Weg Sie auch wählen, der Assistent erstellt automatisch Ihre Seiten „Kampagne einreichen“ und „Meine Kampagnen“ und optional eine Startkampagne, damit Sie sofort etwas zum Arbeiten haben.

Mehr über den Einrichtungsassistenten erfahren

🎨 Vorlagen, Visueller Vorlagenmodus & 8 Layoutvarianten

Charitable » Botschafter » Vorlagen

Dies ist das Krönungsmerkmal der Version 3.0. Eine neu gestaltete Registerkarte „Vorlagen“ gibt Ihnen die volle Kontrolle darüber, wie die Spendenkampagnenseiten auf Ihrer gesamten Website aussehen und sich anfühlen. Wählen Sie Ihren Frontend-Vorlagenstil (Legacy, Erweitert oder Visuell), wählen Sie aus acht Layoutvarianten im Erweiterten Modus, verwenden Sie die Autovervollständigung für Vorlagen und Kampagnen im Visuellen Modus, um ein bereits erstelltes Design zu klonen, und optimieren Sie Ihre primäre Akzentfarbe und den Kartenstil. Jede Spendenkampagnenseite übernimmt automatisch Ihre Auswahl, ohne dass benutzerdefinierte CSS erforderlich sind.

Vorlagenorientierung | Layoutvarianten im Detail | Visueller Vorlagenmodus | Theming

🗂️ Meine Kampagnen

Charitable » Botschafter » Meine Kampagnen

Einstellungen für die Besucherseite /my-campaigns/, komplett mit einer Live-Vorschau, damit Sie Änderungen in Echtzeit sehen können. Schalten Sie Suche, Sortierung, Miniaturansicht, Fortschrittsbalken, Teilen und QR ein oder aus. Legen Sie eine Standard-Sortierreihenfolge fest. Hier befinden sich auch die Einstellungen für den Spendenbericht des Kampagnenerstellers, die es Botschaftern ermöglichen, ihre eigenen Spenderdaten zu exportieren, wenn Sie dies zulassen.

Mehr über Meine Kampagnen erfahren

📄 Spendenkampagnenseite

Charitable » Botschafter » Spendenkampagnenseite

Feingranulare Kontrolle über jede Spendenkampagnenseite auf Ihrer Website. Konfigurieren Sie Ihre Layoutvariante, Breadcrumb, Freigabe-Popover, Kommentare, QR-Codes pro Oberfläche, Position der Spenderwand, Fallback für das Hero-Bild und Clean Theme Chrome an einem Ort. Änderungen hier gelten global für jede Botschafter-Spendenkampagne, sodass Sie sie einmal festlegen und sie einfach funktioniert.

Mehr über Spendenkampagnenseite erfahren

🃏 Kampagne einreichen: Kartenraster Schritt 1

Frontend: /submit-campaign/

Der Schritt 1 des Einreichungsformulars erhält ein großes Upgrade. Die alte Dropdown-Auswahl wird durch eine intuitive Kartenraster-Empfängerauswahl (Einzelperson / Team / Teammitglied) ersetzt, die die Auswahl auf einen Blick offensichtlich macht. Der übergeordnete Auswähler von Schritt 2 wird jetzt per AJAX gesteuert, komplett mit Kampagnenlogos und Fortschrittsbalken. Sie können auch direkt zu einem bestimmten Empfängertyp oder einer übergeordneten Kampagne über die URL-Argumente cap_recipient und cap_campaign verlinken.

Mehr über Kampagne einreichen erfahren

🔗 Teilenetzwerke

Charitable » Botschafter » Teilen

Zehn Sharing-Netzwerke (Facebook, X, LinkedIn, E-Mail, Link kopieren, WhatsApp, Pinterest, Reddit, Bluesky und Threads), angezeigt als sauberes Chip-Raster zum Ein-/Ausschalten. Nur die von Ihnen aktivierten Netzwerke werden im Share-Popover jeder Spendenaktion angezeigt, wodurch die Erfahrung für Ihr Publikum sauber und relevant bleibt.

Mehr über Sharing-Netzwerke lesen

🧩 Widget einbetten

Charitable » Botschafter » Diverses » Widget einbetten

Standardmäßig deaktiviert. Aktivieren Sie es, um eine Kachel für das Widget zum Einbetten von Spendenaktionen hinzuzufügen. Jeder Botschafter erhält einen kleinen HTML-Schnipsel, den er auf jede externe Website einfügen kann: seinen persönlichen Blog, ein Firmenintranet, überall. Das Widget zeigt die Live-Fortschrittsleiste und den Spenden-Button seiner Spendenaktion an und zieht Daten direkt von Ihrer Website. Keine Anmeldung für Besucher erforderlich.

Mehr über Widget einbetten lesen

📱 QR-Codes

Charitable » Botschafter » Diverses » QR-Codes (Master-Schalter)
Charitable » Botschafter » Spendenaktionsseite » QR-Code auf Spendenaktionsseite anzeigen (pro Oberfläche)
Charitable » Botschafter » Meine Kampagnen » QR-Code anzeigen (pro Oberfläche)

Pro Spendenaktion generierte QR-Codes, clientseitig erstellt und als PNG herunterladbar. Der alte einzelne Master-Schalter wurde durch pro-Oberflächen-Schalter ersetzt, die Ihnen eine granulare Kontrolle darüber geben, wo QR-Codes erscheinen: auf der Spendenaktionsseite, im Share-Popover oder in der Zeile des Dashboards "Meine Kampagnen".

Mehr über QR-Codes lesen

🔔 Benachrichtigungen

Vier Ereignisse werden jetzt im Benachrichtigungsfeld mit Glocken-Symbol ausgelöst und decken die wichtigsten Momente für jeden ab, der ein Peer-to-Peer-Programm leitet:

• Gesundheit der Moderationswarteschlange: Behalten Sie die Kontrolle über ausstehende Einreichungen, bevor sie sich stapeln.
• Erste Spendenaktion pro Elternteil: Wissen Sie in dem Moment, in dem eine Kampagne ihre erste aktive Spendenaktion erhält.
• Ziel erreicht: Feiern Sie den Meilenstein automatisch.
• Gesammelte Beträge in Stufen: Erhalten Sie Benachrichtigungen bei 1.000 $, 5.000 $, 10.000 $, 25.000 $, 50.000 $, 100.000 $, 250.000 $, 500.000 $ und 1.000.000 $.

Filter zur Unterdrückung pro Ereignis ermöglichen es Ihnen, das Rauschen zu regulieren, und ein Master-Kill-Schalter schaltet alles ab, wenn nötig.

Mehr über Benachrichtigungen lesen

🏥 E-Mail-Gesundheitsbanner

Charitable » Botschafter » Übersicht (Banner mit orangefarbenem Rand)

Zehn Regeln laufen lautlos im Hintergrund und prüfen, ob Ihre kritischen Transaktions-E-Mails eingeschaltet sind, wenn sie es sein sollten. Wenn etwas falsch konfiguriert ist, zeigt das Banner dies mit einer Ein-Klick-Aktivierungsfunktion an, sodass Sie nie wieder in den Einstellungen nachsehen müssen, um herauszufinden, warum Botschafter keine E-Mails erhalten.

Mehr über E-Mail-Gesundheit lesen

📥 CSV-Exporte

Formel-injektionssichere CSV-Exporte sind jetzt allgemein verfügbar: Übersicht (sechs Abschnitte), Moderation, Verzeichnis (Listen- und Profil-Ebene) und Einladungen (aktuelle Aktivitäten und Top-Werber). Alle Exporte sind standardmäßig auf 10.000 Zeilen begrenzt und vollständig filterbar. Egal, ob Sie einen Bericht für ein Gremium erstellen oder in ein CRM importieren, die Daten sind einsatzbereit.

CSV-Spaltendiktionär

---

Tools und Diagnosen

Oberfläche	Neu in 3.0
Charitable Tools » Website-Infos » Botschafter-Block	Vollständiger Diagnostik-Dump: Versionen, Einstellungen, Status der benutzerdefinierten Tabellen, Vorlagenüberschreibungen, aktuelle Protokolleinträge.
Charitable Tools » Protokoll	Alle Botschafter-Events protokolliert mit source: ambassadors_*.

Mehr über Website-Infos erfahren

Entwickler-Oberfläche

Design	Änderung
Filter- und Aktions-Oberfläche	Über 300 Filter / über 40 Aktionen im Plugin. Die meisten benannt charitable_ambassadors_<feature>_*.
Design-Überschreibungen	Standardkette. Überschreiben Sie jede Vorlage unter your-theme/charitable-pro/charitable-ambassadors/<path>.php.
REST	Neuer Endpunkt für das Einbettungs-Widget unter /wp-json/charitable-ambassadors/v1/embed-widget/<id>. CORS-gesteuert.
Benutzerdefinierte Rollen	campaign_creator unverändert seit 2.x. Hauptberechtigung: manage_charitable_settings.
Benutzerdefinierte Tabellen	Eine neue Opt-in-Tabelle für Einladungen (<prefix>charitable_ambassadors_invite_tokens).
Benutzerdefinierter Beitragsstatus	charitable-rejected für von Moderatoren abgelehnte Spendenaktionen.

Referenz für Hooks & Filter

Was gleich bleibt

Wenn Sie sich Sorgen über Upgrade-Probleme machen:

• Alle Optionsschlüssel bleiben erhalten. Bestehende Anpassungen an Einstellungen bleiben weiterhin gültig.
• Alle Shortcodes bleiben erhalten. [charitable_submit_campaign], [charitable_my_campaigns], usw.
• Alle Filter-/Aktionsnamen bleiben erhalten. Einige wurden hinzugefügt, keine umbenannt.
• Alle Kampagnen-URLs bleiben erhalten. Die Permalinks Ihrer bestehenden Spendenaktionen ändern sich nicht.
• Alle Spenden bleiben erhalten. Die Aufrollung zu übergeordneten Elementen funktioniert weiterhin gleich.

Siehe Migration von 2.x auf 3.0 für die vollständige IA-Zuordnung.

Upgrade-Checkliste

Nach dem Upgrade empfehlen wir Ihnen, folgende Aufgaben abzuschließen:

1. Gehen Sie zur Übersicht: Besuchen Sie zuerst Charitable » Ambassadors. Sie sollten direkt auf dem Übersichts-Bildschirm landen und bestätigen, dass die KPI-Kacheln und das Hero-Diagramm korrekt gerendert werden, bevor Sie etwas anderes tun.
2. Setup-Assistenten überspringen: Öffnen Sie den Setup-Assistenten über die orangefarbene Aufforderung auf dem Übersichts-Bildschirm. Wenn Ihre vorhandenen Einstellungen bereits in Ordnung sind, können Sie sie abschließen, ohne jeden Schritt auszuführen. Es lohnt sich jedoch, einen kurzen Blick darauf zu werfen, um sicherzustellen, dass nichts Wichtiges übersehen wurde.
3. UI-Version auswählen: Gehen Sie zu Vorlagen > Frontend-Vorlagenstil und entscheiden Sie, welche Version am besten zu Ihrer Einrichtung passt. Wenn Sie benutzerdefinierte Vorlagenänderungen vorgenommen haben, bleiben Sie bei Legacy, um Fehler zu vermeiden. Wenn nicht, sollten Sie die Umstellung auf Erweitert oder Visuell in Betracht ziehen, um die neuen Layoutoptionen zu nutzen.
4. Akzentfarbe überprüfen: Navigieren Sie zu Vorlagen » Theming » Primäre Akzentfarbe und bestätigen Sie, dass sie mit Ihrer Marke übereinstimmt. Diese einzelne Farbe fließt über alle erweiterten und visuellen Seiten, daher lohnt es sich, sie richtig einzustellen, bevor Ihre Botschafter ihre Spendenaktionen teilen.
5. E-Mail-Gesundheitsbanner prüfen: Gehen Sie zurück zum Tab Übersicht und suchen Sie nach dem orangefarbenen Banner oben auf dem Bildschirm. Wenn etwas markiert ist, beheben Sie es jetzt – dies sind die Transaktions-E-Mails, auf die Ihre Spender und Botschafter angewiesen sind, um informiert zu bleiben.
6. Einreichung testen: Navigieren Sie zu /submit-campaign/ und reichen Sie eine Test-Spendenaktion über das Frontend ein. Bestätigen Sie, dass die neue Schritt-1-Kartenansicht wie erwartet funktioniert und dass das Formular ohne Probleme abgeschlossen wird.
7. Test-Einreichung genehmigen: Besuchen Sie Moderation, finden Sie Ihre Test-Einreichung und klicken Sie auf Genehmigen. Bestätigen Sie, dass die Bestätigungs-E-Mail korrekt versendet wird und die Spendenaktion den richtigen Status erhält.

💡 Neu bei Botschaftern? Die Willkommensnachricht auf dem Übersichts-Bildschirm verlinkt zurück zu dieser Seite und dient somit als Orientierungshilfe. Wenn Sie gerade die Programmverwaltung übernommen haben, beginnen Sie hier und arbeiten Sie die Checkliste von oben durch.

🎯 Versuchen Sie nicht, alles auf einmal zu lernen. Ambassadors 3.0 führt viele neue Funktionen ein, aber Sie müssen sie nicht alle am ersten Tag beherrschen. Sobald Sie die Checkliste abgeschlossen haben, wählen Sie die Funktion aus, die für die größten Probleme Ihres Teams am relevantesten ist, und beginnen Sie dort.

Das könnten Sie auch interessieren

Hier sind einige Anleitungen zu Botschaftern. Sie können sie als Lesezeichen speichern und lesen, wenn Sie sie benötigen:

• Migration von 2.x auf 3.0 – das IA-Spickzettel.
• Setup-Assistent – führen Sie den Assistenten aus, um 3.0-Standardeinstellungen für nicht festgelegte Präferenzen anzuwenden.
• Übersichts-Dashboard – Ihr neuer Startbildschirm.
• Hooks & Filter in Botschaftern – die Entwicklerreferenz.