Erfordert: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Jede sinnvolle Aktion in Ihrem Botschafterprogramm sollte eine Reaktion auslösen. Wenn eine Spendenaktion genehmigt wird, muss der Botschafter dies sofort wissen. Wenn die Bewerbung einer Person abgelehnt wird, verdient sie eine klare Erklärung. Wenn sich ein Rekrut über einen Einladungslink anmeldet, sollte die Person, die ihn rekrutiert hat, davon erfahren.

Botschafter versendet 5 Transaktions-E-Mails, die all dies automatisch abwickeln. Sie werden als Reaktion auf ein bestimmtes Ereignis versendet, nicht aus einer Marketingkampagne, die Sie manuell erstellen. Diese Seite dokumentiert jede einzelne: wann sie versendet wird, an wen sie geht, wie der Standardtext aussieht, welche Smart-Tags sie akzeptiert und wie sie angepasst oder deaktiviert werden kann.

Alle fünf E-Mails sind standardmäßig aktiviert.

Wo finde ich diese Botschafter-E-Mails?

Um den Text oder den Betreff einer dieser E-Mails zu bearbeiten, gehen Sie zu Spendenaktionen » Einstellungen » E-Mails.

Scrollen Sie, um die benötigten E-Mails zu finden. Sie können diese E-Mails hier aktivieren/deaktivieren.

Wie bearbeite ich Botschafter-E-Mails?

Sobald sie aktiviert sind, klicken Sie auf die Schaltfläche E-Mail-Einstellungen, um auf die E-Mail zuzugreifen.

Eine Standard-E-Mail ist für Sie eingerichtet.

Sie können die Betreffzeile, die Überschrift und den Text nach Ihren Wünschen ändern.

Es gibt auch Kurzcodes, die Sie verwenden können, um automatisch Informationen wie Ihre Website-URL, den Teamnamen, den Namen des Erstellers usw. abzurufen.

Wenn eine E-Mail versehentlich deaktiviert wird, sehen Sie sie in Ihrem E-Mail-Gesundheitsbanner.

Schnellübersicht

E-Mail	ID	Wird ausgelöst, wenn	Empfänger
Kampagne genehmigt	Kampagne von Creator genehmigt	Eine Spendenaktion wird von einem Moderator genehmigt oder bei der Einreichung automatisch genehmigt.	Der Botschafter.
Kampagne abgelehnt	Kampagne von Creator abgelehnt	Eine Spendenaktion wird von einem Moderator abgelehnt.	Der Botschafter.
Kampagne benötigt Überarbeitung	Kampagne von Creator: Überarbeitung erforderlich	Ein Moderator fordert Änderungen an.	Der Botschafter.
Eingeladener Rekrut genehmigt	Einladung von Creator genehmigt	Die erste Spendenaktion eines rekrutierten Botschafters wird genehmigt.	Der Einlader (Rekrutierer).
Neue Kampagne erfordert Aktion	Neue Kampagne erfordert eine Aktion	Eine neue Spendenaktion landet zur Überprüfung in der Warteschlange.	Website-Administratoren (jeder Benutzer mit manage_charitable_settings).

Die technische Seite

Kampagne genehmigt

ID: creator_campaign_approved
An: Der Botschafter (post_author der Spendenaktion)
Löst aus: Immer wenn eine Spendenaktion von einem anderen Status zu „Veröffentlicht“ wechselt. Die Aktion „Moderation genehmigen“ löst dies aus, die automatische Genehmigung bei Einreichung löst dies aus, und die manuelle Veröffentlichung über den WP-Editor löst dies aus.

Standard-Betreff

Your campaign is live

Standard-Text

Dear [charitable_email show=campaign_creator],

Your campaign, "[charitable_email show=campaign_title]", has been approved and is now live!

You can view your campaign online at [charitable_email show=campaign_url].

If you would like to edit it, go to [charitable_email show=campaign_edit_url].

Verfügbare Smart-Tags

Tag	Ersetzungen
[charitable_email show=campaign_creator]	Der Anzeigename des Botschafters.
[charitable_email show=campaign_title]	Der Titel der Spendenaktion.
[charitable_email show=campaign_url]	Die öffentliche URL der Spendenaktion.
[charitable_email show=campaign_edit_url]	Die Bearbeitungs-URL der Spendenaktion.
[charitable_email show=campaign_goal]	Der Zielbetrag.
[charitable_email show=campaign_end_date]	Das Enddatum der Spendenaktion.

Anpassungsfilter

