MailerPress ajoute à WP-CLI (l’outil en ligne de commande de WordPress) des commandes regroupées sous wp mailerpress. Elles permettent de vérifier la boîte de rebonds IMAP, de rétablir les migrations de la base de données et de réparer les jetons d’accès des contacts, par exemple quand l’administration WordPress n’est pas accessible. Vous avez besoin d’un accès SSH au serveur. Ces commandes font partie de MailerPress (gratuit) ; MailerPress Pro n’est pas nécessaire.
Avant de commencer
- Installez WP-CLI sur votre serveur et lancez les commandes depuis le dossier racine de WordPress, ou ajoutez
--path=/chemin/vers/wordpress. Sur un multisite, ajoutez--url=pour cibler un site. - Lancez
wp help mailerpresspour lister les commandes. Elles n’ont pas d’aide intégrée : cette page sert de référence. - Certaines commandes de diagnostic affichent leurs messages en français, quelle que soit la langue de votre site.
- Sauvegardez votre base de données avant toute commande qui modifie des données (migrations, jetons, contacts marqués en rebond).
Commandes de la boîte de rebonds
Ces commandes utilisent la boîte de rebonds IMAP (la boîte qui reçoit les e-mails non distribuables) configurée avec l’option Activer le suivi des rebonds (IMAP) dans les réglages SMTP personnalisé, sous MailerPress > Intégrations > Services d‘envoi d‘e-mails. Si aucune boîte n’est configurée, elles s’arrêtent en indiquant que la configuration des rebonds est absente ou invalide.
Une fois la boîte configurée, MailerPress la vérifie toutes les 12 heures via Action Scheduler (action planifiée mailerpress_check_bounces). Chaque vérification se connecte en SSL, lit les messages non lus du dossier INBOX, retrouve le destinataire d’origine de chaque rebond, marque le contact correspondant comme « bounced » (en rebond) et marque le message comme lu.
| Commande | Rôle |
|---|---|
wp mailerpress bounce status | Affiche les réglages de la boîte (e-mail, hôte, port, identifiant), indique si la vérification automatique est planifiée et quand elle aura lieu. |
wp mailerpress bounce check | Vide le journal des rebonds, lance une vérification immédiate et affiche les nouvelles entrées du journal. |
wp mailerpress bounce logs [--limit=<nombre>] | Affiche les dernières entrées du journal des rebonds, de la plus récente à la plus ancienne. Par défaut : 100 entrées. |
wp mailerpress bounce clear-logs | Vide le journal des rebonds. |
wp mailerpress bounce:parse | Lance une vérification immédiate, sans vider ni afficher le journal. |
wp mailerpress bounce:schedule-run-now | Lance une vérification immédiate et affiche le détail de l’erreur en cas d’échec. |
wp mailerpress bounce:schedule-status | Contrôle la configuration, l’action planifiée, la prochaine exécution et l’intervalle, puis liste les 10 dernières vérifications avec leur statut et le message d’erreur de celles qui ont échoué. |
wp mailerpress bounce:schedule-reset | Supprime toutes les vérifications planifiées et leurs journaux, puis planifie une nouvelle vérification récurrente qui démarre immédiatement et se répète toutes les 24 heures. |
wp mailerpress bounce:stats | Affiche le nombre de contacts par statut d’abonnement et les 10 derniers contacts passés en rebond. |
wp mailerpress bounce:test [--debug] [--yes] | Teste la connexion IMAP, liste les dossiers de la boîte, analyse chaque message non lu du dossier INBOX et affiche le destinataire détecté et l’existence du contact. Demande ensuite une confirmation avant de marquer les contacts détectés comme « bounced ». --debug affiche aussi les en-têtes et les 2 000 premiers caractères de chaque message ; --yes répond automatiquement à la confirmation. |
wp mailerpress bounce:dump | Affiche l’objet, tous les en-têtes, le corps complet et toutes les adresses e-mail trouvées dans chaque message non lu du dossier INBOX. |
wp mailerpress bounce:mark-unseen | Marque tous les messages du dossier INBOX comme non lus, pour que la prochaine vérification les traite à nouveau. |
bounce:dump et bounce:test --debug affichent le contenu de vrais e-mails, données personnelles comprises. bounce:mark-unseen modifie tous les messages de la boîte, pas seulement les rebonds. Utilisez-les uniquement sur une boîte dédiée aux rebonds.
Diagnostiquer la détection des rebonds
- Lancez
wp mailerpress bounce statuspour vérifier que la boîte est configurée et que la vérification est planifiée. - Lancez
wp mailerpress bounce:testpour tester la connexion et voir quels destinataires MailerPress détecte dans les messages non lus. - Si aucune vérification n’est planifiée ou si les actions planifiées échouent, lancez
wp mailerpress bounce:schedule-reset. - Lancez
wp mailerpress bounce check, puiswp mailerpress bounce:statspour voir le résultat.
Commandes de migration de la base de données
MailerPress met à jour ses tables grâce à des migrations (scripts de mise à jour) exécutées après chaque mise à jour de l’extension. Dans la plupart des cas, réparez la base de données avec MailerPress > Outils > Réparation de la base de données (voir Réparer votre base de données MailerPress). Utilisez les commandes ci-dessous quand l’administration n’est pas accessible ou quand notre support vous le demande.
| Commande | Rôle |
|---|---|
wp mailerpress migrations:status | Indique si les migrations sont verrouillées, le nombre de migrations en échec et en cours, et le message d’erreur de chaque migration en échec. |
wp mailerpress migrations:unlock | Libère le verrou des migrations, par exemple après une migration interrompue par un délai d’expiration. |
wp mailerpress migrations:reset-failed | Remet les migrations en échec en attente et libère le verrou, sans les exécuter. |
wp mailerpress migrations:force-run | Réinitialise les migrations en échec ou bloquées, libère le verrou et exécute toutes les migrations en attente. |
wp mailerpress migrations:force-reexecute <fichier> | Remet une migration en attente pour qu’elle soit exécutée à nouveau au prochain migrations:force-run. Indiquez le nom exact du fichier de migration, extension .php comprise. |
wp mailerpress migrations:add-file-hash-column | Ajoute la colonne file_hash à la table de suivi des migrations si elle manque sur une ancienne installation. |
Séquence de récupération type :
wp mailerpress migrations:status
wp mailerpress migrations:force-run
wp mailerpress migrations:statusPour exécuter à nouveau une seule migration, utilisez le nom de fichier communiqué par notre support ou affiché dans l’erreur de migration :
wp mailerpress migrations:force-reexecute 2026_09_15_100000_fix_legacy_anonymous_tracking_index.php
wp mailerpress migrations:force-runCommandes des jetons d’accès
Chaque contact possède un jeton d’accès unique (une clé secrète) que MailerPress utilise dans ses liens personnels, comme le lien de gestion de l’abonnement.
| Commande | Rôle |
|---|---|
wp mailerpress tokens:generate | Crée un jeton d’accès unique pour chaque contact qui n’en a pas, par lots de 200 contacts. Si la colonne access_token n’existe pas encore, exécutez d’abord les migrations. |
wp mailerpress tokens:cleanup-scheduler | Supprime les restes de l’ancienne génération des jetons en arrière-plan : l’option mailerpress_access_tokens_scheduled et les actions planifiées mailerpress_generate_access_tokens. |
Commandes internes
wp help mailerpress liste aussi make:migration, fixtures:generate et debug:container. Ce sont des outils de développement destinés à l’équipe MailerPress : make:migration écrit un nouveau fichier dans le dossier de l’extension, fixtures:generate crée des utilisateurs de test et des automatisations de test activées, et debug:container inspecte le conteneur de services interne. Ne les lancez pas sur un site en production.
Pour exécuter les tâches de fond depuis le serveur, consultez Comment configurer une tâche Cron WordPress à partir de votre serveur.