Erfordert: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Wenn jemand auf den Einladungslink eines Botschafters klickt, ist das Erste, was er sieht, die Einladungs-Landingpage. Sie möchten, dass diese Seite fantastisch aussieht und alle wichtigen Informationen enthält, die ein neuer Botschafter benötigt. Es ist der Moment des ersten Eindrucks: Wer sie einlädt, welche Sache sie unterstützen sollen und was von ihnen verlangt wird.

Die Landingpage ist eine der wenigen Seiten, die Sie vollständig an Ihr Branding anpassen können.

In diesem Leitfaden zeigen wir Ihnen, wie Sie die Seite einrichten und anpassen.

Die technischen Details: Dies ist die Seite, die Sie auf Ihrer Website für die Darstellung des Shortcodes [charitable_invite_landing] einrichten. Der Shortcode ist der Renderer, aber die umgebende Seite (Hero, Navigation, Footer) ist Ihre normale WordPress-Seite. Der Shortcode fügt die Einlader-und-Sache-Karte einfach dort ein, wo Sie ihn platzieren.

Wann Sie es verwenden würden

• Einladungen zum ersten Mal einrichten – Sie benötigen diese Seite, bevor die Funktion etwas bewirken kann.
• Die Nachricht verfeinern – Der Standardtext funktioniert, aber wenn Sie ihn für Ihre Zielgruppe anpassen, konvertiert die Seite besser.
• Theme-Integration – Sie möchten das Layout (Hero-Bild, Seitenleiste, Footer) steuern, ohne die Logik des Shortcodes zu verlieren.

Wo Sie die Einstellungen für die Einladungs-Landingpage finden

Die Landingpage selbst ist eine normale WordPress-Seite. Der Shortcode, der sie antreibt, ist:

[charitable_invite_landing]

Um zu konfigurieren, welche Seite Ambassadors als Landingpage behandelt, gehen Sie zu Ihrem WordPress-Admin und navigieren Sie zu Charitable » Ambassadors » Invitations » Landing Page.

Erstellen der Einladungs-Landingpage

1. WordPress Admin » Seiten » Neu hinzufügen.
2. Geben Sie ihr einen einladenden Titel – „Unser Team beitreten“, „Fundraiser werden“, „Helfen Sie uns, unser Ziel zu erreichen“.
3. Paste the shortcode into the page content:

   [charitable_invite_landing]
   

4. Veröffentlichen.
5. Gehen Sie zu Charitable » Ambassadors » Invitations » Landing Page und wählen Sie diese Seite aus.

Die Seite ist nun bereit, Rekruten zu empfangen.

Was auf Ihrer Landingpage angezeigt wird

Der Shortcode rendert drei Elemente in dieser Reihenfolge:

Abschnitt	Was ist drin
Einlader-Hero	Avatar (echter Gravatar oder farbige Initialen), Name des Einladers, eine Phrase wie „Sarah hat Sie eingeladen, Spenden zu sammeln“.
Einleitungstext (optional)	Der Rich-Text-Einleitungstext der Landingpage, den Sie unter Invitations festlegen. Überspringen Sie ihn, wenn Sie keinen möchten.
Sache-Karte	Die übergeordnete Kampagne, zu der der Rekrut eingeladen wird – Hero-Bild, Titel, gesammelter Betrag/Zielbetrag, Spenderanzahl.
CTA	Ein Button „Fundraiser werden“, der auf Ihre Seite zum Einreichen von Kampagnen verlinkt und mit der Sache über cap_campaign=<id> vorausgefüllt ist.

Wenn der Rekrut die Seite direkt aufruft (kein Token, z. B. durch Klicken auf einen Link „Über dieses Programm“), sieht er eine generische Version mit Platzhalterinhalten. Der Shortcode wird nie leer gerendert – er hat immer etwas anzuzeigen.

Drei spezielle Zustände

Status	Was gerendert wird
Normal (gültiger Token von jemand anderem)	Einladungs-Hero + Spendenkampagnen-Karte + CTA „Fundraiser werden“.
Selbstrekrutierung (der Benutzer hat auf seinen eigenen Einladungslink geklickt, während er angemeldet war)	Eine freundliche Variante „Sie können sich nicht selbst rekrutieren“ – der Hero erhält eine Nachricht zur Selbstrekrutierung, der CTA wird unterdrückt.
Kein Token (jemand hat die Seiten-URL direkt aufgerufen)	Generischer Hero („Fundraiser werden“) + eine Spendenkampagnen-Karte, die Ihre prominenteste übergeordnete Kampagne anzeigt, oder ein Standardbild, falls keine konfiguriert ist.

Theme-Überschreibungen

Der Shortcode wird aus templates/invite/landing.php gerendert. Um das Markup oder Layout anzupassen, kopieren Sie es in Ihr Theme:

