Charitable Ambassadors 3.0 n'est pas seulement une mise à jour. C'est une réinvention. C'est la plus grande version que le module complémentaire ait jamais connue, avec une refonte complète de l'expérience d'administration et huit nouvelles fonctionnalités puissantes basées sur des années de commentaires réels des clients.

Considérez cette page comme votre visite guidée rapide. Chaque fonctionnalité est accompagnée d'un lien direct vers sa documentation, afin que vous puissiez approfondir autant que nécessaire, quand vous le souhaitez.

Mise à niveau depuis la version 2.x ? Ne sautez pas le guide de migration de la version 2.x vers la 3.0. C'est votre compagnon essentiel pour une transition en douceur.

Remarque : Ambassadors 3.0 nécessite Charitable Pro 1.8.16+

Les changements majeurs

Ambassadors 3.0 touche presque tous les aspects du module complémentaire. Voici un aperçu rapide de ce qui a changé et pourquoi c'est important :

Administration et Navigation

Changement	Pourquoi c'est important
L'administration déplacée des Paramètres	Ambassadors est maintenant son propre menu de premier niveau (Charitable » Ambassadors), plus rapide d'accès, plus facile à naviguer.
Tableau de bord de présentation	Un hub central pour la santé du programme en un coup d'œil, avec des indicateurs clés de performance, un graphique principal et les meilleurs performeurs.
Assistant de configuration	Trois chemins pour commencer (Assistant, Modèles ou Démarrage rapide) afin que les nouvelles installations soient prêtes pour le programme en quelques minutes.

Gestion des collectes de fonds

Changement	Pourquoi c'est important
File d'attente de modération	Un flux de travail dédié pour examiner les soumissions de collectes de fonds : approuver, rejeter ou demander des modifications, avec un filet de sécurité d'annulation de 30 secondes.
Annuaire	Une liste consultable de chaque ambassadeur, avec des pages de profil, la vérification, l'envoi d'e-mails, la visualisation en tant que et l'exportation CSV.
Invitations	Un système de recrutement par lien d'invitation personnel en option avec suivi d'attribution, un shortcode de page de destination et un widget de recrutement sur le tableau de bord de présentation.

Conception et affichage

Changement	Pourquoi c'est important
8 variantes de mise en page + slot personnalisé	Les pages de collecte de fonds peuvent être rendues dans huit mises en page intégrées ; les remplacements de thème apparaissent dans un slot personnalisé dédié.
Mode modèle visuel	Concevez une campagne dans le constructeur visuel et toutes les collectes de fonds en hériteront automatiquement.
Widget d'intégration	Un petit extrait de code HTML que les ambassadeurs peuvent coller sur n'importe quel site externe pour afficher la progression de leur collecte de fonds et un bouton de don.

Notifications et communication

Changement	Pourquoi c'est important
Notifications locales	Quatre notifications par icône de cloche se déclenchent à des moments clés : état de la file d'attente de modération, première collecte de fonds par parent, objectif atteint et étapes de niveau total collecté.
Bannière de santé par e-mail	Capture le cas où un e-mail transactionnel qui devrait être activé a été accidentellement désactivé.
Grille de puces de réseaux de partage	10 réseaux de partage, activés ou désactivés en un seul clic.

Données et utilitaires

Changement	Pourquoi c'est important
Exportations CSV partout	Exportations CSV sécurisées contre l'injection de formules disponibles sur les pages Aperçu, Modération, Répertoire, Invitations et profils individuels.
Codes QR par surface	La génération de codes QR est maintenant divisée en bascules par surface : page de collecte de fonds, fenêtre contextuelle de partage et ligne de mes campagnes.

Où vit chaque nouvelle fonctionnalité

📊 Tableau de bord d'aperçu

Charitable » Ambassadeurs » Aperçu

Le centre de commande de votre programme. Le tableau de bord Aperçu rassemble tout ce qui est important en un seul endroit : tuiles d'indicateurs clés de performance, graphique principal suivant les dons au fil du temps, meilleurs collecteurs de fonds, ambassadeurs et parents, un widget de recrutement, un flux de dons récents, un avis de bienvenue et une tuile d'approbations en attente. Si vous avez déjà dû fouiller dans les rapports juste pour répondre à une question de base sur la santé de votre programme, cet écran a été conçu pour vous.

En savoir plus sur l'aperçu

✅ Modération

Charitable » Ambassadeurs » Modération

Un flux de travail dédié conçu pour maintenir votre programme propre et en mouvement. Quatre vues (En attente / Action requise / Rejeté / Approuvé) vous permettent de trier en un coup d'œil. Les actions en ligne et en masse maintiennent la rapidité, une annulation en 30 secondes vous évite des erreurs coûteuses, et un journal d'audit par collecte de fonds, ajout uniquement, conserve une piste d'audit complète. Introduit le nouveau statut de publication charitable-rejected.

