Documentation Charitable

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

Système de journalisation caritatif

Charitable Pro, à partir de la version 1.8.13, inclut un Système de journalisation centralisé qui stocke les entrées de journal du plugin dans votre base de données et fournit un écran d'administration pour les visualiser, les filtrer, les rechercher et les exporter. Le support peut vous demander de vérifier ou d'exporter les journaux depuis cet écran lors du dépannage de problèmes tels que des échecs de dons, des erreurs de passerelle de paiement ou des problèmes de validation de formulaire.

Où trouver les journaux

  1. Dans l'administration WordPress, allez dans Charitable → Outils.
  2. Cliquez sur l'onglet Journaux.

Vous verrez les paramètres des journaux et, lorsque la journalisation est activée et que des entrées existent, un tableau des enregistrements de journaux.

Activation de la journalisation

La journalisation est désactivée par défaut.

  1. Sur Outils → Journaux, activez Activer la journalisation.
  2. Les entrées de journal commenceront à être enregistrées à partir de ce moment-là. Les entrées existantes (le cas échéant) restent visibles jusqu'à ce qu'elles soient supprimées ou retirées par le paramètre de rétention.

Lorsque la journalisation est désactivée, aucune nouvelle entrée n'est écrite. Vous pouvez toujours visualiser et exporter les journaux qui ont été capturés avant que vous ne la désactiviez.

Suppression automatique (Rétention)

Utilisez Supprimer automatiquement après pour contrôler la durée de conservation des entrées de journal :

  • Options : 7, 14, 30, 60, ou 90 jours.
  • Les enregistrements plus anciens que la période sélectionnée sont automatiquement supprimés lors d'un nettoyage quotidien.

Cela permet de limiter la taille de la base de données tout en conservant les journaux récents pour le débogage.

Visualisation des journaux

Le tableau des journaux affiche :

  • Titre – Court résumé de l'entrée de journal (cliquez pour ouvrir les détails).
  • Message – Texte du message tronqué.
  • Types – Catégorie du journal (par exemple, Don, Paiement, Passerelle, Erreur, Formulaire).
  • Niveau – Gravité : Erreur, Avertissement, Info ou Débogage.
  • Source – D'où provient le journal (par exemple, Noyau, Stripe, PayPal, Formulaire).
  • Date – Date de création de l'entrée.

Cliquez sur un Titre pour ouvrir une vue détaillée dans une fenêtre modale. La vue détaillée affiche le message complet, la date, le niveau, les types, la source et tous les Enregistrements associés (par exemple, ID de campagne, ID de don, ID de donateur) avec des liens vers ces éléments dans l'administration.

Filtrage et recherche

Au-dessus du tableau, vous pouvez affiner les entrées :

  • Type – Filtrer par type de journal (Don, Paiement, Passerelle, Erreur, Formulaire, etc.).
  • Niveau – Filtrer par niveau (Erreur, Avertissement, Info, Débogage).
  • Source – Filtrer par source (Noyau, Stripe, PayPal, Formulaire, etc.).
  • Recherche – Utilisez la zone « Rechercher dans les journaux » pour rechercher dans le contenu des journaux.

Cliquez sur Filtrer pour appliquer les listes déroulantes ; utilisez la zone de recherche et soumettez pour rechercher. Le filtre et la recherche fonctionnent ensemble. Vous pouvez trier par date (et autres colonnes disponibles) en utilisant les en-têtes de colonne.

Exportation des journaux

L'exportation est utile lorsque le support vous demande d'envoyer des journaux pour un problème spécifique.

  • Exporter filtré (CSV) – Exporte uniquement les lignes qui correspondent aux filtres et à la recherche actuels. Appliquez d'abord vos filtres, puis cliquez sur ce bouton.
  • Exporter tout (CSV) – Exporte toutes les entrées de journal dans la base de données (en respectant la rétention ; les entrées plus anciennes peuvent déjà avoir été supprimées).

Le CSV peut être ouvert dans un tableur ou un éditeur de texte et joint à un ticket de support ou partagé selon la demande.

Suppression des journaux

  • Supprimer tous les journaux – Supprime définitivement toutes les entrées de journal de la base de données. Utilisez cette option si vous souhaitez effacer les anciens journaux ou recommencer. Cette action ne peut pas être annulée.

Lorsque le support demande des journaux

Si vous dépannez un problème :

  1. Accédez à Charitable → Outils → Journaux.
  2. Assurez-vous que Activer la journalisation est activé afin que les événements futurs soient enregistrés (si le support a besoin de reproduire le problème).
  3. Utilisez Type, Niveau et Source pour vous concentrer sur le domaine pertinent (par exemple, Erreur + Passerelle pour les problèmes de paiement).
  4. Utilisez Recherche pour trouver les messages mentionnant un code d'erreur, un nom de passerelle ou une période.
  5. Cliquez sur un Titre pour ouvrir le message complet et les Enregistrements associés (Campagne, Don, Donateur) si cela aide à décrire le problème.
  6. Cliquez sur Exporter filtré (CSV) ou Exporter tout (CSV) et envoyez le fichier au support comme indiqué.