add_filter( 'charitable_email_creator_campaign_approved_default_subject', function ( $subject, $email ) {
    return "🎉 Your fundraiser is live: " . $email->get_field_value( 'campaign_title' );
}, 10, 2 );

add_filter( 'charitable_email_creator_campaign_approved_default_body', function ( $body, $email ) {
    return "
Welcome aboard!
" . $body . "
Reply to this email if you have any questions.
";
}, 10, 2 );

Pro Aufruf unterdrücken

Wenn mit nicht angekreuztem Benachrichtigungsfeld genehmigt wird, wird die E-Mail unterdrückt durch:

add_filter( 'charitable_ambassadors_skip_creator_campaign_approved', '__return_true' );
// ...the approval runs...
remove_filter( 'charitable_ambassadors_skip_creator_campaign_approved', '__return_true' );

Verwenden Sie diesen Filter nicht für die websiteweite Unterdrückung. Verwenden Sie stattdessen das Standard-Benachrichtigungsfeld über moderation_default_notify_on_approve.

Kampagne abgelehnt

ID: creator_campaign_rejected
An: Der Botschafter
Löst aus: Wenn ein Moderator eine Spendenaktion über die Moderationswarteschlange ablehnt.

Standard-Betreff

Your campaign was not approved

Standard-Text

Dear [charitable_email show=campaign_creator],

We've reviewed your campaign, "[charitable_email show=campaign_title]", and unfortunately it does not meet our guidelines.

Reason: [charitable_email show=rejection_reason]

If you'd like to discuss this further or submit a revised campaign, please reach out at [admin_email].

Verfügbare Smart-Tags

Dieselbe Menge wie bei „Spendenaktion genehmigt“, plus:

Tag	Ersetzungen
[charitable_email show=rejection_reason]	Der Grundtext aus dem Ablehnungsmodal.

Anpassungsfilter

add_filter( 'charitable_email_creator_campaign_rejected_default_subject', function ( $subject ) {
    return 'About your recent fundraiser submission';
} );

add_filter( 'charitable_email_creator_campaign_rejected_default_body', function ( $body ) {
    return $body . '
You can read our submission guidelines at our guidelines page.
';
} );

Kampagne benötigt Überarbeitung

ID: creator_campaign_needs_revision
An: Der Botschafter
Löst aus: Wenn ein Moderator die Aktion Änderungen anfordern verwendet.

Standard-Betreff

Updates needed to your campaign

Standard-Text

Dear [charitable_email show=campaign_creator],

We've reviewed your campaign, "[charitable_email show=campaign_title]", and we'd like a few small updates before publishing.

Notes from our team: [charitable_email show=revision_notes]

You can edit your campaign at [charitable_email show=campaign_edit_url] and resubmit when you're ready.

Verfügbare Smart-Tags

Dieselbe Menge wie bei „Spendenaktion genehmigt“, plus:

Tag	Ersetzungen
[charitable_email show=revision_notes]	Die Notizen aus dem Modal „Änderungen anfordern“.
[charitable_email show=campaign_edit_url]	Die Editor-URL des Spendenwerbers mit einem Magic-Link-Token für die automatische Anmeldung.

Anpassungsfilter

add_filter( 'charitable_email_creator_campaign_needs_revision_default_body', function ( $body ) {
    return $body . '
Tip: reply to this email if you have questions about the requested changes.
';
} );

Eingeladener Rekrut genehmigt

ID: inviter_recruit_approved
An: Den Einladenden (Werber)
Löst aus: Wenn die erste Spendenaktion eines geworbenen Botschafters genehmigt wird, nachdem die Zuordnung den Geworbenen mit dem Einladenden verknüpft hat. Wird nur gesendet, wenn „Einladenden bei Genehmigung per E-Mail senden“ unter den Einladungseinstellungen aktiviert ist und nur, nachdem die Zuordnung den Geworbenen mit dem Einladenden verknüpft hat.

Standard-Betreff

[charitable_email show=recruit_name] just joined as a fundraiser thanks to you!

Standard-Text

Hi [charitable_email show=inviter_first_name],

Great news! [charitable_email show=recruit_name] just had their fundraiser approved - and they signed up through your invite link.

Their fundraiser: [charitable_email show=recruit_campaign_url]

Thanks for spreading the word.

Verfügbare Smart-Tags

Tag	Ersetzungen
[charitable_email show=inviter_name]	Der Anzeigename des Einladenden.
[charitable_email show=inviter_first_name]	Der Vorname des Einladenden.
[charitable_email show=recruit_name]	Der Anzeigename des Geworbenen.
[charitable_email show=recruit_campaign_title]	Der Titel der ersten Spendenaktion des Geworbenen.
[charitable_email show=recruit_campaign_url]	Die URL der ersten Spendenaktion des Geworbenen.
[charitable_email show=site_url]	Die URL Ihrer Website.

