Erfordert: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Kampagne einreichen ist das Formular, das Ihre Botschafter ausfüllen, um eine Spendenaktion zu erstellen. Es befindet sich hinter dem Shortcode [charitable_submit_campaign] und führt sie durch drei Schritte:

• Wählen Sie den Empfängertyp (sammle ich als Einzelperson? ein Team? ein Teammitglied?)
• Wählen Sie die übergeordnete Ursache, für die gesammelt wird
• Füllen Sie die Kampagnendetails aus (Titel, Geschichte, Ziel, Bild)

Die Version 3.0 führt einen Kartenraster-Schritt 1 ein, der den alten, auswählgesteuerten Ablauf ersetzt. Gleiches Datenmodell, viel benutzerfreundlichere UX – der Empfänger wird zu einer taktilen Kartenauswahl, die übergeordnete Kampagne wird zu einer reichhaltigen Auswahl mit Logos und Fortschrittsbalken anstelle einer langen Dropdown-Liste.

Wann Sie es verwenden würden

• Einrichtung – Der Einrichtungsassistent erstellt automatisch eine Seite /submit-campaign/ mit dem Shortcode darin. Besuchen Sie sie einmal, um dies zu bestätigen.
• Botschafter direkt mit einer bestimmten Ursache verknüpfen – teilen Sie ?cap_recipient=individual&cap_campaign=42 und das Formular wählt diese Optionen voraus.
• Theming – kopieren Sie die Vorlage in Ihr Theme, um websiteweite Layoutänderungen vorzunehmen.

Die Seite finden

/submit-campaign/ (oder welcher Slug auch immer Sie verwendet haben). Die Seite rendert das Formular für angemeldete Botschafter und fordert entweder zur Anmeldung auf oder leitet automatisch zur Anmeldung weiter (konfigurierbar unter Allgemein » Konto vor Einreichung erforderlich).

Wenn Sie auch die Einstellungen finden müssen, die das Formular steuern:

WordPress Admin > Charitable > Botschafter > Allgemein

Der Unter-Tab Allgemein enthält verfügbare Kampagnentypen, Standardauswahl, Slug für Spendenaktionen-URL, Konto vor Einreichung erforderlich, E-Mail-Verifizierung erforderlich, Kampagnen automatisch genehmigen, Mindest-/Maximalkampagnenlänge und die Auszahlungsmethode.

So verwenden Sie Kampagne einreichen bei Botschaftern

Schritt 1 – Wählen Sie Ihren Empfänger

Der erste Schritt fragt: Für wen ist diese Spendenaktion? Das Kartenraster zeigt, welche Empfängertypen Sie unter Allgemein » Verfügbare Kampagnentypen aktiviert haben:

Karte	Wählt, ob
Individuell	Der Botschafter sammelt alleine. Der häufigste Fall.
Team	Der Botschafter erstellt ein neues Team, dem sich andere Botschafter anschließen werden.
Teammitglied	Der Botschafter tritt einem bestehenden Team als Mitglied bei.

Das Kartenraster ist auf die UI-Version enhanced oder visual beschränkt. Websites, die noch auf Legacy laufen, sehen den ursprünglichen, auswählgesteuerten Schritt. Die Website-Einstellung Standardauswahl steuert, welche Karte beim ersten Laden des Formulars vorausgewählt wird – der erste aktivierte Typ, ein bestimmter Typ oder „Benutzer zur Auswahl auffordern“ (keine Vorauswahl, Schaltfläche „Weiter“ deaktiviert).

Wenn nur eine Karte standortweit aktiviert ist, springt das Formular automatisch zu Schritt 1 – es macht keinen Sinn, die Frage zu stellen.

Schritt 2 – Eine übergeordnete Kampagne auswählen

Wenn Ihre Website mehrere übergeordnete Kampagnen mit Peer-to-Peer-Unterstützung hat, ist Schritt 2 der übergeordnete Kampagnenauswähler:

Der Auswähler zeigt eine Karte für jede verfügbare übergeordnete Kampagne mit Miniaturansicht, Titel, aktuell gesammeltem Betrag vs. Ziel und einer Schaltfläche „Diese auswählen“. Über dem Raster befindet sich ein Suchfeld für Websites mit vielen übergeordneten Kampagnen.