Garder la journalisation activée lors du débogage permet de capturer les nouvelles erreurs, puis de les visualiser ou de les exporter à partir de cet écran.

Exigences

  • Charitable Pro : Version 1.8.13 ou supérieure
  • WordPress : Version 6.2 ou supérieure
  • PHP : Version 7.4 ou supérieure

L'onglet Journaux apparaît sous Charitable → Outils dans l'administration WordPress. Si vous ne le voyez pas, confirmez que vous utilisez Charitable Pro 1.8.13 ou une version ultérieure et que votre rôle utilisateur a accès aux outils Charitable.

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 !

Dons Nouveau

👥 Présentation de la fusion des donateurs : deux fiches, un seul donateur !

Quelque part dans votre liste de donateurs se trouve un donateur qui apparaît deux fois, car il a donné depuis une adresse professionnelle une année et une adresse personnelle l'année suivante. Chaque don est toujours enregistré et chaque reçu a toujours été envoyé, mais un donateur fidèle qui donne depuis des années peut ressembler à deux personnes qui ont donné la moitié moins. À partir du plugin Charitable Pro 1.8.19.1, vous pouvez trouver ces fiches et les fusionner depuis l'écran Donateurs. Pourquoi c'est important :

  • 🔍 Un lien Trouver les doublons là où vous travaillez déjà : Allez dans Charitable » Donateurs et il se trouve à côté de Filtrer et Exporter, puis vous indique combien de groupes de doublons possibles il a trouvés.
  • 🧩 Groupé par nom, pas par e-mail : Charitable compare le prénom et le nom de famille ensemble et ignore les majuscules, les espaces et la ponctuation, ce qui permet de trouver la même personne sous deux adresses différentes.
  • 📊 Un aperçu avant que quoi que ce soit ne change : Chaque groupe affiche chaque fiche avec son adresse e-mail, son nombre de dons et son total à vie, et l'aperçu vous montre les totaux combinés et l'e-mail qui sera ajouté.
  • ↩️ Chaque fusion peut être annulée : Rien n'est fusionné tant que vous n'avez pas choisi de le faire, et vous pouvez annuler toute fusion par la suite, donc une mauvaise supposition ne vous coûte rien.
  • 📥 Conçu pour la semaine après une importation : Le transfert de donateurs depuis un autre plugin est la principale source de doublons, et c'est aussi le moment où ils sont les plus difficiles à repérer, car chaque fiche est nouvelle pour vous.

Consultez notre annonce ici.

ambassadeurs Nouveau

🔑 Présentation des collectes sans mot de passe : inscrivez-vous avec juste une adresse e-mail !

Les donateurs arrivent en voulant aider, et ensuite le formulaire leur demande d'inventer un mot de passe pour un site web qu'ils ne visiteront peut-être que deux fois. Beaucoup d'entre eux s'arrêtent là. Les comptes de collecte sans mot de passe, nouveauté de Charitable Ambassadors 3.5.0, permettent à un donateur de lancer une collecte de pair à pair avec rien d'autre qu'une adresse e-mail. Pourquoi c'est important :

  • 🔑 Aucune étape de mot de passe pour les perdre : Activez-la dans Charitable » Ambassadeurs » Modèles » Formulaire de soumission et le formulaire de création de collecte ne demande qu'un nom, une adresse e-mail et un titre de page.
  • 👤 Toujours un vrai compte WordPress : Un clic dans un e-mail confirme l'adresse, les connecte et crée le compte, afin qu'ils puissent revenir plus tard pour modifier leur histoire, changer leur photo et voir qui a fait un don.
  • 🎚️ Votre choix pour chaque campagne : Chaque campagne de pair à pair peut suivre la valeur par défaut du site ou la remplacer, ce qui est important lorsqu'une campagne paie les collecteurs via Stripe Connect et que ces personnes ont besoin d'un mot de passe.
  • 📋 Voir qui n'a pas encore cliqué : L'onglet Charitable » Ambassadeurs » Répertoire » En attente de connexion liste tous ceux qui attendent encore, avec la campagne qu'ils ont rejointe et un bouton Réenvoyer, afin qu'une faute de frappe ou un dossier de spam puisse être repéré et corrigé.
  • 🛡️ Liens que les scanners ne peuvent pas épuiser : L'ouverture du lien n'affiche qu'une page, et votre collecteur est connecté lorsqu'il appuie sur le bouton, de sorte que les scanners d'e-mails d'entreprise n'épuisent jamais le lien. Chacun fonctionne une fois, expire de lui-même et n'est stocké que sous forme de hachage.

Consultez notre annonce ici.

ambassadeurs Nouveau

🏃 Présentation de l'activité : Montrez les progrès au-delà de l'argent !