En savoir plus sur la modération | Plongée dans les actions de modération

📋 Répertoire

Charitable » Ambassadeurs » Répertoire

Une liste consultable et filtrable de tous les ambassadeurs de votre programme. Quatre sous-vues (Tous / Vérifiés / Non vérifiés / Inactifs) facilitent la recherche de la personne que vous recherchez. Chaque ambassadeur a une page de profil dédiée avec quatre onglets, plus des actions pour vérifier/annuler la vérification, envoyer un e-mail, afficher en tant que, ajouter un ambassadeur, et supprimer en masse et anonymiser. Si vous connaissez la zone donateur de Charitable, vous vous sentirez immédiatement à l'aise.

En savoir plus sur le répertoire | Plongée dans les onglets de profil

💌 Invitations

Charitable » Ambassadeurs » Invitations

Un système de lien d'invitation personnel opt-in qui transforme vos meilleurs ambassadeurs en recruteurs. Chaque personne reçoit son propre lien unique à partager, et toute personne qui s'inscrit via ce lien lui est attribuée. Gérez tout depuis un seul endroit : qui peut recruter, la page de destination, l'image de repli, et plus encore. Les bannières d'auto-vérification signalent les problèmes de configuration avant qu'ils ne deviennent des problèmes, et une option de désinstallation propre vous permet de supprimer complètement la fonctionnalité si vous en avez besoin.

En savoir plus sur les invitations | Comment fonctionne l'attribution | Stockage / table personnalisée | Shortcode de la page de destination | Personnalisation de la carte de recrutement

🧙 Assistant de configuration

Charitable » Ambassadeurs » Général » Actions de configuration » Ouvrir la configuration

Trois chemins pour lancer votre programme, aussi rapidement que vous le souhaitez. Suivez l'assistant guidé complet en 10 étapes, choisissez l'un des six modèles de scénarios prédéfinis (Marathon, Mémorial, Gala, École, Anniversaire, Personnalisé), ou lancez le Démarrage rapide pour des paramètres par défaut judicieux en un clic. Quel que soit le chemin choisi, l'assistant crée automatiquement vos pages de campagne de soumission et mes campagnes, et éventuellement une campagne de démarrage pour que vous ayez quelque chose à utiliser immédiatement.

En savoir plus sur l'assistant de configuration

🎨 Modèles, Mode Modèle Visuel & 8 variantes de mise en page

Charitable » Ambassadeurs » Modèles

C'est la fonctionnalité phare de la version 3.0. Un onglet Modèles repensé vous donne un contrôle total sur l'apparence des pages de collecte de fonds sur l'ensemble de votre site. Choisissez votre style de modèle frontal (Hérité, Amélioré ou Visuel), sélectionnez parmi huit variantes de mise en page en mode Amélioré, utilisez l'autocomplétion de modèle-campagne en mode Visuel pour cloner une conception que vous avez déjà créée, et ajustez votre couleur d'accentuation principale et le style de carte. Chaque page de collecte de fonds hérite automatiquement de vos choix, sans nécessiter de CSS personnalisé.

Orientation des modèles | Plongée dans les variantes de mise en page | Mode Modèle Visuel | Thèmes

🗂️ Mes Campagnes

Charitable » Ambassadeurs » Mes Campagnes

Paramètres de la page publique /mes-campagnes/, avec un aperçu en direct pour voir les modifications en temps réel. Activez ou désactivez la recherche, le tri, la miniature, la barre de progression, le partage et le QR code. Définissez un ordre de tri par défaut. Les paramètres du rapport de dons du créateur de campagne se trouvent également ici, donnant aux ambassadeurs la possibilité d'exporter leurs propres données de donateurs lorsque vous l'autorisez.

En savoir plus sur Mes Campagnes

📄 Page de collecte de fonds

Charitable » Ambassadeurs » Page de collecte de fonds

Contrôle granulaire de chaque page de collecte de fonds sur votre site. Configurez votre variante de mise en page, le fil d'Ariane, la fenêtre contextuelle de partage, les commentaires, les codes QR par surface, la position du mur des donateurs, le substitut d'image principale et le thème propre Chrome, le tout en un seul endroit. Les modifications apportées ici s'appliquent globalement à chaque collecte de fonds d'ambassadeur, vous le configurez une fois et cela fonctionne.

En savoir plus sur la Page de collecte de fonds

🃏 Soumettre une campagne : Étape 1 de la grille de cartes

Frontal : /soumettre-campagne/