your-theme/charitable-pro/charitable-ambassadors/invite/landing.php

Innerhalb der Überschreibung haben Sie Zugriff auf:

Variable	Typ	Notizen
$inviter	WP_User	Der Einladende (false im Pfad ohne Token).
$inviter_name	Zeichenkette	Anzeigename (oder „Ihre gemeinnützige Organisation“, wenn leer).
$avatar_html	Zeichenkette	Der Avatar des Einladenden – echter Gravatar oder farbige Initialen.
$cause	WP_Post	Die übergeordnete Kampagne (false im Pfad ohne Token).
$cause_data	Array	Spendenkampagnen-Statistiken: raised, goal, donor_count, percent.
$intro_copy	Zeichenkette	Die Einstellung „Landing Page Intro Copy“ (Rich Text).
$cta_url	Zeichenkette	Die URL „Fundraiser werden“ (mit cap_campaign=NNN).
$cta_label	Zeichenkette	Die Beschriftung des CTA-Buttons (Standard „Fundraiser werden“, filterbar).
$is_preview	bool	Wahr, wenn ein Administrator ohne Token eine Vorschau anzeigt.
$is_self_recruit	bool	Wahr, wenn der eingeloggte Benutzer selbst der Einlader ist.

Anpassen des Textes

Die am häufigsten überschriebenen Elemente auf der Landingpage sind die Beschriftungen:

Filter	Standard	Zweck
charitable_ambassadors_invite_landing_cta_label	„Fundraiser werden“	Der Text der Schaltfläche auf dem CTA.
charitable_ambassadors_invite_landing_inviter_verb	„hat Sie eingeladen, Spenden zu sammeln“	Wird in der Heldenformulierung verwendet („Sarah hat Sie eingeladen, Spenden zu sammeln“).
charitable_ambassadors_invite_landing_self_recruit_copy	„Sie können sich nicht selbst werben…“	Der vollständige Text, der angezeigt wird, wenn die Selbstrekrutierung ausgelöst wird.
charitable_ambassadors_invite_landing_preview_notice	Admin-Vorschauhinweis	Der Hinweis, der Administratoren angezeigt wird, wenn sie die Seite ohne Token in der Vorschau anzeigen.

Für umfangreichere Änderungen (anderes Layout, andere Abschnitte) führen Sie ein Theme-Override durch.

Body-Klassen

Die Seite erhält zwei Body-Klassen, die Sie für CSS-Scoped verwenden können:

charitable-ambassadors-invite-landing
charitable-ambassadors-invite-landing--{state}    /* normal | self-recruit | preview */

Kombinieren Sie diese mit dem Designsystem Ihres Themes, um die Seite wie den Rest Ihrer Website aussehen zu lassen, ohne die Vorlage zu forken.

Caching

Die Landingpage ist dynamisch – personalisiert pro Einlader-Token über Cookies. Ambassadors markiert sie als dynamisch über den Filter charitable_is_dynamic_page von Pro 1.8.15.2, damit Caching-Plugins sie überspringen. Wenn Sie eine ältere Pro-Version haben, die diesen Filter nicht enthält, gibt der URL-Handler im Weiterleitungsschritt No-Cache-Header aus – aber ein Caching-Plugin könnte die Landingpage selbst cachen, was die Zuordnung brechen würde. Das Invitations-Admin zeigt eine Selbstüberprüfungswarnung an, wenn dieser Zustand erkannt wird.

Tipps

• Halten Sie die Seite fokussiert. Entfernen Sie irrelevante Navigation, Seitenleisten-Widgets und Footer-CTAs. Die Aufgabe dieser Seite ist es, einen Rekrutierten zu konvertieren, nicht Ihre Website zu durchsuchen.
• Fügen Sie ein einzeiliges Testimonial hinzu. „Sarah hat letztes Jahr 4.200 US-Dollar gesammelt – schließen Sie sich ihrem Team an und lassen Sie uns das übertreffen“ funktioniert besser als eine generische Bitte.
• Verwenden Sie das Landingpage-Fallback-Bild. Wenn ein Elternteil kein hervorgehobenes Bild hat (selten, aber kommt vor), verhindert das Fallback-Bild, dass die Spendenkarte kaputt aussieht.
• Vorschau ohne Token. Besuchen Sie als Administrator die Seiten-URL direkt. Sie sehen die generische Version – nützlich, um das Layout zu bestätigen, ohne einen echten Rekrutierten einzurichten.

---

Entwicklerreferenz

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

Shortcode

[charitable_invite_landing]

Der Shortcode wird bedingungslos registriert, auch wenn Invitations deaktiviert ist – sodass eine Seite, die den Shortcode verwendet, stattdessen eine reine Admin-Vorschauanzeige anzeigt, anstatt den wörtlichen [charitable_invite_landing]-Text preiszugeben.

Vorlagenpfad

