Erfordert: Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Jede Botschafter-Spendenaktionsseite verfügt über ein Share-Popover – eine Reihe von sozialen Symbolen, auf die Ihre Unterstützer tippen, um die Spendenaktion in ihrem Netzwerk zu teilen. Sharing Networks ist dort, wo Sie auswählen, welche Netzwerke in diesem Popover angezeigt werden und in welcher Reihenfolge. Zehn Netzwerke sind bei Ambassadors enthalten, und Sie können jede Kombination davon mit einem einzigen Klick aktivieren.

Es ist eine kleine Einstellung, die aber viel bewirkt. Die richtige Netzwerkmischung – die, die Ihre Zielgruppe tatsächlich nutzt – bedeutet mehr Shares, was mehr Aufmerksamkeit für die Spendenaktion bedeutet, was mehr Spenden bedeutet.

Wann Sie es verwenden würden

• Ersteinrichtung – aktivieren Sie die vier oder fünf Netzwerke, die Ihnen wichtig sind; deaktivieren Sie den Rest.
• Anpassung an Ihre Zielgruppe – internationales Publikum? Aktivieren Sie WhatsApp (weltweit riesig) und Threads. K-12 / Eltern? Behalten Sie E-Mail und Facebook im Vordergrund.
• Abgleich mit Markenrichtlinien – einige Organisationen möchten nicht, dass ihre Spendenaktionen auf Reddit oder X geteilt werden. Deaktivieren Sie sie.

Wo Sie ihn finden

Gehen Sie zu Ihrem WordPress-Adminbereich, öffnen Sie Charitable » Ambassadors » Sharing

Es ist die einzige Einstellung auf dem Unter-Tab „Sharing“. (Der Unter-Tab teilte sich früher den Platz mit anderen sozialen Einstellungen; er wurde in Version 3.0 zur besseren Übersichtlichkeit aufgeteilt.)

Die zehn Netzwerke

Netzwerk	Am besten für
Facebook	Der Klassiker – immer noch das Netzwerk mit dem höchsten Anteil an Shares in den meisten US-basierten Programmen.
X (ehemals Twitter)	Erreicht ein Publikum aus Journalisten und Aktivisten. Gut für kampagnengetriebene Kampagnen.
LinkedIn	Professionelle, unternehmensbezogene, Alumni-Netzwerke. Am besten für Gala- und Unternehmensspendenaktionen.
E-Mail	Immer verfügbar, universell. Öffnet das E-Mail-Programm des Benutzers mit vorausgefülltem Text.
Link kopieren	„Gib mir einfach die URL.“ Das meistgeklickte Feld in mobil-orientierten Programmen.
WhatsApp	Massiv in EMEA, LATAM, Indien, Südostasien. Oft die beste mobile Share-Option weltweit.
Pinterest	Am besten, wenn Spendenaktionen starke Hauptbilder haben (Gala, Schul-Kunstauktionen).
Reddit	Nützlich für kampagnengetriebene Kampagnen mit subredditspezifischen Communities.
Bluesky	Wachsende Alternative zu X; gut für technikaffine / progressive Zielgruppen.
Threads	Metas textbasiertes Netzwerk; wachsende Reichweite.

Jedes Netzwerk erhält einen klickbaren Chip im Einstellungsraster. Klicken Sie zum Umschalten; das Raster aktualisiert sich sofort. Die Reihenfolge, in der Sie sie anklicken, bestimmt die Reihenfolge, in der sie im Popover erscheinen.

Wie das Popover die Auswahl verwendet

Auf jeder Spendenaktionsseite (und der „Meine Kampagnen“-Rekrutierungskarte, falls aktiviert) rendert das Share-Popover ein Symbol pro aktiviertem Netzwerk.

