Erforderlich: Charitable Pro 1.8.16+
Ambassadors 3.0 ist eine umfassende Überarbeitung. Die vorherige Version organisierte Einstellungen als eine Unterseite unter Charitable Settings; 3.0 befördert Ambassadors zu einem Top-Level Admin-Tab mit eigenen Unter-Tabs (Übersicht, Moderation, Verzeichnis, Einladungen, Allgemein, Vorlagen, Meine Kampagnen, Spenden-Seite, Teilen, Sonstiges).
Die meisten Einstellungen behielten ihre Optionsschlüssel und gespeicherten Werte, sodass Ihre Daten übernommen werden. Aber die Menüpfade haben sich geändert – und einige Funktionen haben neue Orte.
Diese Seite ist die Spickzettel, um zu finden, was wohin verschoben wurde.
Einstellungen sind umgezogen
Der 2.x Admin befand sich unter:
Charitable » Settings » Ambassadors
Der 3.0 Admin befindet sich unter:
» Charitable » Ambassadors
Diese eine Änderung ist das, was die meisten Benutzer beim ersten Start nach dem Upgrade bemerken. Das Menü „Einstellungen“ unter Charitable existiert weiterhin für andere Einstellungen (Zahlungen, E-Mails, Erweitert usw.), aber Ambassadors ist keine seiner Unterseiten mehr.
Wo sich gängige 2.x-Einstellungen jetzt in 3.0 befinden
| 2.x-Standort | 3.0-Standort |
|---|---|
Einstellungen > Ambassadors > Allgemein | Charitable > Ambassadors > Allgemein |
Einstellungen > Ambassadors > Anzeige | Charitable > Ambassadors > Vorlagen (umbenannt) |
Einstellungen > Ambassadors > Sonstiges | Aufgeteilt in Charitable > Ambassadors > Teilen und Charitable > Ambassadors > Sonstiges |
| Frontend-Vorlagenstil | Charitable > Ambassadors > Vorlagen (oben im Tab) |
| Automatische Genehmigung von Kampagnen | Charitable > Ambassadors > Allgemein (unveränderter Standort, gleicher Optionsschlüssel) |
| Min/Max Kampagnenlänge | Charitable > Ambassadors > Allgemein (unverändert) |
| Konto vor Einreichung erforderlich | Charitable > Ambassadors > Allgemein (unverändert) |
| Kampagnenempfänger (Typen) | Charitable > Ambassadors > Allgemein (jetzt visueller Chip-Auswähler) |
| Auswahl des Share-Netzwerks | Charitable > Ambassadors > Teilen (neuer dedizierter Unter-Tab, war Sonstiges > Teilen in 2.x) |
| Umschalttasten für Meine Kampagnen | Charitable > Ambassadors > Meine Kampagnen (neuer dedizierter Unter-Tab) |
| Umschalttasten für die Spenden-Seite | Charitable > Ambassadors > Spenden-Seite (neuer dedizierter Unter-Tab) |
| Kampagnenersteller-Spendenbericht | Spenden > Botschafter > Meine Kampagnen (verschoben vom allgemeinen Unter-Tab in 3.0) |
| QR-Codes-Hauptschalter | Spenden > Botschafter > Diverses > QR-Codes (neuer Unterbereich) |
Was ist neu in 3.0
Sechs komplett neue Top-Level-Tabs:
| Tab | Was es tut |
|---|---|
| Übersicht | Programm-Dashboard mit KPI-Kacheln, Hauptdiagramm, Top-Performer. Neu in 3.0. |
| Moderation | Die Warteschlange Ausstehend / Erfordert Aktion / Abgelehnt / Genehmigt. Ersetzt die alte Admin-Liste „Ausstehende Einreichungen“. |
| Verzeichnis | Die vollständige Botschafterliste mit Profilen, Verifizierung, Filtern, CSV-Export. Ersetzt den impliziten Pfad „Benutzer mit mindestens einer Kampagne“. |
| Einladungen | Die Funktion zur persönlichen Einladungslink-Rekrutierung. Brandneu. |
| Unter-Tab „Meine Kampagnen“ | Die Besucher-Seite „Meine Kampagnen“ hat jetzt einen eigenen Einstellungs-Unter-Tab mit Live-Vorschau. |
| Unter-Tab „Fundraiser-Seite“ | Der erweiterte Layout-Varianten-Wähler, Breadcrumbs, Teilen, Spenderwand-Position, Bereinigung der Benutzeroberfläche. Neuer Unter-Tab. |
Große neue Funktionen innerhalb bestehender Tabs
Einige Funktionen, die es in 2.x überhaupt nicht gab:
| Funktion | Befindet sich bei | Notizen |
|---|---|---|
| Einrichtungsassistent | Der orangefarbene Einrichtungs-Hinweis auf Übersicht – oder Spenden > Botschafter > Allgemein > Einrichtungsaktionen > Einrichtung öffnen | Drei Abschlusswege (Assistent / Vorlagen / Schneller Start). |
| Visueller Vorlagenmodus | Spenden > Botschafter > Vorlagen > Frontend-Vorlagenstil > Visuell | Wählen Sie eine Vorlagenkampagne, deren Builder-Layout auf jeden Fundraiser geklont wird. |
| 8 Layout-Varianten | Spenden > Botschafter > Vorlagen > Frontend-Vorlage (Erweitert) | Klassisch, Story-Forward, Stats-Forward, Donate-First, Magazin, Showcase, Showcase Poster, Rally. |
| Lokale Benachrichtigungen | Pro-Glockensymbol | 4 Ereignisse werden von Botschaftern ausgelöst. |
| Widget einbetten | Spenden > Botschafter > Diverses > Widget einbetten | Standardmäßig deaktiviert; aktivieren Sie es, um dem Popover für die Fundraiser-Freigabe eine Kachel für das Widget zum Einbetten hinzuzufügen. |
| CSV-Exporte | Pro Abschnitt Download-Schaltflächen in Übersicht, Moderation, Verzeichnis, Einladungen | Formel-injektionssicher, begrenzt auf 10.000 Zeilen. |
Umbenannte Einstellungen
| 2.x-Name | 3.0-Name |
|---|---|
| Frontend-Vorlagenstil (unter Anzeige) | Frontend-Vorlagenstil (unter Vorlagen – Unterregisterkarte umbenannt) |
| „Spendenwand anzeigen“ | „Position der Spendenwand“ (jetzt Oben / Unten / Ausblenden statt Ein / Aus) |
| „QR-Code anzeigen“ (eine Einstellung) | Aufgeteilt in QR-Code auf der Spenden-Seite anzeigen, QR-Code-Kachel in Freigabe-Popover anzeigen, QR-Code anzeigen (Meine Kampagnen) – oberflächenspezifische Steuerelemente |
Entfernte Einstellungen
Einige Einstellungen wurden entfernt, da sie nie wirksam waren oder besser anders ausgedrückt wurden:
| Entfernte Einstellung | 2.x-Standort | Warum |
|---|---|---|
| Abschnitt Elemente der öffentlichen Seite | Unter der Unterregisterkarte Vorlagen / Anzeige | Kundenseitige variantenbezogene Steuerung erfolgt nun über _render_<atom>_args-Filter; die Einstellungs-UI war überladen. |
| Eigenständige „Moderations“-Vorlagen-Overrides | Vorlagen | Ersetzt durch die einheitliche Registerkarte Moderation. |
Wenn Ihre bestehende Website auf eine dieser Funktionen angewiesen war, ist der entsprechende Filter weiterhin vorhanden – die Benutzeroberfläche zeigt ihn nur nicht mehr als Einstellung an.
Umbenannte Filter und Aktionen
Die meisten Filter- und Aktionsnamen aus 2.x sind in 3.0 unverändert. Einige Ausnahmen:
| 2.x-Name | 3.0-Name |
|---|---|
charitable_ambassadors_settings_display_fields | charitable_ambassadors_settings_display_fields (beibehalten für Abwärtskompatibilität – die Registerkarte wurde in Vorlagen umbenannt, aber der Filtername bleibt für Websites bestehen, die ihn verwendet haben). |
Wenn Sie in 2.x Filter verwendet haben, sollten diese in 3.0 weiterhin ausgelöst werden, sofern nicht ausdrücklich anders angegeben. Führen Sie einen grep über Ihre Anpassungen durch:
grep -rn "charitable_ambassadors_" your-customizations/ | sort -u
...und gleichen Sie diese mit der Hook-Referenz ab, um zu sehen, was noch aktiv ist und was umbenannt wurde.
Was gleich bleibt
Beruhigend: Der Großteil Ihrer bestehenden Einrichtung wird ohne Änderungen übernommen.
- Alle Optionsschlüssel bleiben erhalten. Die Schlüssel
wp_options.charitable_settings.ambassadors.*sind dieselben. Bestehende Anpassungen an diesen Optionen gelten weiterhin. - Alle Benutzerrollen bleiben erhalten.
campaign_creatorexistiert weiterhin und hat dieselben Berechtigungen. - Alle benutzerdefinierten Beitragstypen bleiben erhalten. Kampagnen-Beitragstypen haben sich nicht geändert.
- Alle Shortcodes bleiben erhalten.
[charitable_submit_campaign],[charitable_my_campaigns]usw. funktionieren identisch. - Alle Spenden-URLs bleiben erhalten. Die Permalinks Ihrer bestehenden Spendenkampagnen ändern sich nicht.
- Spenden-Daten bleiben erhalten. Alle historischen Spenden werden auf dieselbe Weise wie in 2.x auf Spendenkampagnen und übergeordnete Elemente aufgeschlüsselt.
Was Sie nach dem Upgrade überprüfen sollten
Eine kurze Liste, die Sie direkt nach dem Upgrade durchgehen können:
- Besuchen Sie Charitable > Botschafter – bestätigen Sie, dass Sie auf der Übersicht landen und die KPIs gerendert werden.
- Überprüfen Sie den Tab „Moderation“ – alle ausstehenden Spendenkampagnen aus 2.x sollten unter „Ausstehend“ aufgeführt sein; zuvor abgelehnte sollten unter „Abgelehnt“ sein.
- Überprüfen Sie das Verzeichnis – Ihre bestehenden Botschafter sollten in der Ansicht „Alle“ erscheinen.
- Öffnen Sie den Einrichtungsassistenten einmal – er zeigt den Pfad-Auswähler an; Sie können ihn überspringen (Ihre bestehenden Einstellungen bleiben erhalten) oder den Schnellstart ausführen, um die Standardeinstellungen von 3.0 für nicht festgelegte Präferenzen anzuwenden.
- Führen Sie einen Integritätscheck für Vorlagen > Frontend-Vorlagenstil durch – bestätigen Sie, dass der richtige Stil ausgewählt ist (Legacy / Erweitert / Visuell).
- Führen Sie eine Test-Einreichung durch – reichen Sie eine neue Spendenkampagne über
/submit-campaign/ein und bestätigen Sie, dass der 3-stufige Kartenraster-Flow End-to-End funktioniert. - Führen Sie eine Test-Genehmigung durch – genehmigen Sie die Test-Einreichung aus der Moderation; bestätigen Sie, dass die E-Mail gesendet wird und das Audit-Protokoll die Aktion aufzeichnet.
Wenn etwas nicht stimmt, überprüfen Sie Charitable Tools > Protokoll auf entsprechende Einträge.
Häufige Überraschungen
Ein paar Dinge, die Upgrader überraschen:
| Überraschung | Warum |
|---|---|
| „Wo sind die Botschafter in den Einstellungen geblieben?“ | Sie wurden in einen eigenen Menüpunkt unter Charitable verschoben. Charitable > Botschafter. |
| „Meine alte Test-Kampagne ist unter ‚Abgelehnt‘, aber ich habe sie nie abgelehnt.“ | Botschafter 3.0 führt den Beitragstatus charitable-rejected ein. Alte Spendenkampagnen in einem nie veröffentlichten „abgelehnten“ Zustand werden beim ersten Speichern dorthin umklassifiziert. |
| „Es gibt 6 neue Admin-Unter-Tabs.“ | Moderation, Verzeichnis, Einladungen, Meine Kampagnen, Spendenkampagnen-Seite, Teilen sind alle neu. Klicken Sie sich durch sie, um jede neue Funktion zu finden. |
| „Meine QR-Code-Einstellung ist weg.“ | Sie wurde in steuerbare Elemente pro Oberfläche aufgeteilt. Finden Sie sie unter Sonstiges (Master) + den Unter-Tabs Meine Kampagnen / Spendenkampagnen-Seite (pro Oberfläche). |
| „Meine Kampagnen sehen auf dem Frontend anders aus.“ | Die erweiterte Vorlage ist jetzt standardmäßig aktiv. Einstellungen > Vorlagen > Legacy stellt das alte Aussehen wieder her. |
Tipps
- Aktualisieren Sie zuerst in einer Staging-Umgebung. Es ist immer eine gute Idee, eine Kopie Ihrer Produktionsseite zu verwenden, um die Änderungen durchzugehen, bevor Kunden sie sehen.
- Machen Sie Vorher-Nachher-Screenshots. Besonders von „Meine Kampagnen“ und einer echten Spendenkampagnen-Seite – damit Sie, falls nach dem Upgrade etwas nicht stimmt, eine Referenz haben.
- Führen Sie den Einrichtungsassistenten mindestens einmal aus. Selbst wenn Sie jeden Schritt überspringen, wird das Flag onboarding-complete gesetzt und die orangefarbene Aufforderung zur Übersicht ausgeblendet.
- Lesen Sie die Versionshinweise 3.0. Die Seite mit den Versionshinweisen ist das kanonische Änderungsprotokoll mit verknüpften Details zu jeder neuen Funktion.
Verwandt
- Übersicht-Dashboard – der neue Startbildschirm.
- Einrichtungsassistent – die drei Abschlusswege für die erstmalige Einrichtung.
- Anzeigefunktionen (Registerkarte Vorlagen) – die Ausrichtung der neuen Registerkarte Vorlagen.
- Addon-Update (Versionshinweise 3.0) – das kanonische Änderungsprotokoll.
- Hooks & Filter in Ambassadors – vollständige Filter- und Aktionsreferenz.
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→