templates/invite/landing.php     # default

Pfad für Theme-Override: your-theme/charitable-pro/charitable-ambassadors/invite/landing.php. Der Vorlagenwähler verwendet den Standardfilter charitable_locate_template von Charitable.

Filter

Filter	Standard	Zweck
charitable_ambassadors_invite_landing_cta_label	„Fundraiser werden“	Button-Beschriftung.
charitable_ambassadors_invite_landing_cta_url	submit-campaign URL	Die vollständige URL, zu der der CTA verlinkt. Empfängt ($url, $cause_id).
charitable_ambassadors_invite_landing_inviter_verb	„hat Sie eingeladen, Spenden zu sammeln“	Verb-Phrase im Hero-Bereich.
charitable_ambassadors_invite_landing_self_recruit_copy	berechnete Zeichenkette	Text für Selbst-Rekrutierung.
charitable_ambassadors_invite_landing_preview_notice	berechnet	Admin-Vorschau-Hinweisinhalt.
charitable_ambassadors_invite_landing_intro_copy	Einstellungswert	Filtert den gerenderten Einleitungstext (nach wp_kses_post).
charitable_ambassadors_invite_landing_cause_id	berechnet	Überschreibt, welche übergeordnete Kampagne auf der Ursachenkarte angezeigt wird (z. B. wenn das Token keine Kampagne hat, wählen Sie eine bestimmte hervorgehobene Ursache aus).
charitable_ambassadors_invite_landing_fallback_image_id	Einstellungswert	Die Anhangs-ID des Fallback-Bildes.
charitable_ambassadors_invite_landing_body_class	Array	Ändert das body_class-Array, das auf Landingpages angewendet wird.

Aktionen

Aktion	Argumente	Wird ausgelöst, wenn
charitable_ambassadors_invite_landing_before	$inviter, $cause, $context	Kurz bevor das Shortcode-Markup gerendert wird.
charitable_ambassadors_invite_landing_after	$inviter, $cause, $context	Kurz danach.
charitable_ambassadors_invite_landing_rendered	$inviter, $cause, $context	Der Shortcode hat sein Rendering abgeschlossen.

Body-Klasse

charitable-ambassadors-invite-landing wird zu body_class auf jeder Seite hinzugefügt, die den Shortcode enthält. Die Zustands-Suffix-Variante (--normal, --self-recruit, --preview) wird zur Laufzeit hinzugefügt. Über den charitable_ambassadors_invite_landing_body_class-Filter zum Array hinzufügen.

Erkennungshilfe

charitable_ambassadors_is_invite_landing_page( $post_id = null ); // bool

Nützlich beim Verdrahten von bedingtem Theme-Verhalten (z. B. Ausblenden der Website-Suchleiste auf der Landingpage).

Funktionen

Öffentlich lesbar. Kein Berechtigungs-Gate.

Beispiele für Anpassungen

Ändern Sie die CTA-Beschriftung:

add_filter( 'charitable_ambassadors_invite_landing_cta_label', function () {
    return 'Sign up to fundraise';
} );

Passen Sie die Selbst-Rekrutierungsnachricht an:

add_filter( 'charitable_ambassadors_invite_landing_self_recruit_copy', function () {
    return "Looks like you're already a fundraiser! Share your invite link with friends instead.";
} );

Fügen Sie ein Testimonial unter der Ursachenkarte ein:

add_action( 'charitable_ambassadors_invite_landing_after', function ( $inviter, $cause, $context ) {
    if ( ! $cause ) {
        return;
    }
    echo '<blockquote class="invite-testimonial"><p>"Joining as a fundraiser was the best decision I made this year." - Past Ambassador</p></blockquote>';
}, 10, 3 );

Verstecken Sie die Website-Navigation auf der Landingpage:

add_filter( 'body_class', function ( $classes ) {
    if ( charitable_ambassadors_is_invite_landing_page() ) {
        $classes[] = 'no-nav';
    }
    return $classes;
} );
// ...then in your theme's CSS: body.no-nav .site-header { display: none; }

CTA-URL überschreiben, um zu einer bestimmten Einreichungsseite zu verlinken:

add_filter( 'charitable_ambassadors_invite_landing_cta_url', function ( $url, $cause_id ) {
    return add_query_arg( 'cap_campaign', $cause_id, home_url( '/sign-up-to-fundraise/' ) );
}, 10, 2 );

Verwandt

• Einladungen – das übergeordnete Feature-Dokument.
• So funktioniert die Zuordnung – der Klick-zu-Gutschrift-Ablauf, zu dem diese Seite gehört.
• So werden Einladungsdaten gespeichert – die benutzerdefinierte Tabelle im Hintergrund.
• Kampagne einreichen – die Seite, zu der die CTA verlinkt.
• Hooks & Filter in Ambassadors – vollständige Referenz.