La plupart des collectes de fonds peer-to-peer ne se résument pas à l'argent. Un marathon de lecture porte sur les minutes lues, un marathon de marche sur les kilomètres parcourus et une collecte de nourriture sur les repas préparés. L'activité pour les Ambassadeurs Caritatifs permet à vos collecteurs de fonds de montrer cet effort juste à côté des dollars qu'ils collectent. Pourquoi c'est important :

  • 🎯 Progrès sur ce que vous comptez réellement : Une barre de progression montre chaque élément que vous comptez par rapport à sa propre cible, juste à côté de l'argent collecté.
  • 🏅 Jalons pour les choses oui ou non : Un badge de jalon marque les efforts qui sont simplement faits ou non faits, sans chiffre à atteindre.
  • ✍️ Les collecteurs de fonds enregistrent leurs propres chiffres : Vos supporters saisissent leurs totaux depuis leurs propres pages, de sorte que l'effort cesse de vivre dans une feuille de calcul, un commentaire ou nulle part ailleurs.
  • 🤖 Certains chiffres se comptent eux-mêmes : Une étiquette AUTOMATIQUE apparaît partout où le site a calculé le chiffre à partir des dons complétés, afin que vous puissiez voir en un coup d'œil ce que personne n'a tapé.
  • 🧩 Configurez une fois, utilisez partout : Vous décidez ce qui est compté une fois, puis vous choisissez quelles campagnes le comptent. Disponible dès maintenant dans Charitable Ambassadors 3.4.7, sans nouveau plugin et sans développeur.

Consultez notre annonce ici.

ambassadeurs Nouveau

🖨️ Présentation des prospectus et affiches : collectez des fonds loin de l'écran !

Une grande partie de la collecte de fonds de pair à pair se fait loin d'un écran : à la ligne d'arrivée d'un 5 km, sur un panneau d'affichage d'école, dans une cuisine de bureau. Charitable Ambassadors 3.4.7 ajoute 2 imprimables, un prospectus de collecte de fonds portant la propre histoire et le code QR de chaque collecteur de fonds, et une affiche de recrutement qui inscrit de nouveaux collecteurs de fonds. Les deux s'ouvrent comme une page Web normale et s'impriment directement depuis le navigateur. Pourquoi c'est important :

  • 🏁 Un prospectus pour chaque collecteur de fonds : Chacun porte la propre photo, histoire et objectif de ce collecteur de fonds, avec un code QR qui ouvre sa page plutôt que votre campagne principale.
  • 📌 Une affiche qui recrute : Elle affiche « Recrutement en cours » au-dessus du nom de votre campagne avec un grand code QR qui ouvre votre formulaire d'inscription, afin que quelqu'un puisse commencer à collecter des fonds sans attendre un lien de votre part.
  • 🪄 Aucun outil de conception nécessaire : Les deux imprimables s'affichent comme une page Web normale et s'impriment depuis le navigateur, sans plugin PDF et sans designer.
  • 📄 2 mises en page de prospectus : « À distribuer » contient l'histoire complète pour donner à vos amis et à votre famille, et « À afficher » contient un court message accrocheur avec 5 languettes détachables pour un panneau d'affichage.
  • 🛡️ Désactivé jusqu'à ce que vous l'activiez : Les prospectus restent désactivés après la mise à jour jusqu'à ce que vous les activiez sous Charitable » Ambassadeurs » Autre » Prospectus, et seul le propriétaire ou un administrateur peut en ouvrir un.

Consultez notre annonce ici.

Amélioration Paiements

💸 Introduction des tarifs échelonnés pour l'allègement des frais : Adaptez la demande au don !

L'allègement des frais pose une courte question à vos donateurs lors du paiement : souhaitez-vous couvrir les frais de traitement de ce don ? Jusqu'à présent, cette question utilisait un taux unique pour chaque don sur une passerelle, de sorte qu'un don de 10 $ et un don de 500 $ se voyaient demander le même pourcentage. L'allègement des frais 1.3.0 vous permet de définir autant de tranches de dons que vous le souhaitez, chacune portant son propre taux. Pourquoi c'est important :

  • 🪙 Plus doux pour les petits dons : Un coût de transaction fixe représente une part beaucoup plus importante d'un don de 10 $ que d'un don de 500 $, les tranches vous permettent donc de demander moins en bas.
  • 🎚️ Autant de tranches que nécessaire : Chaque tranche porte son propre pourcentage et son propre montant fixe, et la tranche supérieure s'exécute sans limite supérieure.
  • 🛑 Un plafond facultatif : Un champ de frais maximum empêche qu'un donateur ne se voie demander plus qu'un nombre que vous choisissez, quel que soit le montant du don.
  • 🔌 Défini par passerelle de paiement : Stripe peut fonctionner avec quatre tranches tandis que Windcave et Payfast restent sur un taux unique, car les tranches appartiennent à une passerelle et non à l'ensemble de votre site.
  • 🛡️ Rien ne change tant que vous ne le décidez pas : Vos taux actuels restent exactement les mêmes jusqu'à ce que vous activiez « Utiliser les tarifs échelonnés » sous Charitable » Paramètres » Avancé » Allègement des frais.

Consultez notre annonce ici.