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.x	Emplacement 3.0
Paramètres > Ambassadors > Général	Charitable > Ambassadors > Général
Paramètres > Ambassadors > Affichage	Charitable > Ambassadors > Modèles (renommé)
Paramètres > Ambassadors > Autre	Divisé en Charitable > Ambassadors > Partage et Charitable > Ambassadors > Divers
Style de modèle frontal	Charitable > Ambassadors > Modèles (en haut de l'onglet)
Approbation automatique des campagnes	Charitable > Ambassadors > Général (emplacement inchangé, même clé d'option)
Durée minimale/maximale des campagnes	Charitable > Ambassadors > Général (inchangé)
Exiger un compte avant la soumission	Charitable > 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 partage	Charitable > Ambassadors > Partage (nouvel sous-onglet dédié, était Autre > Partage en 2.x)
Interrupteurs d'affichage de Mes campagnes	Charitable > Ambassadors > Mes campagnes (nouvel sous-onglet dédié)
Interrupteurs de la page de collecte de fonds	Charitable > Ambassadeurs > Page de collecte de fonds (nouvel onglet dédié)
Rapport sur les dons du créateur de campagne	Charitable > Ambassadeurs > Mes campagnes (déplacé de l'onglet Général dans la version 3.0)
Interrupteur principal des codes QR	Charitable > Ambassadeurs > Divers > Codes QR (nouvelle sous-section)

Nouveautés de la version 3.0

Six nouveaux onglets de niveau supérieur :

Onglet	Ce qu'il fait
Aperçu	Tableau 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ération	La file d'attente En attente / Action requise / Rejeté / Approuvé. Remplace l'ancienne liste d'administration « Soumissions en attente ».
Annuaire	La liste complète des ambassadeurs avec profils, vérification, filtres, exportation CSV. Remplace le chemin implicite « Utilisateurs ayant au moins une campagne ».
Invitations	La fonctionnalité de recrutement par lien d'invitation personnel. Entièrement nouvelle.
Sous-onglet Mes campagnes	La 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 fonds	Le 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 configuration	L'invite orange de configuration sur Aperçu – ou Charitable > Ambassadeurs > Général > Actions de configuration > Ouvrir la configuration	Trois chemins d'achèvement (Assistant / Modèles / Démarrage rapide).
Mode modèle visuel	Charitable > Ambassadeurs > Modèles > Style de modèle frontal > Visuel	Choisissez une campagne modèle dont la mise en page du constructeur sera clonée pour chaque collecte de fonds.
8 variantes de mise en page	Charitable > Ambassadeurs > Modèles > Modèle frontal (amélioré)	Classique, Histoire d'abord, Statistiques d'abord, Don d'abord, Magazine, Vitrine, Affiche Vitrine, Rallye.
Notifications locales	L'icône de cloche Pro	4 événements se déclenchent à partir des Ambassadeurs.
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.
Exportations CSV	Boutons de téléchargement par section sur Aperçu, Modération, Annuaire, Invitations	Sûr contre l'injection de formules, limité à 10 000 lignes.

Paramètres renommés

Nom de la version 2.x	Nom 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.x	Pourquoi
Section Éléments de page publique	Sous l'onglet Modèles / Affichage	Le 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 » autonomes	Modèles	Remplacé 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.x	Nom de la version 3.0
charitable_ambassadors_settings_display_fields	charitable_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 :

Surprise	Pourquoi
« 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

• Tableau de bord de présentation – le nouveau écran d'accueil.
• Assistant de configuration – les trois chemins d'achèvement pour la configuration initiale.
• Fonctionnalités d'affichage (onglet Modèles) – l'orientation du nouvel onglet Modèles.
• Mise à jour du module complémentaire (notes de publication 3.0) – le journal des modifications canonique.
• Hooks & filtres dans Ambassadors – référence complète des filtres et des actions.