Si MailerPress ou MailerPress Pro ne se comporte pas comme prévu, les journaux de débogage enregistrent les erreurs à l’origine du problème et aident notre support à en trouver rapidement la cause. Ce guide explique comment activer la journalisation, où trouver les fichiers journaux et comment la désactiver ensuite.
Activer la journalisation de débogage de WordPress
- Connectez-vous à votre serveur en SFTP (un outil de transfert de fichiers sécurisé) ou avec le gestionnaire de fichiers de votre hébergeur. Si vous n’avez pas vos identifiants, demandez-les à votre hébergeur.
- Ouvrez
wp-config.php, le fichier de configuration de WordPress situé à la racine de votre installation. - Ajoutez ces lignes au-dessus de la ligne
/* That's all, stop editing! */. Si certaines existent déjà, modifiez leur valeur au lieu de les ajouter une seconde fois.
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );Avec WP_DEBUG_DISPLAY à false, les erreurs vont dans le journal sans être affichées à vos visiteurs.
Enregistrez le fichier, puis reproduisez le problème : rechargez la page concernée ou répétez l’action qui échoue. WordPress écrit les erreurs dans wp-content/debug.log. Téléchargez ce fichier.
Les fichiers journaux de MailerPress
Lorsque WP_DEBUG_LOG est activé, MailerPress écrit aussi ses propres fichiers journaux, par exemple queue-debug.log (file d’envoi), cleanup.log et database-repair-AAAA-MM-JJ.log (réparation de la base de données). Ils se trouvent dans wp-content/uploads, dans un dossier dont le nom commence par mailerpress-logs. Ce dossier n’est pas accessible depuis un navigateur : téléchargez les fichiers en SFTP.
Journal détaillé de MailerPress
Si notre support vous demande plus de détails, ajoutez aussi cette ligne dans wp-config.php :
define( 'MAILERPRESS_DEBUG', true );MailerPress écrit alors un journal quotidien détaillé dans wp-content/plugins/mailerpress/logs/mailerpress-AAAA-MM-JJ.log. Ce dossier est remplacé lors d’une mise à jour de MailerPress : téléchargez les journaux avant de mettre à jour.
Rapport de la base de données
Pour un problème de base de données, allez dans MailerPress > Outils > Réparation de la base de données et cliquez sur Exporter le rapport complet. Consultez Réparer votre base de données MailerPress.
Envoyer les journaux au support
Ouvrez un ticket de support et joignez debug.log et, si besoin, les fichiers journaux de MailerPress. Indiquez la date et l’heure auxquelles vous avez reproduit le problème pour que nous retrouvions les lignes correspondantes.
Désactiver le débogage
Pour des raisons de sécurité, désactivez le débogage une fois le dépannage terminé : supprimez les lignes ajoutées dans wp-config.php ou passez-les à false, y compris MAILERPRESS_DEBUG. Supprimez ensuite les fichiers journaux : ils peuvent contenir des données personnelles comme des adresses e-mail.