Prérequis :
- Charitable Pro 1.8.16+
- Charitable Ambassadeurs 3.0.0+
Charitable Ambassadors 3.0 nécessite Charitable Pro 1.8.16 ou une version ultérieure pour fonctionner. Si votre Pro est sur une version plus ancienne, vous verrez un avertissement jaune lorsqu'une mise à jour d'Ambassadors 3.0 sera disponible. La mise à jour de Charitable Pro d'abord est tout ce qu'il faut pour le résoudre.
Cette page explique à quoi ressemble l'avertissement, le bon ordre de mise à jour et quoi faire si quelque chose semble anormal.
L'avertissement sur votre écran Plugins
Lorsqu'une nouvelle mise à jour d'Ambassadors 3.0 est proposée mais que votre Charitable Pro est antérieur à la version 1.8.16, vous verrez un message d'alerte jaune sous la ligne d'Ambassadors :
Attention : Charitable Ambassadors 3.0 nécessite Charitable Pro 1.8.16 ou une version ultérieure. Votre version actuelle : 1.8.15.3. Veuillez d'abord mettre à jour Charitable Pro.
Les numéros de version exacts reflètent ce que votre site a actuellement et ce vers quoi Ambassadors mettra à jour.
Si vous ne voyez pas ce paragraphe jaune, votre Pro est déjà sur la version 1.8.16 ou plus récente et vous pouvez mettre à jour Ambassadors directement.
Le bon ordre : Pro d'abord, puis Ambassadors
- Mettez à jour Charitable Pro. Trouvez Charitable Pro sur l'écran Plugins et cliquez sur mettre à jour maintenant. Une fois terminé, la ligne devrait afficher la version 1.8.16 ou supérieure.
- Mettez à jour Ambassadors. Le paragraphe d'avertissement jaune disparaît au prochain chargement de page. Cliquez sur mettre à jour maintenant sur la ligne Ambassadors et la mise à jour se déroule normalement.
Vous pouvez également cocher les deux lignes sous Plugins > Mises à jour et cliquer sur Mettre à jour les plugins pour les faire ensemble. WordPress les traite dans l'ordre, donc Ambassadors voit le nouveau Pro au moment où son tour arrive.
Ce qui se passe si vous mettez à jour Ambassadors avant Pro
Cela dépend de la version d'Ambassadors actuellement installée :
- Sur Ambassadors 2.3.11 ou plus récent : la mise à jour est arrêtée avant que vos fichiers existants ne soient remplacés. WordPress affiche une erreur claire expliquant que Pro doit être mis à jour en premier. Votre site continue de fonctionner avec la version qu'il avait juste avant.
- Sur Ambassadors 2.3.10 ou plus ancien (ou si vous avez téléchargé manuellement un zip 3.0) : la mise à jour se termine, mais Ambassadors se retrouve en mode pause. Les dons aux pages de collecte de fonds existantes continuent d'arriver, mais la zone d'administration d'Ambassadors est verrouillée derrière une notification claire « mettre à jour Charitable Pro » jusqu'à ce que vous le fassiez.
Dans tous les cas, vos données sont en sécurité. Les campagnes, les dons, les ambassadeurs et les équipes ne sont pas touchés.
Si Ambassadors 3.0 est déjà installé et que Pro est toujours antérieur à la version 1.8.16
Si vous êtes arrivé ici, votre site est en mode pause. La récupération est rapide :
- Mettez à jour Charitable Pro vers la version 1.8.16 (ou plus récente). Dès que la mise à jour est terminée, l'administration d'Ambassadors se déverrouille au prochain chargement de page. La notification disparaît et les onglets normaux reviennent. Toutes les soumissions de collecte de fonds arrivées pendant que l'administration était en pause attendent d'être examinées.
Si vous ne pouvez pas mettre à jour Pro pour le moment :
- Cliquez sur « Désactiver Ambassadors » sur la page de notification de mise à niveau. Vos données ne sont pas touchées. Vous pourrez réactiver plus tard une fois Pro à jour.
- Ou revenez à une version précédente d'Ambassadors en téléchargeant le zip 2.3.x depuis votre compte wpcharitable.com et en le téléversant via Extensions > Ajouter > Téléverser une extension. La plupart des sites n'auront pas besoin de cela, mais l'option existe.
Après l'installation d'Ambassadors 3.0
Deux choses changent immédiatement :
- Le menu d'administration retire Ambassadors de Charitable > Réglages et lui donne son propre élément de premier niveau à Charitable > Ambassadeurs.
- Une notification de bienvenue apparaît en haut du nouvel écran Ambassadeurs avec un lien vers les notes de version 3.0.
Vos réglages, campagnes, collectes de fonds et dons enregistrés sont tous conservés. Aucune migration de données n'est nécessaire.
Dépannage
Aucune mise à jour Pro n'est proposée
Si Charitable Pro indique votre version actuelle mais aucun lien « mettre à jour maintenant », la liste des mises à jour n'a peut-être pas encore été rafraîchie.
- Allez dans Tableau de bord > Mises à jour et cliquez sur Vérifier à nouveau.
- Confirmez que votre clé de licence est active sous Charitable > Réglages > Général > Licences. Une licence expirée ou désactivée empêche les offres de mise à jour d'atteindre votre site.
Si la licence est actuelle et que la mise à jour n'apparaît toujours pas, contactez-nous depuis votre compte sur wpcharitable.com.
Votre licence a expiré
Ambassadors 3.0 est une mise à niveau payante. Si votre période de support et de mise à jour a expiré, votre site ne se verra pas proposer la mise à jour. Vous pouvez :
- Renouveler sur wpcharitable.com pour rétablir l'offre de mise à jour.
- Continuer à utiliser votre version actuelle d'Ambassadors 2.x. Elle continuera de fonctionner.
- Si vous êtes déjà passé à la version 3.0 avec une licence expirée, utilisez le lien Désactiver Ambassadors sur la page de notification de mise à niveau pour désinstaller proprement le plugin. Vos données restent dans la base de données.
Vous utilisez Charitable Lite, pas Pro
Ambassadors 3.0 nécessite Charitable Pro. Si votre site utilise Charitable Lite, vous verrez le même avertissement et la mise à niveau sera bloquée. Pour utiliser Ambassadors 3.0, ajoutez une licence Charitable Pro. Vos dons et campagnes Lite existants continueront de fonctionner lorsque Pro sera activé en parallèle.
Vous avez téléversé manuellement un zip d'Ambassadors 3.0 et l'installation a échoué
Si vous avez récupéré le zip d'Ambassadors 3.0 depuis votre compte wpcharitable.com et que vous avez essayé de l'installer via Extensions > Ajouter > Téléverser une extension, la vérification de sécurité bloque également ce chemin. Mettez d'abord à jour Charitable Pro, puis réessayez de téléverser le zip d'Ambassadors. Votre installation existante reste intacte entre-temps.
FAQ
Pourquoi Pro 1.8.16 spécifiquement ? C'est la version Pro qui introduit les assistants dont Ambassadors 3.0 dépend. Les versions Pro plus anciennes ne les ont pas.
Est-ce que cela affectera mon site utilisant Ambassadors 2.x si je ne mets pas à niveau ? Non. La vérification ne s'active que lorsqu'une tentative d'installation d'Ambassadors 3.0 est en cours. L'utilisation d'Ambassadors 2.x avec une version Pro plus ancienne continue de fonctionner normalement.
Puis-je mettre à jour Ambassadors et Charitable Pro dans le même lot ? Oui. WordPress les traite dans l'ordre, donc Ambassadors voit la version Pro plus récente au moment où il la vérifie.
Mes campagnes, dons ou ambassadeurs seront-ils perdus ? Non. Vos données sont conservées quel que soit le chemin emprunté sur cette page : mises à jour, blocages, désactivation et même retour à la version 2.x.
Est-ce que cela affecte les réseaux multisites ? Oui. Chaque sous-site vérifie sa propre version active de Charitable. Mettez d’abord à jour Pro sur l’ensemble du réseau, puis déployez Ambassadeurs 3.0.
