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
- Dans l'administration WordPress, allez dans Charitable → Outils.
- 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.
- Sur Outils → Journaux, activez Activer la journalisation.
- 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 :
- Accédez à Charitable → Outils → Journaux.
- 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).
- Utilisez Type, Niveau et Source pour vous concentrer sur le domaine pertinent (par exemple, Erreur + Passerelle pour les problèmes de paiement).
- Utilisez Recherche pour trouver les messages mentionnant un code d'erreur, un nom de passerelle ou une période.
- 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.
- 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.