Der Auswähler wird AJAX-gesteuert – er fragt einen Endpunkt ab, der nur die Kampagnen zurückgibt, für die der aktuelle Botschafter berechtigt ist, Spenden zu sammeln. Das ist wichtig: Er schließt inaktive Kampagnen, abgelaufene Kampagnen und jede Kampagne aus, die durch charitable_ambassadors_user_can_invite oder ähnliche Beschränkungen eingeschränkt ist.

Weiter ist deaktiviert, bis eine übergeordnete Kampagne ausgewählt wurde.

Wenn der Empfänger in Schritt 1 Teammitglied war, wird dieser Schritt durch einen Team-Auswähler ersetzt, der bestehende Teams als kompakte „Team beitreten“-Karten anzeigt.

Schritt 3 – Kampagnendetails ausfüllen

Schritt 3 ist das lange Formular: Titel, Geschichte, Ziel, Enddatum, vorgeschlagene Spendenbeträge, hervorgehobenes Bild. Dieser Schritt ist, was auch immer das Standard-Kampagnen-Einreichungsformular von Charitable Pro generiert. Es berücksichtigt alle Feld-Einstellungen, die in den allgemeinen Einstellungen von Charitable konfiguriert sind.

Senden, und:

• Ein neuer Kampagnen-Beitrag wird als draft (Entwurf) erstellt (oder pending, wenn Kampagnen automatisch genehmigen deaktiviert ist).
• Die Aktion charitable_campaign_submission_save wird ausgelöst, auf die der Einladungs-Attributionshandler hört.
• Wenn die automatische Genehmigung aktiviert ist, wird die Spendenaktion sofort veröffentlicht.
• Wenn die automatische Genehmigung deaktiviert ist, landet die Spendenaktion in der Moderation, damit Ihr Team sie überprüfen kann.

Deep-Linking mit cap_recipient und cap_campaign

Sie können die Schritte 1 und 2 vorab ausfüllen, indem Sie Abfrageparameter an die Einreichungs-URL anhängen:

/submit-campaign/?cap_recipient=individual&cap_campaign=42

Parameter	Was vorausgewählt wird
cap_empfänger	individual / team / team-member – der Empfängertyp.
cap_kampagne	Eine übergeordnete Kampagnen-ID. Wenn gültig, wird der Auswähler übersprungen und die übergeordnete Kampagne gesperrt.

Die Namen der Abfrageparameter können über charitable_ambassadors_submit_form_query_arg_names gefiltert werden, falls Sie andere Namen verwenden müssen (für die Kompatibilität mit älteren URLs).

Das Pop-up „Für diese Kampagne rekrutieren“ auf „Meine Kampagnen“ generiert URLs genau in dieser Form, sodass, wenn ein Rekrut auf einen Einladungslink klickt, das Formular vorab für die richtige übergeordnete Kampagne ausgefüllt wird.

Der Shortcode

[charitable_submit_campaign]

Optionales Attribut:

[charitable_submit_campaign parent_id="42"]

Wenn parent_id gesetzt ist, sperrt der Shortcode die übergeordnete Kampagne zur Renderzeit (identisch mit der Übergabe von cap_campaign=42 in der URL).

Vorlagendateien

Pfad	Verwendet, wenn
templates/shortcodes/submit-campaign.php	Legacy-UI-Version.
templates/shortcodes/submit-campaign-enhanced.php	Erweiterte Versionen mit visueller Benutzeroberfläche, wenn der card-grid-Pfad aktiv ist.
templates/shortcodes/submit-campaign/<partial>.php	Schrittweise Teil-Dateien, auf die von der erweiterten Shell verwiesen wird.

Pfad zur Theme-Überschreibung: your-theme/charitable-pro/charitable-ambassadors/submit-campaign-enhanced.php (und die schrittweisen Teil-Dateien).

Berechtigung und Zugang

Einstellung	Standard	Auswirkung
Konto vor Einreichung erforderlich	Ein	Botschafter müssen angemeldet sein. Abgemeldete Besucher sehen eine Anmeldeaufforderung mit einer Weiterleitung zurück zur Einreichungsseite.
E-Mail-Verifizierung erforderlich	Ein	Botschafter, die ihre E-Mail noch nicht verifiziert haben, sehen anstelle des Formulars eine Aufforderung zur Verifizierung.
Automatische Genehmigung von Kampagnen	Aus	Ob neue Einreichungen sofort veröffentlicht werden oder zur Moderation gelangen.

