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 |
|---|---|
| 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. |
| Réseaux professionnels, d'entreprise, d'anciens élèves. Idéal pour les collectes de fonds de style gala et d'entreprise. | |
| 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. |
| Massif en EMEA, LATAM, Inde, Asie du Sud-Est. Souvent le meilleur partage mobile au niveau mondial. | |
| Idéal lorsque les campagnes ont une forte image principale (gala, ventes aux enchères d'art scolaire). | |
| 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.
Liens utiles
🤝 Obtenez de l’aide quand vous en avez besoin
📑 Trouvez le guide dont vous avez besoin
Parcourez le centre de documentation →
⬇️ Téléchargez des stratégies éprouvées, des idées de campagnes et des outils d'experts
Obtenir le kit de collecte de fonds →
🔗 Laissez votre assistant IA faire le travail de collecte de fonds pour vous.
Connect Charitable à votre assistant IA →
💸 Obtenez des ressources gratuites pour la collecte de fonds
Rendez-vous sur le Hub de collecte de fonds Charitable →
🤔 Des questions sur Charitable ?
FAQ Charitable →
Besoin d'aide pour comprendre les termes et le jargon des organisations à but non lucratif ?
Consultez notre glossaire des organisations à but non lucratif→