L'étape 1 du formulaire de soumission reçoit une mise à niveau majeure. L'ancien menu déroulant de sélection est remplacé par un sélecteur de destinataire intuitif en grille de cartes (Individu / Équipe / Membre d'équipe) qui rend le choix évident en un coup d'œil. Le sélecteur de parent de l'étape 2 est maintenant piloté par AJAX, avec des logos de campagne et des barres de progression. Vous pouvez également lier directement à un type de destinataire spécifique ou à une campagne parente via les arguments d'URL cap_recipient et cap_campaign.

En savoir plus sur Soumettre une campagne

🔗 Réseaux de partage

Charitable » Ambassadeurs » Partage

Dix réseaux de partage (Facebook, X, LinkedIn, Email, Copier le lien, WhatsApp, Pinterest, Reddit, Bluesky et Threads) s'affichent sous forme d'une grille de puces claires à basculer. Seuls les réseaux que vous activez apparaîtront dans la fenêtre contextuelle de partage sur chaque page de collecte de fonds, gardant l'expérience propre et pertinente pour votre public.

En savoir plus sur les réseaux de partage

🧩 Widget d'intégration

Charitable » Ambassadeurs » Divers » Widget d'intégration

Désactivé par défaut. Activez-le pour ajouter une vignette Widget d'intégration aux fenêtres contextuelles de partage de collecte de fonds, donnant à chaque ambassadeur un petit extrait HTML qu'il peut coller sur n'importe quel site externe : son blog personnel, une intranet d'entreprise, n'importe où. Le widget affiche la barre de progression en direct et le bouton de don de sa collecte de fonds, en extrayant les données directement de votre site. Aucune connexion requise pour les visiteurs.

En savoir plus sur le widget d'intégration

📱 Codes QR

Charitable » Ambassadeurs » Divers » Codes QR (bascule principale)
Charitable » Ambassadeurs » Page de collecte de fonds » Afficher le code QR sur la page de collecte de fonds (par surface)
Charitable » Ambassadeurs » Mes campagnes » Afficher le code QR (par surface)

Codes QR par collecte de fonds, générés côté client et téléchargeables en PNG. L'ancien interrupteur principal unique a été remplacé par des bascules par surface, vous donnant un contrôle granulaire sur l'endroit exact où les codes QR apparaissent : sur la page de collecte de fonds, dans la fenêtre contextuelle de partage, ou sur la ligne du tableau de bord Mes campagnes.

En savoir plus sur les codes QR

🔔 Notifications

Quatre événements déclenchent désormais le panneau de notification avec icône de cloche Pro, couvrant les moments les plus importants pour quiconque gère un programme de pair à pair :

• Santé de la file d'attente de modération : restez informé des soumissions en attente avant qu'elles ne s'accumulent
• Première collecte de fonds par parent : sachez au moment où une campagne obtient sa première collecte de fonds active
• Objectif atteint : célébrez l'étape automatiquement
• Niveaux de montant total collecté : soyez informé à 1 000 $, 5 000 $, 10 000 $, 25 000 $, 50 000 $, 100 000 $, 250 000 $, 500 000 $ et 1 M $

Les filtres de suppression par événement vous permettent de régler le bruit, et un interrupteur principal désactive tout lorsque nécessaire.

En savoir plus sur les notifications

🏥 Bannière de santé des e-mails

Charitable » Ambassadeurs » Aperçu (bannière avec bordure orange)

Dix règles s'exécutent silencieusement en arrière-plan, vérifiant que vos e-mails transactionnels critiques sont activés lorsqu'ils devraient l'être. Si quelque chose est mal configuré, la bannière le signale avec une correction d'activation en un clic, vous évitant ainsi de devoir fouiller dans les paramètres pour comprendre pourquoi les ambassadeurs ne reçoivent pas d'e-mails.

En savoir plus sur la santé des e-mails

📥 Exportations CSV

Les exportations CSV sécurisées contre l'injection de formules sont désormais disponibles partout : Aperçu (six sections), Modération, Annuaire (liste et niveau de profil), et Invitations (activité récente et meilleurs recruteurs). Toutes les exportations sont limitées à 10 000 lignes par défaut et entièrement filtrables, donc que vous fassiez un rapport à un conseil d'administration ou que vous importiez dans un CRM, les données sont prêtes à l'emploi.

Dictionnaire des colonnes CSV

---

Outils et diagnostics

Surface	Nouveau dans la version 3.0
Outils Charitable » Informations sur le site » Bloc Ambassadeurs	Vidage complet des diagnostics : versions, paramètres, état de la table personnalisée, remplacements de modèles, entrées de journal récentes.
Outils caritatifs » Journal	Tous les événements d'ambassadeurs enregistrés avec source: ambassadors_*.

En savoir plus sur les informations du site

Surface développeur

Thème	Changement
Surface de filtrage et d'action	Plus de 300 filtres / plus de 40 actions dans le plugin. La plupart nommées charitable_ambassadors_<feature>_*.
Remplacements de thème	Chaîne standard. Remplacez n'importe quel modèle sous votre-thème/charitable-pro/charitable-ambassadors/<chemin>.php.
REST	Nouveau point d'accès pour le widget d'intégration à /wp-json/charitable-ambassadors/v1/embed-widget/<id>. Contrôlé par CORS.
Rôles personnalisés	campaign_creator inchangé par rapport à la version 2.x. Capacité principale : manage_charitable_settings.
Tables personnalisées	Une nouvelle table d'opt-in pour les invitations (<prefix>charitable_ambassadors_invite_tokens).
Statut de publication personnalisé	charitable-rejected pour les collectes de fonds rejetées par le modérateur.

Référence des hooks et filtres

Ce qui reste pareil

Si vous craignez des problèmes de mise à niveau :

• Toutes les clés d'options sont préservées. Les personnalisations existantes des options de paramètres s'appliquent toujours.
• Tous les shortcodes sont préservés. [charitable_submit_campaign], [charitable_my_campaigns], etc.
• Tous les noms de filtres/actions sont préservés. Quelques-uns ont été ajoutés, aucun n'a été renommé.
• Toutes les URL de campagne sont préservées. Les permaliens de vos collectes de fonds existantes ne changent pas.
• Tous les dons sont préservés. Le cumul vers les parents fonctionne de la même manière.

Voir Migration de 2.x vers 3.0 pour la cartographie IA complète.

Liste de contrôle de mise à niveau

Après la mise à niveau, voici quelques tâches que nous vous recommandons d'accomplir :

1. Aller à Aperçu : Commencez par visiter Charitable » Ambassadeurs. Vous devriez arriver directement sur l'écran d'aperçu, confirmez que les tuiles KPI et le graphique principal s'affichent correctement avant de faire quoi que ce soit d'autre.
2.  Parcourir l’Assistant de configuration : Ouvrez l’Assistant de configuration à partir de l’invite orange sur l’écran d’aperçu. Si vos paramètres existants sont déjà en bon état, vous pouvez les ignorer sans terminer chaque étape, mais cela vaut la peine d’y jeter un coup d’œil rapide pour vous assurer que rien d’important n’a été omis.
3.  Choisir une version de l’interface utilisateur : Allez dans Modèles > Style du modèle frontal et décidez quelle version convient à votre configuration. Si vous avez apporté des modifications personnalisées au modèle, restez sur Hérité pour éviter de tout casser. Si ce n’est pas le cas, envisagez de passer à Amélioré ou Visuel pour profiter des nouvelles options de mise en page.
4.  Vérifier votre couleur d’accentuation : Accédez à Modèles » Thèmes » Couleur d’accentuation principale et confirmez qu’elle correspond à votre marque. Cette seule couleur s’applique à toutes les pages améliorées et visuelles, il est donc utile de bien la régler avant que vos ambassadeurs ne commencent à partager leurs pages de collecte de fonds.
5.  Vérifier la bannière d’état des e-mails : Retournez à l’onglet Aperçu et recherchez la bannière à bordure orange près du haut de l’écran. Si quelque chose est signalé, corrigez-le maintenant – ce sont les e-mails transactionnels sur lesquels vos donateurs et ambassadeurs comptent pour rester informés.
6.  Tester une soumission : Accédez à /submit-campaign/ et soumettez une collecte de fonds test depuis le frontend. Confirmez que la nouvelle grille de cartes Étape 1 fonctionne comme prévu et que le formulaire se déroule jusqu’à la fin sans aucun problème.
7.  Approuver la soumission test : Visitez Modération, trouvez votre soumission test et cliquez sur Approuver. Confirmez que l’e-mail de confirmation est envoyé correctement et que la collecte de fonds passe au bon statut.

💡 Nouveau dans Ambassadors ? L’avis de bienvenue de l’écran d’aperçu renvoie à cette page, elle sert donc également de guide d’orientation. Si vous venez de prendre en charge la gestion du programme, commencez ici et suivez la liste de contrôle depuis le début.

🎯 N’essayez pas de tout apprendre d’un coup. Ambassadors 3.0 introduit de nombreuses nouvelles fonctionnalités, mais vous n’avez pas besoin de toutes les maîtriser dès le premier jour. Une fois que vous avez terminé la liste de contrôle, choisissez la fonctionnalité unique la plus pertinente pour le plus grand point faible de votre équipe et commencez par là.

Vous pourriez aussi vouloir lire

Voici quelques guides liés à Ambassadors. Vous pouvez les ajouter aux favoris et les lire quand vous en avez besoin :

• Migration de 2.x vers 3.0 – la feuille de triche IA.
• Assistant de configuration – exécutez l’assistant pour appliquer les valeurs par défaut de 3.0 à toutes les préférences non définies.
• Tableau de bord d’aperçu – votre nouvel écran d’accueil.
• Hooks & filtres dans Ambassadors – la référence du développeur.