Wenn Ihre Website offener ist („jeder kann einreichen, wir kümmern uns später darum“), schalten Sie beide „Require“-Flags aus. Wenn Sie strenger sind („nur verifizierte Konten können einreichen“), schalten Sie beide ein.

Obergrenze pro Empfänger

Sie können die Anzahl der Spendenaktionen, die ein einzelner Botschafter gleichzeitig haben kann, über den charitable_ambassadors_user_max_fundraisers Filter begrenzen. Wenn diese überschritten wird, zeigt der Einreichungsbutton in Schritt 3 eine freundliche Benachrichtigung „Sie haben Ihr Spendenaktionslimit erreicht“ anstelle der Einreichung.

Tipps

• Verwenden Sie Deep-Link-URLs in Ihren Einladungs-E-Mails. Lassen Sie Botschafter nicht durch eine übergeordnete Auswahl suchen – wenn Sie bereits wissen, für welche Sache sie werben, übergeben Sie cap_campaign=ID im Link.
• Die Standardauswahl ist wichtig. „Erster aktivierter Typ“ wirkt einladend; „Benutzer zur Auswahl auffordern“ wirkt überlegt. Wählen Sie passend zur Persönlichkeit Ihres Programms.
• Automatische Genehmigung für vertrauenswürdige Teams, manuell für die Öffentlichkeit. Eine Gala für Ihre bestehenden Spender? Automatische Genehmigung. Ein öffentliches P2P? Manuelle Moderation.
• Lesen Sie Ihre Formulardaten über das Verzeichnisprofil. Wenn Sie wissen müssen, was ein Botschafter ausgefüllt hat, zeigt der Tab „Formulardaten“ auf seinem Profil alles an, ohne dass Sie sich als er anmelden müssen.

---

Entwicklerreferenz

Der Rest dieser Seite ist für Entwickler, die das Einreichungsformular anpassen.

Shortcode

[charitable_submit_campaign]
[charitable_submit_campaign parent_id="42"]

Klasse: Charitable_Ambassadors_Submit_Campaign_Shortcode. Der Shortcode delegiert an eine Charitable_Ambassadors_Campaign_Form Formularinstanz und deren Prozessor.

Filter

Filter	Standard	Zweck
charitable_submit_campaign_shortcode	gerendertes HTML	Filtern Sie die gesamte Shortcode-Ausgabe.
charitable_ambassadors_use_card_submit_form	berechnet	Erzwingt den card-grid-Pfad ein/aus. Gibt true zurück, wenn die UI-Version erweitert/visuell und nicht Legacy ist.
charitable_ambassadors_submit_form_query_arg_names	[ 'recipient'=>'cap_recipient', 'campaign'=>'cap_campaign' ]	Benennen Sie die für Deep-Linking verwendeten Query-Argumente um.
charitable_ambassadors_step1_expected_total	berechnet	Überschreiben Sie die Gesamtzahl der Schritte, die in der „Schritt 1 von N“-Pille angezeigt wird (die get_pages() des Formulars kann bedingte Seiten, die nachgelagert registriert sind, nicht sehen).
charitable_ambassadors_submit_form_recipient_card_help_url	''	URL für einen optionalen „Mehr erfahren“-Link im Hilfetext der Empfängerkarte.
charitable_ambassadors_user_max_fundraisers	unbegrenzt	Maximale Anzahl von publish + pending Spendenaktionen, die ein einzelner Botschafter besitzen kann.
charitable_campaign_submission_user_fields	berechnet	Felder, die im Abschnitt „Benutzerfelder“ von Schritt 3 angezeigt werden. Wird mit dem Formular „Botschafter hinzufügen“ des Verzeichnisses geteilt.

Aktionen

