Erfordert: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+
Die Karte Rekrutierungs-Fundraiser befindet sich oben auf der Seite Meine Kampagnen eines berechtigten Botschafters. Sie zeigt die persönliche Einladungs-URL, Freigabe-Schaltflächen, eine Statistikzeile und eine Umschaltfläche „Ihre Rekruten“ an – und ist die am häufigsten angepasste Oberfläche in Botschaftern, da jedes Programm eine leicht unterschiedliche Nachricht über dem Rekrutierungslink anzeigen möchte.
Diese Seite ist die Referenz für die Filter und Aktionen, mit denen Sie die Rekrutierungskarte anpassen können, ohne die Vorlage zu forken.
Wo es sich befindet
Die Karte wird innerhalb der Aktion charitable_ambassadors_my_campaigns_before_grid gerendert – mit anderen Worten, kurz vor dem Kampagnenraster auf der Seite [charitable_my_campaigns].
Ihr Vorlagenpfad: templates/invite/recruit-card.php. Pfad zur Theme-Überschreibung: your-theme/charitable-pro/charitable-ambassadors/invite/recruit-card.php.
Die häufigste Anpassung: Link „Mehr erfahren“
Standardmäßig hat die Karte keinen Link „Mehr erfahren“ – wir lassen den Platz leer, damit Websites, die ihn nicht benötigen, sauber bleiben. Um ihn zu aktivieren, legen Sie sowohl die URL als auch (optional) die Beschriftung fest:
add_filter( 'charitable_ambassadors_recruit_card_learn_more_url', function () {
return home_url( '/ambassador-handbook/recruiting/' );
} );
add_filter( 'charitable_ambassadors_recruit_card_learn_more_label', function () {
return 'Tips for inviting friends';
} );
Der Link wird am unteren Rand der Karte inline mit einem externen Linkziel gerendert (damit er sich in einem neuen Tab öffnet, ohne den aktuellen Platz des Benutzers zu verlieren).
Wenn die URL leer ist (Standard), wird der Platz komplett unterdrückt – kein leerer Platzhalter.
Benutzerdefinierten Inhalt einfügen (Fußzeilen-Hook)
Für *mehr* als nur einen einzelnen Link – ein kurzes Pitch, ein Video-Embed, ein Widget „Top-Rekrutierer dieser Woche anzeigen“ – verwenden Sie die Fußzeilen-Aktion:
add_action( 'charitable_ambassadors_recruit_card_footer', function ( $user_id, $token, $invite_url ) {
echo '<p class="recruit-card-tip">Pro tip: share with two people who would care about this cause.</p>';
echo '<a class="button" href="https://example.com/recruit-video">Watch the 2-minute guide</a>';
}, 10, 3 );
Die Aktion wird direkt über dem „Mehr erfahren“-Slot ausgeführt. Ihr Callback ist für die eigene Maskierung verantwortlich.
Berechtigung – steuern Sie, wer die Karte sieht
Die Karte wird nur für Benutzer angezeigt, die *zum Rekrutieren berechtigt* sind. Dies wird durch den Filter charitable_ambassadors_user_can_invite definiert:
add_filter( 'charitable_ambassadors_user_can_invite', function ( $can, $user_id, $campaign_id_or_null ) {
// Only verified ambassadors can recruit.
if ( '1' !== get_user_meta( $user_id, '_charitable_ambassadors_verified', true ) ) {
return false;
}
return $can;
}, 10, 3 );
Der Filter ist global – er steuert sowohl die Meine Kampagnen-Karte ALS AUCH die Rekrutierungs-Popups pro Kampagne UND die Admin-Vorschau „Als Rekrutierer anzeigen“.
Um die Sichtbarkeit der Karte speziell zu überschreiben (ohne andere Oberflächen zu beeinträchtigen), filtern Sie charitable_ambassadors_show_recruit_card:
add_filter( 'charitable_ambassadors_show_recruit_card', function ( $show, $user_id ) {
// Hide the card on Mondays. Don't ask.
return $show && 'Mon' !== gmdate( 'D' );
}, 10, 2 );
Text im Leerzustand anpassen
Wenn ein Einladender noch keine Rekruten hat, zeigt die Statistikzeile der Karte eine sanfte Aufforderung „Noch keine Rekruten“ an. Passen Sie diese an:
add_filter( 'charitable_ambassadors_recruit_card_empty_text', function () {
return 'No recruits yet - your link is ready when you are.';
} );
Spiegel-Filter für den Leerzustand der Ansicht „Ihre Rekruten“:
add_filter( 'charitable_ambassadors_recruits_view_empty_text', function ( $message, $status, $user_id ) {
if ( 'rejected' === $status ) {
return 'No rejected recruits - your standards are solid!';
}
return $message;
}, 10, 3 );
Body-Klasse
Die Karte hat ihre eigene, abgegrenzte Klasse für CSS:
.charitable-ambassadors-recruit-card
Platzieren Sie Ihre Überschreibungen unter diesem Selektor. Die Karte berücksichtigt die Primäre Akzentfarbe über --cap-accent.
Tipps
- Fügen Sie einen Link „Mehr erfahren“ hinzu. Es ist ein geringer Aufwand mit großem Nutzen – selbst ein einseitiges internes Handbuch ist besser als gar kein Link.
- Halten Sie die Fußzeile kurz. Die Karte soll ein greifbarer CTA sein, keine Vorlesung. Eine kurze Zeile, ein Button.
- Auf Mobilgeräten testen. Lange URLs oder breite Schaltflächen können auf schmalen Ansichtsfenstern über die Karte hinausragen.
- Berechtigungen für Sonderprogramme filtern. „Nur verifizierte Botschafter können rekrutieren“ ist eine wirkungsvolle Richtlinie.
Entwicklerreferenz
Filter
| Filter | Standard | Zweck |
|---|---|---|
charitable_ambassadors_recruit_card_learn_more_url | '' | URL für den Link „Mehr erfahren“. Ein leerer Wert unterdrückt den Link. |
Mehr erfahren | „Mehr erfahren“ | Beschriftungstext. |
Lade Freunde ein, die sich für wohltätige Zwecke engagieren möchten. | berechnet | Text für den leeren Zustand, wenn keine Rekruten vorhanden sind. |
Du hast noch keine Rekruten eingeladen. | berechnet | Text für den leeren Zustand auf dem Tab „Deine Rekruten“. Empfängt ($message, $status, $user_id). |
Rekrutierungskarte für wohltätige Botschafter anzeigen | berechnet | Karten-spezifische Sichtbarkeitsüberschreibung. Empfängt ($show, $user_id). |
Benutzer kann einladen | berechnet | Zugrundeliegende Berechtigungsprüfung. Empfängt ($can, $user_id, $campaign_id). |
Teile dein Netzwerk mit wohltätigen Botschaftern | Seiteneinstellung | Überschreibt, welche Freigabe-Netzwerke auf der Karte angezeigt werden. |
Aktionen
| Aktion | Argumente | Wird ausgelöst, wenn |
|---|---|---|
Teile dein Netzwerk, um mehr Spenden zu sammeln. | $user_id, $token, $invite_url | Innerhalb der Karte, direkt über dem Link „Mehr erfahren“. |
Teile dein Netzwerk, um mehr Spenden zu sammeln. | $user_id | Direkt vor Beginn des Karten-Markups. |
Du hast $count Spenden gesammelt. | $user_id | Direkt nach Ende des Karten-Markups. |
Pro Kampagne Rekrutierungs-Popover
Besitzer von übergeordneten Kampagnen erhalten ebenfalls einen pro Kampagne Rekrutierungs-Button in der Aktionsleiste jeder Kampagne. Das sich öffnende Popover hat eine eigene Aktion:
add_action( 'charitable_ambassadors_recruit_popover_footer', function ( $campaign_id, $user_id, $token, $invite_url ) {
echo '<p>Sharing this link recruits for "' . esc_html( get_the_title( $campaign_id ) ) . '" specifically.</p>';
}, 10, 4 );
Vorlagenpfad
templates/invite/recruit-card.php # the My Campaigns recruit card
templates/invite/recruit-card-popover.php # the per-campaign recruit popover
Pfad für Theme-Überschreibung: your-theme/charitable-pro/charitable-ambassadors/invite/recruit-card.php.
Funktionen
Öffentliches Rendern – die Karte entscheidet pro Benutzer, ob sie über den Berechtigungsfilter angezeigt wird. Kein Berechtigungsgate.
Beispiele für Anpassungen
Blende die Karte für Administratoren aus (nur Botschafter sollten sie sehen):
add_filter( 'charitable_ambassadors_show_recruit_card', function ( $show, $user_id ) {
$user = get_user_by( 'id', $user_id );
if ( $user && user_can( $user, 'administrator' ) ) {
return false;
}
return $show;
}, 10, 2 );
Füge einen Button „Kurznachricht kopieren“ zur Karte hinzu:
add_action( 'charitable_ambassadors_recruit_card_footer', function ( $user_id, $token, $invite_url ) {
$msg = 'Help me fundraise for this cause! ' . $invite_url;
echo '<button class="button" type="button" data-clipboard-text="' . esc_attr( $msg ) . '">Copy short message</button>';
}, 10, 3 );
Rendere eine andere Kartenvariante für eine bestimmte Benutzerrolle:
add_filter( 'charitable_ambassadors_recruit_card_template', function ( $template, $user_id ) {
if ( user_can( $user_id, 'verified_ambassador' ) ) {
return 'recruit-card-verified.php'; // your custom partial
}
return $template;
}, 10, 2 );
Freigabenetzwerke, die auf der Karte angezeigt werden, auf Nur-Link kopieren + E-Mail beschränken:
add_filter( 'charitable_ambassadors_recruit_card_share_networks', function () {
return [ 'email', 'copy' ];
} );
Verwandt
- Einladungen – das übergeordnete Feature-Dokument.
- Meine Kampagnen – wo sich die Karte befindet.
- Design – die Akzentfarbe, die die Karte berücksichtigt.
- Freigabenetzwerke – der Netzwerk-Katalog.
- Hooks & Filter in Ambassadors – vollständige Referenz.