Anpassungsfilter

add_filter( 'charitable_email_inviter_recruit_approved_default_subject', function ( $subject, $email ) {
    $recruit = $email->get_field_value( 'recruit_name' );
    return "🎉 Your friend {$recruit} is fundraising too!";
}, 10, 2 );

Website-weite Deaktivierung

Schalten Sie die Einstellung „Einladenden bei Genehmigung per E-Mail senden“ unter Charitable » Botschafter » Einladungen um.

Neue Kampagne erfordert Aktion

ID: new_campaign_requires_action
An: Website-Administratoren (jeder Benutzer mit manage_charitable_settings)
Löst aus: Wenn eine neue Spendenaktion eingereicht wird und die automatische Genehmigung deaktiviert ist, d. h. sie landet in der Moderationswarteschlange.

Standard-Betreff

A new fundraiser needs your review

Standard-Text

A new fundraiser was submitted and is awaiting review.

Title: [charitable_email show=campaign_title]
Ambassador: [charitable_email show=campaign_creator]
Submitted: [charitable_email show=submission_date]

Review it in the Moderation queue: [charitable_email show=moderation_url]

Verfügbare Smart-Tags

Tag	Ersetzungen
[charitable_email show=campaign_title]	Der Titel der Spendenaktion.
[charitable_email show=campaign_creator]	Der Anzeigename des Botschafters.
[charitable_email show=campaign_url]	Die URL der Spendenaktion (Vorschau, falls noch nicht öffentlich).
[charitable_email show=submission_date]	Zeitstempel der Einreichung.
[charitable_email show=moderation_url]	Direktlink zur Ansicht „Ausstehend“ in der Moderation.

Anpassungsfilter

add_filter( 'charitable_email_new_campaign_requires_action_default_subject', function () {
    return '🔔 [Charitable] Fundraiser awaiting review';
} );

Drosselung

Die Admin-E-Mail wird einmal pro Einreichung gesendet. Wenn Ihr Moderationsteam klein ist und das Volumen zu laut wird, sollten Sie stattdessen Benachrichtigungen (das Glockensymbolfeld) verwenden. Es ist ratenbegrenzt und abweisbar, was es zu einer besseren Wahl für Programme mit hohem Volumen macht.

Was alle fünf E-Mails gemeinsam haben

Einige Konventionen gelten für jede E-Mail, was die Anpassung konsistent macht, sobald Sie das Muster kennen.

E-Mail-IDs

Die ID-Strings (wie z. B. creator_campaign_approved) sind stabil. Sie werden als Präfix für den Filter (charitable_email_<id>_default_subject usw.) und als Schlüssel für die Einstellung „Charitable-E-Mail ein/aus“ verwendet.

Filter

Jede E-Mail setzt den gleichen Satz von Filtern ein. Alle erhalten das $email-Objekt als zweites Argument, sodass Sie get_field_value() aufrufen können, um Ihre Anpassung zu erstellen:

charitable_email__default_subject
charitable_email__default_body
charitable_email__recipient_email
charitable_email__recipient_name
charitable_email__should_send

Smart-Tag-Filter

Fügen Sie neue Smart-Tags hinzu, indem Sie sich in den Filter für den Inhalt des Feldes einklinken, und verwenden Sie dann Ihr Tag in jedem E-Mail-Text:

add_filter( 'charitable_email_content_field_value_', function ( $value, $email ) {
    return 'Computed value';
}, 10, 2 );

// Then use [charitable_email show=your_tag] in any email body.

Absenderadresse

Alle fünf E-Mails verwenden standardmäßig die WordPress-admin_email. Überschreiben Sie dies global über charitable_email_from_address oder pro E-Mail über charitable_email_<id>_from_address.

HTML vs. Nur-Text

Alle fünf E-Mails sind standardmäßig HTML. Die E-Mail-Clients der Empfänger greifen automatisch auf eine Nur-Text-Darstellung zurück. Um Nur-Text zu erzwingen, geben Sie einen bereinigten Textkörper aus dem _default_body-Filter zurück.

Tipps, die es wert sind, beachtet zu werden

Ein paar Dinge, die einen echten Unterschied machen, wie diese E-Mails bei Ihren Botschaftern ankommen.

