Requis : Charitable Pro 1.8.16+
Charitable Ambassadors 3.0.0+

Chaque page de campagne d'ambassadeur dispose d'une fenêtre contextuelle de partage – une rangée d'icônes sociales que vos supporters peuvent toucher pour partager la campagne avec leur réseau. Réseaux de partage est l'endroit où vous choisissez quels réseaux apparaissent dans cette fenêtre contextuelle, et dans quel ordre. Dix réseaux sont livrés avec Ambassadeurs, et vous pouvez en activer n'importe quelle combinaison en un seul clic.

C'est un petit paramètre qui a un grand impact. Le bon mélange de réseaux – ceux que votre public utilise réellement – signifie plus de partages, ce qui signifie plus de visibilité pour la campagne, ce qui signifie plus de dons.

Quand l'utiliser

• Configuration initiale – activez les quatre ou cinq réseaux qui vous intéressent ; désactivez les autres.
• Adaptation à votre public – public international ? Activez WhatsApp (très utilisé mondialement) et Threads. K-12 / parents ? Gardez Email et Facebook au premier plan.
• Alignement avec les directives de la marque – certaines organisations ne veulent pas que leurs campagnes soient partagées sur Reddit ou X. Désactivez-les.

Où le trouver

Accédez à votre administration WordPress, ouvrez Charitable » Ambassadeurs » Partage

