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_creator existiert 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:

1. Besuchen Sie Charitable > Botschafter – bestätigen Sie, dass Sie auf der Übersicht landen und die KPIs gerendert werden.
2. Überprüfen Sie den Tab „Moderation“ – alle ausstehenden Spendenkampagnen aus 2.x sollten unter „Ausstehend“ aufgeführt sein; zuvor abgelehnte sollten unter „Abgelehnt“ sein.
3. Überprüfen Sie das Verzeichnis – Ihre bestehenden Botschafter sollten in der Ansicht „Alle“ erscheinen.
4. Ö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.
5. 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).
6. 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.
7. 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.