• Passen Sie Betreffzeilen stärker an als den Textkörper. Betreffzeilen treiben die Öffnungsraten an. Klare und direkte Texte übertreffen fast immer clevere Texte.
• Senden Sie immer einen Test, bevor Sie etwas bereitstellen. Charitable Pro verfügt über eine Schaltfläche „Test senden“ auf der Einstellungsseite jeder E-Mail. Verwenden Sie diese jedes Mal, wenn Sie einen Betreff oder Textkörper ändern, nicht nur bei der Ersteinrichtung.
• Verwenden Sie Smart-Tags großzügig. Das harte Kodieren des Namens des Botschafters würde bedeuten, dass jede Spendenaktion die gleiche unpersönliche E-Mail erhält. Smart-Tags lassen jede Nachricht so wirken, als wäre sie speziell für diese Person geschrieben worden.
• Halten Sie die E-Mail „Neue Kampagne erfordert Aktion“ kurz. Ihr Moderationsteam liest diese mehrmals pro Woche. Eine Einzeiler mit dem Kampagnentitel und einem direkten Link zur Warteschlange ist nützlicher als ein langer Absatz, den sie überfliegen werden.

Entwicklerreferenz

E-Mail-Klassenhierarchie

Charitable_Email                                                    # Pro base class
    └─ Charitable_Ambassadors_Email_Creator_Campaign_Submitted     # Base for creator-targeted emails
            ├─ Charitable_Ambassadors_Email_Creator_Campaign_Approved
            ├─ Charitable_Ambassadors_Email_Creator_Campaign_Rejected
            └─ Charitable_Ambassadors_Email_Creator_Campaign_Needs_Revision
    └─ Charitable_Ambassadors_Email_Inviter_Recruit_Approved        # For inviter-targeted
    └─ Charitable_Ambassadors_Email_New_Campaign_Requires_Action    # Admin-targeted

Jede Blattklasse befindet sich in includes/emails/.

Statische Helfer

Für programmatisches Auslösen:

Charitable_Ambassadors_Email_Creator_Campaign_Approved::send_with_campaign_id( $campaign_id );
Charitable_Ambassadors_Email_Creator_Campaign_Rejected::send_with_campaign_id( $campaign_id, $reason );
Charitable_Ambassadors_Email_Creator_Campaign_Needs_Revision::send_with_campaign_id( $campaign_id, $notes );
Charitable_Ambassadors_Email_Inviter_Recruit_Approved::send_with_recruit_id( $recruit_user_id, $recruit_campaign_id, $inviter_user_id );
Charitable_Ambassadors_Email_New_Campaign_Requires_Action::send_with_campaign_id( $campaign_id );

Funktionen

Die E-Mail „Neue Kampagne erfordert Aktion“ wird an alle Benutzer mit manage_charitable_settings gesendet. Um stattdessen bestimmte Administratoren anzusprechen, filtern Sie die Empfängerliste über charitable_email_new_campaign_requires_action_admin_recipients.

Zusammenfassung

Das deckt alle fünf Transaktions-E-Mails in Ambassadors ab. Zwischen den Genehmigungs-, Ablehnungs- und Überarbeitungs-E-Mails, die Ihre Botschafter erhalten, und der Admin-Benachrichtigung, die Ihre Moderationswarteschlange am Laufen hält, sind dies die Nachrichten, die Ihr Programm im Hintergrund reibungslos am Laufen halten. Passen Sie die Betreffzeilen an, verleihen Sie den Textkörpern Ihre Markenstimme und verwenden Sie Smart-Tags, um jede E-Mail persönlich wirken zu lassen.

Wenn Sie auf etwas stoßen, das hier nicht behandelt wird, oder Hilfe bei einer bestimmten E-Mail benötigen, hilft Ihnen unser Support-Team gerne weiter.

Das könnten Sie auch interessieren

Dies sind die Dokumente, die am engsten mit den Transaktions-E-Mails in Ambassadors verbunden sind.

• Moderation – die Aktionen (genehmigen, ablehnen, Änderungen anfordern), die die meisten dieser E-Mails auslösen.
• E-Mail-Gesundheit – die Benachrichtigungsleiste auf der Übersicht, die eine dieser E-Mails kennzeichnet, wenn sie versehentlich deaktiviert wurden.
• Benachrichtigungen – das In-Admin-Panel mit dem Glockensymbol, das diese E-Mails für Ihr Moderationsteam ergänzt.
• Einladungen – die Funktion, die die E-Mail „Einladender Rekrut genehmigt“ auslöst.
• Hooks & Filter in Botschaftern – die vollständige Filterreferenz.