Documentation Charitable

Apprenez à tirer le meilleur parti de Charitable grâce à des instructions claires, étape par étape.

Migration d'Ambassadors 2.x vers 3.0

Requis : Charitable Pro 1.8.16+

Ambassadors 3.0 est une refonte majeure. La version précédente organisait les paramètres comme une sous-page sous Paramètres de Charitable ; 3.0 promeut Ambassadors à un onglet d'administration de premier niveau avec ses propres sous-onglets (Vue d'ensemble, Modération, Annuaire, Invitations, Général, Modèles, Mes campagnes, Page de collecte de fonds, Partage, Divers).

La plupart des paramètres ont conservé leurs clés d'option et leurs valeurs enregistrées, vos données sont donc reportées. Mais les chemins du menu ont changé – et quelques fonctionnalités ont de nouveaux emplacements.

Cette page est la feuille de triche pour trouver ce qui a été déplacé où.

Les paramètres ont déménagé

L'administration 2.x se trouvait à :

Charitable » Settings » Ambassadors

L'administration 3.0 se trouve à :

» Charitable » Ambassadors

Ce seul changement est ce que la plupart des utilisateurs remarquent au premier lancement après la mise à niveau. Le menu « Paramètres » sous Charitable existe toujours pour d'autres paramètres (Paiements, E-mails, Avancé, etc.), mais Ambassadors n'est plus l'une de ses sous-pages.

Où se trouvent maintenant les paramètres courants d'Ambassadors 2.x dans la version 3.0