Jedes Symbol öffnet entweder eine native Share-Intent (Facebook's share-link URL, X's tweet intent, WhatsApp's send-text deep link) oder kopiert bei Link kopieren die Spendenaktions-URL mit einem Bestätigungs-Tooltip in die Zwischenablage.

Wenn Sie QR-Codes für die Spendenaktion-Seite aktivieren (unter Spendenaktion-Seite Einstellungen), erscheint ein QR-Kachel neben den sozialen Symbolen – es öffnet sich ein Modal mit einem herunterladbaren PNG.

Individuelle Überschreibungen pro Spendenaktion

Die Auswahl der sozialen Netzwerke ist standardmäßig seitenweit – jede Spendenaktion verwendet die gleiche Auswahl. Um dies pro Kampagne zu überschreiben (z. B. eine Firmenveranstaltung, die nur LinkedIn + E-Mail anzeigen sollte), verwenden Sie den Filter charitable_ambassadors_share_networks_for_campaign:

add_filter( 'charitable_ambassadors_share_networks_for_campaign', function ( $networks, $campaign_id ) {
    if ( has_term( 'corporate', 'campaign_category', $campaign_id ) ) {
        return [ 'linkedin', 'email' ];
    }
    return $networks;
}, 10, 2 );

Empfohlene Startmischungen

Zielgruppe	Vorgeschlagene Netzwerke
Allgemeiner US / EU-Verbraucher	Facebook, X, WhatsApp, E-Mail, Link kopieren
International / Mobile-First	WhatsApp, Facebook, Threads, E-Mail, Link kopieren
Unternehmen / B2B / Alumni	LinkedIn, X, E-Mail, Link kopieren
Anliegen-getrieben / Aktivist	X, Bluesky, Reddit, E-Mail, Link kopieren
Visuell-orientiert / Veranstaltungen	Facebook, Pinterest, Instagram (via Threads), E-Mail, Link kopieren

Im Zweifelsfall beginnen Sie mit Facebook, X, WhatsApp, E-Mail, Link kopieren – die fünf, die für die breiteste Zielgruppe funktionieren.

Tipps

• Weniger ist mehr. Fünf aktivierte Netzwerke wirken gut kuratiert. Zehn wirkt überwältigend und reduziert Klicks.
• Behalten Sie „Link kopieren“ immer bei. Es ist die Option mit der geringsten Hürde – der Benutzer wählt selbst, wohin er ihn einfügt.
• Fügen Sie WhatsApp hinzu, wenn Sie ein internationales Publikum haben. Es übertrifft Facebook und Twitter in vielen Ländern.
• Überprüfen Sie Ihren Teilen-Button auf Mobilgeräten. Die native Teilen-Funktion auf Mobilgeräten ist unter iOS anders als unter Android; das Popover behandelt beide, aber überprüfen Sie, ob die Kacheln bei schmalen Breiten gut aussehen.

---

Entwicklerreferenz

Der Rest dieser Seite ist für Entwickler, die Teilen-Netzwerke anpassen.

Speicher für Einstellungen

charitable_settings > ambassadors_share_networks  # array of enabled slugs, e.g. ['facebook','x','whatsapp','email','copy']

Diese Option befindet sich auf der obersten Ebene von charitable_settings, nicht unter dem Unter-Array ambassadors. Achten Sie darauf, wenn Sie über Filter lesen.

Lesen mit:

$enabled = charitable_get_option( 'ambassadors_share_networks', [ 'facebook', 'x', 'email', 'copy' ] );

Netzwerkkatalog

Der 10-Netzwerk-Katalog befindet sich in Charitable_Ambassadors_Settings::get_share_networks_catalog(). Jeder Eintrag hat:

'<slug>' => [
    'label' => 'Display name',
    'color' => 'Brand hex',
    'icon'  => 'inline SVG markup',
],

Filtern Sie über charitable_ambassadors_share_networks_catalog, um benutzerdefinierte Netzwerke hinzuzufügen oder Symbole zu ersetzen:

add_filter( 'charitable_ambassadors_share_networks_catalog', function ( $catalog ) {
    $catalog['mastodon'] = [
        'label' => 'Mastodon',
        'color' => '#6364ff',
        'icon'  => '<svg ...>...</svg>',
    ];
    return $catalog;
} );

Sie müssen dem Popover-Renderer auch beibringen, wie die Teilen-URL für ein benutzerdefiniertes Netzwerk erstellt wird – verwenden Sie den Hook charitable_ambassadors_share_url_for_network:

add_filter( 'charitable_ambassadors_share_url_for_network', function ( $url, $slug, $fundraiser_id ) {
    if ( 'mastodon' === $slug ) {
        $title = wp_strip_all_tags( get_the_title( $fundraiser_id ) );
        return 'https://mastodon.social/share?text=' . rawurlencode( $title . ' ' . get_permalink( $fundraiser_id ) );
    }
    return $url;
}, 10, 3 );

Filter

Filter	Standard	Zweck
Wohltätigkeitsbotschafter teilen Netzwerkkatalog	Array von 10	Netzwerke im Katalog hinzufügen/entfernen/ändern.
Wohltätigkeitsbotschafter teilen Netzwerke für Kampagne	Seiteneinstellung	Überschreibe die aktivierte Liste pro Kampagne. Empfängt ($networks, $campaign_id).
Wohltätigkeitsbotschafter teilen URL für Netzwerk	berechnet	Erstelle die Share-URL für ein bestimmtes Netzwerk + Spendenaktion. Empfängt ($url, $slug, $fundraiser_id).
Wohltätigkeitsbotschafter teilen Popover-Position	'unten'	Position des Share-Popovers relativ zum Trigger-Button.
Wohltätigkeitsbotschafter teilen Netzwerke-Dokumentations-URL	diese Seite	Überschreibe die Doku-URL, auf die der Inline-Link „Was wird geteilt“ verweist.

Aktionen

Aktion	Argumente	Wird ausgelöst, wenn
Wohltätigkeitsbotschafter teilen Popover davor	$campaign_id	Kurz bevor das Share-Popover gerendert wird.
Wohltätigkeitsbotschafter teilen Popover danach	$campaign_id	Kurz nach dem Share-Popover.

Funktionen

Zugriff auf Einstellungen: manage_charitable_settings. Das Rendern im Frontend hat kein Berechtigungstor.

Anpassungsbeispiele

Beschränke auf LinkedIn + E-Mail für eine bestimmte Kategorie von Kampagnen:

add_filter( 'charitable_ambassadors_share_networks_for_campaign', function ( $networks, $campaign_id ) {
    if ( has_term( 'corporate', 'campaign_category', $campaign_id ) ) {
        return [ 'linkedin', 'email' ];
    }
    return $networks;
}, 10, 2 );

Füge ein Telegram-Netzwerk hinzu:

add_filter( 'charitable_ambassadors_share_networks_catalog', function ( $catalog ) {
    $catalog['telegram'] = [
        'label' => 'Telegram',
        'color' => '#0088cc',
        'icon'  => file_get_contents( __DIR__ . '/telegram.svg' ),
    ];
    return $catalog;
} );

add_filter( 'charitable_ambassadors_share_url_for_network', function ( $url, $slug, $fundraiser_id ) {
    if ( 'telegram' === $slug ) {
        return 'https://t.me/share/url?url=' . rawurlencode( get_permalink( $fundraiser_id ) );
    }
    return $url;
}, 10, 3 );

Verberge das Share-Popover für eine einzelne Spendenaktion vollständig:

add_filter( 'charitable_ambassadors_fundraiser_show_share', function ( $show ) {
    if ( is_singular( 'campaign' ) && (int) get_the_ID() === 123 ) {
        return false;
    }
    return $show;
} );

Verwende eine benutzerdefinierte, mit UTM-Tags versehene Share-URL für Analysen:

add_filter( 'charitable_ambassadors_share_url_for_network', function ( $url, $slug, $fundraiser_id ) {
    $base = add_query_arg( [ 'utm_source' => $slug, 'utm_medium' => 'share', 'utm_campaign' => 'p2p' ], get_permalink( $fundraiser_id ) );
    return str_replace( get_permalink( $fundraiser_id ), $base, $url );
}, 20, 3 );

Verwandt

• Spendenaktion-Seite – der Hauptschalter, ob das Popover überhaupt angezeigt wird.
• QR-Codes – die QR-Kachel im Share-Popover.
• Hooks & Filter in Ambassadors – vollständige Referenz.