C'est le seul paramètre de l'onglet secondaire Partage. (L'onglet secondaire partageait auparavant l'espace avec d'autres paramètres sociaux ; il a été séparé dans la version 3.0 pour plus de clarté.)

Les Dix Réseaux

Réseau	Idéal pour
Facebook	Le classique – toujours le réseau de partage le plus utilisé dans la plupart des programmes basés aux États-Unis.
X (anciennement Twitter)	Atteint un public de journalistes et d'activistes. Bon pour les campagnes axées sur une cause.
LinkedIn	Réseaux professionnels, d'entreprise, d'anciens élèves. Idéal pour les collectes de fonds de style gala et d'entreprise.
E-mail	Universel et toujours actif. Ouvre le client de messagerie de l'utilisateur avec le champ pré-rempli.
Copier le lien	« Donnez-moi juste l'URL. » Le bouton le plus cliqué dans les programmes axés sur le mobile.
WhatsApp	Massif en EMEA, LATAM, Inde, Asie du Sud-Est. Souvent le meilleur partage mobile au niveau mondial.
Pinterest	Idéal lorsque les campagnes ont une forte image principale (gala, ventes aux enchères d'art scolaire).
Reddit	Utile pour les campagnes axées sur une cause avec des sous-communautés spécifiques.
Bluesky	Alternative croissante à X ; bon à inclure pour les publics technophiles / progressistes.
Threads	Le réseau de Meta axé sur le texte ; public en croissance.

Chaque réseau est représenté par une puce cliquable dans la grille des paramètres. Cliquez pour basculer ; la grille se met à jour immédiatement. L'ordre dans lequel vous cliquez détermine l'ordre d'apparition dans la fenêtre contextuelle.

Comment la fenêtre contextuelle utilise les sélections

Sur chaque page de campagne (et sur la carte de recrutement Mes Campagnes, si activée), la fenêtre contextuelle de partage affiche une icône par réseau activé.

Chaque icône ouvre soit une intention de partage native (URL de partage Facebook, intention de tweet X, lien profond d'envoi de texte WhatsApp), soit, pour Copier le lien, copie l'URL de la campagne dans le presse-papiers avec une info-bulle de confirmation.

Si vous activez les codes QR pour la page de collecte de fonds (sous les paramètres de la page de collecte de fonds), une vignette QR apparaît à côté des icônes sociales – elle ouvre une modale avec un PNG téléchargeable.

Remplacements par campagne

Les sélections des réseaux de partage sont globales par défaut – chaque collecte de fonds utilise le même ensemble. Pour remplacer au cas par cas (par exemple, un gala d'entreprise qui ne devrait afficher que LinkedIn + Email), utilisez le filtre 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 );

Mélanges de départ recommandés

Public	Réseaux suggérés
Consommateur général US / UE	Facebook, X, WhatsApp, Email, Copier le lien
International / mobile d'abord	WhatsApp, Facebook, Threads, Email, Copier le lien
Entreprise / B2B / anciens élèves	LinkedIn, X, Email, Copier le lien
Orienté cause / militant	X, Bluesky, Reddit, Email, Copier le lien
Visuel / événements	Facebook, Pinterest, Instagram (via Threads), Email, Copier le lien

En cas de doute, commencez par Facebook, X, WhatsApp, Email, Copier le lien – les cinq qui fonctionnent pour le plus large public.

Conseils

• Moins, c'est plus. Cinq réseaux activés semblent bien organisés. Dix semblent écrasants et réduisent les clics.
• Gardez toujours Copier le lien activé. C'est l'option la moins contraignante – l'utilisateur choisit lui-même où le coller.
• Ajoutez WhatsApp si vous avez un public international. Il éclipse Facebook et Twitter dans de nombreux pays.
• Vérifiez votre bouton de partage sur mobile. Le partage natif mobile est un flux différent sur iOS que sur Android ; la fenêtre contextuelle gère les deux, mais vérifiez que les vignettes ont l'air correctes dans les largeurs étroites.

---

Référence développeur

Le reste de cette page est destiné aux développeurs qui personnalisent les réseaux de partage.

Stockage des paramètres

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

Cette option se trouve au plus haut niveau de charitable_settings, pas dans le sous-tableau ambassadors. Faites attention à cela lorsque vous lisez via des filtres.

Lire avec :

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

Catalogue de réseaux

Le catalogue de 10 réseaux se trouve dans Charitable_Ambassadors_Settings::get_share_networks_catalog(). Chaque entrée contient :

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

Filtrez via charitable_ambassadors_share_networks_catalog pour ajouter des réseaux personnalisés ou remplacer des icônes :

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

Vous devrez également apprendre au moteur de rendu de la fenêtre contextuelle à construire l'URL de partage pour un réseau personnalisé – accrochez 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 );

Filtres

Filtre	Défaut	Objectif
ambassadeurs_caritatifs_partager_catalogues_réseaux	tableau de 10	Ajouter/supprimer/modifier des réseaux dans le catalogue.
ambassadeurs_caritatifs_partager_réseaux_pour_campagne	paramètre du site	Outrepasser la liste activée par campagne. Reçoit ($networks, $campaign_id).
ambassadeurs_caritatifs_partager_url_réseau	calculé	Construire l'URL de partage pour un réseau + une collecte de fonds spécifique. Reçoit ($url, $slug, $fundraiser_id).
ambassadeurs_caritatifs_partager_position_popover	'bas'	Position du pop-up de partage par rapport au bouton déclencheur.
ambassadeurs_caritatifs_partager_docs_url_réseaux	cette page	Outrepasser l'URL de la documentation vers laquelle le lien intégré « Qu'est-ce qui est partagé » pointe.

Actions

Action	Args	Se déclenche lorsque
ambassadeurs_caritatifs_partager_popover_avant	$campaign_id	Juste avant que le pop-up de partage ne s'affiche.
ambassadeurs_caritatifs_partager_popover_après	$campaign_id	Juste après le pop-up de partage.

Capacités

Accès aux paramètres : manage_charitable_settings. Le rendu côté client n'a pas de porte de capacité.

Exemples de personnalisation

Restreindre à LinkedIn + Email pour une catégorie spécifique de campagne :

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 );

Ajouter un réseau Telegram :

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 );

Masquer entièrement le pop-up de partage sur une seule collecte de fonds :

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

Utiliser une URL de partage personnalisée avec des balises UTM pour l'analyse :

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 );

Connexes

• Page de collecte de fonds – le commutateur principal pour savoir si le pop-up s'affiche ou non.
• Codes QR – la vignette QR dans le pop-up de partage.
• Hooks & filtres dans Ambassadors – référence complète.