Aktion	Argumente	Wird ausgelöst, wenn
charitable_ambassadors_before_submit_form_step1	–	Kurz bevor der Container von Schritt 1 gerendert wird.
charitable_ambassadors_after_submit_form_step1	–	Kurz nach Schritt 1.
charitable_submit_campaign_shortcode_hidden	$form_args	Abgemeldeter / Kein-Berechtigungs-Status wurde anstelle des Formulars gerendert.
charitable_campaign_submission_save	$data, $campaign_id, $user_id, $form	Wird von Pro ausgelöst, nachdem das Formular erfolgreich eine Spendenaktion erstellt/aktualisiert hat. Der Einladungs-Attributions-Handler hört auf dieses Signal.

AJAX-Endpunkte

Aktion	Zweck
charitable_ambassadors_submit_picker_query	Der Autocomplete für die Auswahl der übergeordneten Spendenaktion. Nonce-Aktion charitable_ambassadors_submit_picker, keine Berechtigungsprüfung (muss angemeldet sein).

Hilfsfunktion zur URL-Erkennung

charitable_ambassadors_get_submit_form_query_args() // ['recipient' => 'individual'|'team'|..., 'campaign' => 0|int]

Verwenden Sie dies, um den aktiven Deep-Link-Status aus Ihrer eigenen benutzerdefinierten Benutzeroberfläche zu überprüfen.

Berechtigungsprüfungen

Das Formular verwendet Charitable_Ambassadors_Campaign_Form::current_user_can_edit_campaign(), um zu entscheiden, ob das Formular gerendert werden soll. Gibt false zurück für:

• Nicht angemeldete Benutzer.
• Benutzer, deren Konten eine E-Mail-Verifizierung erfordern und diese noch nicht abgeschlossen haben.
• Benutzer ohne die Berechtigung zum Bearbeiten von Beiträgen beim Bearbeiten einer vorhandenen Spendenaktion.

Schrittweise Teilansichten

templates/shortcodes/submit-campaign/recipient-cards.php   # Step 1 cards
templates/shortcodes/submit-campaign/parent-picker.php     # Step 2 picker
templates/shortcodes/submit-campaign/team-picker.php       # Step 2 team variant
templates/shortcodes/submit-campaign/campaign-details.php  # Step 3 wrap

Jede kann über den gleichen Pfad your-theme/charitable-pro/charitable-ambassadors/<partial>.php vom Theme überschrieben werden.

Beispiele für Anpassungen

Erzwingen Sie das Legacy-Einreichungsformular für alle Benutzer (z. B. während einer Regression-Debug):

add_filter( 'charitable_ambassadors_use_card_submit_form', '__return_false' );

Beschränken Sie jeden Botschafter auf eine einzige gleichzeitige Spendenaktion:

add_filter( 'charitable_ambassadors_user_max_fundraisers', function () {
    return 1;
} );

Fügen Sie ein „Willkommen zurück“-Banner über Schritt 1 für zurückkehrende Botschafter hinzu:

add_action( 'charitable_ambassadors_before_submit_form_step1', function () {
    $user = wp_get_current_user();
    if ( $user && get_user_meta( $user->ID, '_charitable_ambassadors_submitted_before', true ) ) {
        echo '<div class="notice notice-info"><p>Welcome back, ' . esc_html( $user->display_name ) . '!</p></div>';
    }
} );

Benennen Sie die Abfrageargumente um (z. B. für Abwärtskompatibilität mit einer bestehenden Kampagne):

add_filter( 'charitable_ambassadors_submit_form_query_arg_names', function () {
    return [ 'recipient' => 'team_type', 'campaign' => 'parent' ];
} );

Stempeln Sie die eingereichte Spendenaktion beim Speichern mit der verweisenden URL:

add_action( 'charitable_campaign_submission_save', function ( $data, $campaign_id, $user_id, $form ) {
    $ref = wp_get_referer();
    if ( $ref ) {
        update_post_meta( $campaign_id, '_referer_at_submit', esc_url_raw( $ref ) );
    }
}, 10, 4 );

Verwandt

• Meine Kampagnen – wohin Botschafter nach der Einreichung gelangen.
• Moderation – wohin Einreichungen zur Überprüfung gehen.
• Einladungen – Zuordnung – wie Klicks auf Einladungslinks mit Einreichungen verknüpft werden.
• Einrichtungsassistent – der Assistent erstellt die Einreichungsseite für Sie.
• Hooks & Filter in Ambassadors – vollständige Referenz.

---