Emplacement 2.xEmplacement 3.0
Paramètres > Ambassadors > GénéralCharitable > Ambassadors > Général
Paramètres > Ambassadors > AffichageCharitable > Ambassadors > Modèles (renommé)
Paramètres > Ambassadors > AutreDivisé en Charitable > Ambassadors > Partage et Charitable > Ambassadors > Divers
Style de modèle frontalCharitable > Ambassadors > Modèles (en haut de l'onglet)
Approbation automatique des campagnesCharitable > Ambassadors > Général (emplacement inchangé, même clé d'option)
Durée minimale/maximale des campagnesCharitable > Ambassadors > Général (inchangé)
Exiger un compte avant la soumissionCharitable > Ambassadors > Général (inchangé)
Destinataires de campagne (types)Charitable > Ambassadors > Général (maintenant sélecteur de puces visuelles)
Sélection du réseau de partageCharitable > Ambassadors > Partage (nouvel sous-onglet dédié, était Autre > Partage en 2.x)
Interrupteurs d'affichage de Mes campagnesCharitable > Ambassadors > Mes campagnes (nouvel sous-onglet dédié)
Interrupteurs de la page de collecte de fondsCharitable > Ambassadeurs > Page de collecte de fonds (nouvel onglet dédié)
Rapport sur les dons du créateur de campagneCharitable > Ambassadeurs > Mes campagnes (déplacé de l'onglet Général dans la version 3.0)
Interrupteur principal des codes QRCharitable > Ambassadeurs > Divers > Codes QR (nouvelle sous-section)

Nouveautés de la version 3.0

Six nouveaux onglets de niveau supérieur :

OngletCe qu'il fait
AperçuTableau de bord au niveau du programme avec des indicateurs clés de performance, un graphique principal, les meilleurs contributeurs. Nouveau dans la version 3.0.
ModérationLa file d'attente En attente / Action requise / Rejeté / Approuvé. Remplace l'ancienne liste d'administration « Soumissions en attente ».
AnnuaireLa liste complète des ambassadeurs avec profils, vérification, filtres, exportation CSV. Remplace le chemin implicite « Utilisateurs ayant au moins une campagne ».
InvitationsLa fonctionnalité de recrutement par lien d'invitation personnel. Entièrement nouvelle.
Sous-onglet Mes campagnesLa page Mes campagnes, visible par le visiteur, dispose désormais de son propre sous-onglet de paramètres avec un aperçu en direct.
Sous-onglet Page de collecte de fondsLe sélecteur de variante de mise en page amélioré, les fil d'Ariane, le partage, la position du mur des donateurs, le nettoyage de l'interface. Nouveau sous-onglet.

Grandes nouvelles fonctionnalités dans les onglets existants

Quelques fonctionnalités qui n'existaient pas du tout dans la version 2.x :

FonctionnalitéSe trouve àRemarques
Assistant de configurationL'invite orange de configuration sur Aperçu – ou Charitable > Ambassadeurs > Général > Actions de configuration > Ouvrir la configurationTrois chemins d'achèvement (Assistant / Modèles / Démarrage rapide).
Mode modèle visuelCharitable > Ambassadeurs > Modèles > Style de modèle frontal > VisuelChoisissez une campagne modèle dont la mise en page du constructeur sera clonée pour chaque collecte de fonds.
8 variantes de mise en pageCharitable > Ambassadeurs > Modèles > Modèle frontal (amélioré)Classique, Histoire d'abord, Statistiques d'abord, Don d'abord, Magazine, Vitrine, Affiche Vitrine, Rallye.
Notifications localesL'icône de cloche Pro4 événements se déclenchent à partir des Ambassadeurs.
Widget d'intégrationCharitable > Ambassadeurs > Divers > Widget d'intégrationDésactivé par défaut ; activez-le pour ajouter une vignette Widget d'intégration aux fenêtres contextuelles de partage de collecte de fonds.
Exportations CSVBoutons de téléchargement par section sur Aperçu, Modération, Annuaire, InvitationsSûr contre l'injection de formules, limité à 10 000 lignes.

Paramètres renommés

Nom de la version 2.xNom de la version 3.0
Style du modèle frontal (sous Affichage)Style du modèle frontal (sous Modèles – sous-onglet renommé)
« Afficher le mur des donateurs »« Position du mur des donateurs » (maintenant Haut / Bas / Masquer au lieu de Activé / Désactivé)
« Afficher le code QR » (paramètre unique)Divisé en Afficher le QR sur la page de collecte de fonds, Vignette QR dans la fenêtre contextuelle de partage, Afficher le code QR (Mes campagnes) – contrôles par surface

Paramètres supprimés

Une poignée de paramètres ont été supprimés car ils n'ont jamais été efficaces ou étaient mieux exprimés ailleurs :

Paramètre suppriméEmplacement 2.xPourquoi
Section Éléments de page publiqueSous l'onglet Modèles / AffichageLe contrôle par variante côté client se fait désormais via les filtres _render_<atom>_args ; l'interface des paramètres était encombrée.
Remplacements de modèles de « modération » autonomesModèlesRemplacé par l'onglet Modération unifié.

Si votre site existant dépendait de l'un de ceux-ci, le filtre correspondant est toujours en place – l'interface ne le présente plus comme un paramètre.

Renommage des filtres et actions

La plupart des noms de filtres et d'actions de la version 2.x sont inchangés dans la version 3.0. Quelques exceptions :

Nom de la version 2.xNom de la version 3.0
charitable_ambassadors_settings_display_fieldscharitable_ambassadors_settings_display_fields (conservé pour la compatibilité ascendante – l'onglet a été renommé Modèles mais le nom du filtre reste pour les sites qui l'ont accroché).

Si vous aviez des filtres accrochés en 2.x, ils devraient toujours se déclencher en 3.0 sauf indication contraire. Exécutez une recherche `grep` sur vos personnalisations :

grep -rn "charitable_ambassadors_" your-customizations/ | sort -u

…et recoupez avec la référence des Hooks pour voir ce qui est toujours actif et ce qui a été renommé.

Ce qui reste pareil

Réassurance : la plupart de votre configuration existante est conservée sans modifications.

  • Toutes les clés d’option sont conservées. Les clés wp_options.charitable_settings.ambassadors.* sont les mêmes. Les personnalisations existantes de ces options s’appliquent toujours.
  • Tous les rôles utilisateur sont conservés. campaign_creator existe toujours, il a toujours les mêmes permissions.
  • Tous les types de publication personnalisés sont conservés. Les types de publication de campagne n’ont pas changé.
  • Tous les shortcodes sont conservés. [charitable_submit_campaign], [charitable_my_campaigns], etc. fonctionnent de manière identique.
  • Toutes les URL de collecte de fonds sont conservées. Les permaliens de vos collectes de fonds existantes ne changent pas.
  • Les données de dons sont conservées. Tous les dons historiques sont regroupés par collectes de fonds et parents de la même manière qu’en 2.x.

Que vérifier après la mise à niveau

Une courte liste à parcourir juste après votre mise à niveau :

  1. Visitez Charitable > Ambassadeurs – confirmez que vous arrivez sur l’aperçu et que les KPI s’affichent.
  2. Vérifiez l’onglet Modération – les collectes de fonds en attente de la version 2.x devraient être dans En attente ; celles précédemment rejetées devraient être dans Rejetées.
  3. Vérifiez le Répertoire – vos ambassadeurs existants devraient apparaître dans la vue Tous.
  4. Ouvrez l’Assistant de configuration une fois – il affichera le sélecteur de chemin ; vous pouvez le sauter (vos paramètres existants sont conservés) ou exécuter Démarrage rapide pour appliquer les valeurs par défaut de la version 3.0 à toutes les préférences non définies.
  5. Vérification de cohérence des Modèles > Style de modèle frontal – confirmez que le bon style est sélectionné (Hérité / Amélioré / Visuel).
  6. Effectuez une soumission de test – soumettez une nouvelle collecte de fonds via /submit-campaign/ et confirmez que le flux en 3 étapes de grille de cartes fonctionne de bout en bout.
  7. Effectuez une approbation de test – approuvez la soumission de test depuis la Modération ; confirmez que l’e-mail est envoyé et que le journal d’audit enregistre l’action.

Si quelque chose ne va pas, consultez Outils Charitable > Journal pour les entrées associées.

Surprises courantes

Quelques éléments qui surprennent les personnes qui mettent à niveau :

SurprisePourquoi
« Où sont passés les Ambassadeurs dans les Paramètres ? »Ils ont été déplacés vers leur propre élément de menu principal Charitable. Charitable > Ambassadeurs.
« Ma vieille campagne de test est dans ‘Rejetées’ mais je ne l’ai jamais rejetée. »Ambassadeurs 3.0 introduit le statut de publication charitable-rejected. Les anciennes collectes de fonds dans un état « rejeté » jamais publié sont reclassées à ce statut lors de la première sauvegarde.
« Il y a 6 nouveaux sous-onglets d’administration. »Modération, Répertoire, Invitations, Mes campagnes, Page de collecte de fonds, Partage sont tous nouveaux. Cliquez dessus pour découvrir chaque nouvelle fonctionnalité.
« Mon réglage de code QR a disparu. »Il a été divisé en contrôles par surface. Trouvez-les sous Divers (maître) + les sous-onglets Mes campagnes / Page de collecte de fonds (par surface).
« Mes campagnes ont l’air différentes sur le front-end. »Le modèle amélioré est maintenant actif par défaut. Paramètres > Modèles > Héritage restaure l'ancien aspect.

Conseils

  • Mettez à niveau d'abord dans un environnement de staging. C'est toujours une bonne idée d'utiliser une copie de votre site de production pour parcourir les modifications avant que les clients ne les voient.
  • Prenez des captures d'écran avant et après. Surtout de Mes Campagnes et d'une vraie page de collecte de fonds – ainsi, si quelque chose semble inhabituel après la mise à niveau, vous avez une référence.
  • Exécutez l'Assistant de configuration au moins une fois. Même si vous sautez chaque étape, cela valide le drapeau d'intégration terminée et masque le panneau d'invite de présentation orange.
  • Lisez les notes de publication 3.0. La page des notes de publication est le journal des modifications canonique avec des détails liés sur chaque nouvelle fonctionnalité.

Connexes

Liens utiles

🤝 Obtenez de l’aide quand vous en avez besoin

Contactez le support client →  

📑 Trouvez le guide dont vous avez besoin

Parcourez le Hub de documentation →  

⬇️ Téléchargez des stratégies éprouvées, des idées de campagnes et des outils d'experts
Obtenez le kit de collecte de fonds →  

💸 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

Vous avez encore des questions ? Nous sommes là pour vous aider !

Dernière modification :

Quoi de neuf dans Charitable

Voir les dernières mises à jour
🔔 Abonnez-vous pour recevoir nos dernières mises à jour
📧 Abonnez-vous aux e-mails

Abonnement par e-mail

Rejoignez notre newsletter

Nous ne vous enverrons pas de spam. Nous envoyons un e-mail uniquement lorsque nous pensons qu'il vous sera réellement utile. Désabonnez-vous à tout moment !

Amélioration Paiements

💰 Acceptez les dons récurrents avec Windcave et Charitable

Un donateur configure son don une seule fois sur la page de paiement sécurisée de Windcave, et Charitable facture chaque renouvellement par la suite selon le calendrier établi. Pourquoi c'est important :

🏦 Organisations basées en Nouvelle-Zélande ou en Australie : dons mensuels sur la passerelle avec laquelle votre banque vous a déjà configuré, sans second processeur à intégrer.
⛪ Églises acceptant les dîmes et offrandes régulières : les membres de la congrégation définissent leur propre calendrier une fois, ce qui est le moyen le plus simple de lancer des dons d'église récurrents sans plateforme distincte.
🌏 Groupes avec des donateurs dans plusieurs devises : Windcave en gère plus de 20, ainsi un sympathisant peut donner dans la devise qu'il détient réellement.
📅 Fonds de fonctionnement plutôt que des campagnes ponctuelles : activez le mode « Récurrent uniquement » et l'option ponctuelle disparaît, de sorte que chaque don à cette campagne est un abonnement.
🧾 Équipes sans développeur attitré : 3 jeux d'identifiants collés sur une page de paramètres, et aucun code nulle part.

Consultez notre annonce ici.

automatisation mettre à jour

⚡ Générateur d'automatisation visuelle : Glisser-déposer sans code !

Charitable Automation Connect 2.3.0 introduit le Générateur d'automatisation visuelle, une zone d'édition plein écran qui présente chaque automatisation sous forme de flux de cartes connectées : un déclencheur, des conditions facultatives et une liste d'actions exécutées dans l'ordre.

🧩 De nombreuses actions, un seul déclencheur : Taguez un donateur, envoyez un e-mail, ajoutez une note et déclenchez un webhook à partir d'un seul événement, disposés dans n'importe quel ordre.

✉️ Agissez à l'intérieur de Charitable : Les nouvelles actions Envoyer un e-mail, Taguez un donateur et Ajoutez une note de donateur s'exécutent sans service externe requis.

🔤 Étiquettes de fusion : Personnalisez les e-mails et les notes avec des champs dynamiques tels que {first_name}, {total} et {campaign_name}.

🔁 Appliquer aux donateurs existants : Exécutez Taguez un donateur et Ajoutez une note de donateur sur les donateurs que vous avez déjà.

🖥️ Zone d'édition ou Simple : Changez de vue à tout moment, et les automatisations créées avant la version 2.3.0 continueront de fonctionner sans modification.

En savoir plus ici.

Intégration mis à jour

📬 Présentation de Brevo pour Charitable : Transformez automatiquement les donateurs en abonnés

Le moment où un donateur fait un don est le moment où il est le plus engagé. Avec la nouvelle intégration Brevo pour Charitable, vous pouvez transformer automatiquement ces donateurs ponctuels en abonnés à long terme sans toucher à une seule feuille de calcul.

Collectez simplement le consentement du donateur directement sur votre formulaire de don et lancez votre série de bienvenue immédiatement.

Quoi de neuf :

🔄 Synchronisation automatisée des abonnés : Les nouveaux donateurs qui donnent leur accord sont ajoutés directement à votre liste de contacts Brevo dès que leur paiement est traité, sans aucune exportation manuelle ni importation de CSV.

🎯 Contrôle granulaire du consentement et de l'opt-in : Personnalisez le libellé de votre case à cocher, choisissez si elle est cochée par défaut ou non, ou activez le double opt-in de Brevo pour maintenir votre liste propre et conforme.

📋 Mappage de liste par campagne : Dirigez les sympathisants vers votre liste d'e-mails globale ou mappez des campagnes spécifiques à des listes Brevo ciblées pour adapter vos messages de suivi.

⚡ Configuration en 5 minutes : Connectez-vous instantanément en collant votre clé API Brevo dans les paramètres de Newsletter, mappez vos champs de contact et commencez à construire votre liste d'e-mails en mode pilote automatique.

Prêt à développer votre liste de diffusion ? Brevo est disponible dès maintenant à partir du plan Charitable Plus — connectez votre compte dès aujourd'hui !

dons récurrents mis à jour

💳 Mises à jour de carte : Corrigez les cartes expirées sans perdre vos abonnements !

Les cartes de crédit expirées ou mises à jour sont l’une des plus grandes fuites silencieuses dans les collectes de fonds récurrentes. Avec les mises à jour de carte dans l’extension Dons récurrents, les donateurs peuvent désormais actualiser leurs informations de paiement directement, en conservant leur abonnement, leur calendrier et leur historique de dons complètement intacts.

Aucun plan annulé, aucun historique perdu et zéro casse-tête administratif pour votre équipe.

Quoi de neuf :

⚡ Assistance en 30 secondes : les donateurs obtiennent un bouton « Mettre à jour la carte » dédié dans leur tableau de bord qui ouvre le portail client sécurisé et conforme PCI de Stripe pour mettre à jour instantanément les détails de la carte.

🔒 Accès sécurisé et limité : limité exclusivement aux mises à jour de carte par défaut, les donateurs ne peuvent pas annuler ou modifier accidentellement leurs plans depuis le portail, en gardant vos webhooks et vos données synchronisés.

🤝 Assistance administrative : vous aidez un donateur par téléphone ? Ouvrez son portail Stripe sécurisé en un clic depuis votre écran d’administration ou générez un lien de mise à jour à usage unique à lui envoyer par e-mail.

📋 Piste d’audit automatique : chaque mise à jour de méthode de paiement est enregistrée automatiquement avec un horodatage dans les journaux système et le profil du donateur individuel.

Prêt à protéger vos revenus récurrents ? Obtenez le forfait Plus ou Pro et mettez à jour Dons récurrents vers la version 2.3.0+ et activez « Mettre à jour la méthode de paiement » dans vos Paramètres dès aujourd’hui !

Intégration constructeur de pages

Les fans de Divi se réjouissent ! Module natif de barre de progression de campagne Divi 5 !

Avec notre nouveau module natif Divi 5, vous pouvez ancrer vos microsites avec des statistiques de collecte de fonds en temps réel directement sur la toile visuelle. Voici comment cela fonctionne et pourquoi il est intéressant de l'activer dès aujourd'hui.

Créez des mises à jour de campagne VISUELLES ET EN DIRECT. Vous pouvez également :

📊 Barre de progression de campagne : Insérez une barre de progression en direct dans n'importe quelle mise en page Divi 5 et affichez la progression de l'objectif en temps réel.

🎨 Contrôles de style approfondis : Personnalisez facilement la couleur de la barre et de la piste, la hauteur et le rayon pour qu'ils correspondent parfaitement à votre marque.

👁️ Prêt pour le Visual Builder : Configurez et prévisualisez tout directement sur la toile Divi en tant que module de première classe.

🔁 Rendu identique : Le même moteur exact alimente ce module, ce qui signifie une conception cohérente sans correctifs hérités.

✅ Lancements plus rapides : Ne quittez jamais l'interface Divi 5 pour configurer des shortcodes ou deviner à quoi ressembleront vos étiquettes d'objectif.

En savoir plus ici.