WP-CLI maintenant disponible dans notre plugin WordPress
Publié le:
Vous gérez de nombreux sites WordPress, par exemple en tant qu'agence ? Vous ne voulez alors pas configurer l'e-mail sur chaque site séparément. C'est pourquoi notre plugin WordPress fonctionne désormais avec WP-CLI. Vous configurez Lettermint depuis la ligne de commande et intégrez ces étapes dans vos propres scripts ou déploiements.
Cette mise à jour apporte plus que WP-CLI. Vous configurez maintenant aussi le plugin via wp-config ou des variables d'environnement, ce qui garde votre token API en dehors de la base de données. Et vous décidez désormais vous-même combien de temps les données d'envoi restent dans les logs.
WP-CLI
WP-CLI est l'outil officiel en ligne de commande pour WordPress. Il vous permet de gérer un site depuis le terminal plutôt que depuis l'interface wp-admin, par exemple pour installer des plugins, lancer des mises à jour ou modifier des réglages. Particulièrement pratique quand vous le faites pour de nombreux sites à la fois.
Le plugin ajoute pour cela une commande wp lettermint. Vous vérifiez ainsi vos réglages et envoyez un e-mail de test sans vous connecter au site.
- wp lettermint status vérifie votre token API
- wp lettermint test vous@example.fr envoie un e-mail de test
- wp lettermint info affiche la configuration active
- wp lettermint logs affiche les logs récents avec filtres
- wp lettermint stats affiche vos e-mails envoyés
- wp lettermint prune --days=30 supprime les anciens logs
WP-CLI devient vraiment puissant en combinaison avec le reste de l'outil. Vous configurez un nouveau site client en une seule fois depuis la ligne de commande, sans une seule étape dans le tableau de bord.
wp plugin install lettermint --activate
wp config set LETTERMINT_API_TOKEN lm_project_token --type=constant
wp config set LETTERMINT_FROM_EMAIL bonjour@example.fr --type=constant
wp config set LETTERMINT_FORCE_EMAIL 1 --type=constant
Ensuite, vous vérifiez que tout fonctionne.
wp lettermint status
wp lettermint test vous@example.fr
Vous intégrez ces étapes dans un script de provisioning, un pipeline de déploiement ou un modèle de site, pour que chaque site client reçoive les mêmes réglages d'e-mail.
Combinez cela avec notre Team API, et vous automatisez la configuration de bout en bout. Créez un token API par client ou ajoutez un nouveau domaine pour vos envois, et transmettez ce token directement à WP-CLI.

Configurer via wp-config
Comme vous l'avez vu dans l'exemple WP-CLI ci-dessus, nous avons utilisé wp config set pour enregistrer votre token API. C'est possible maintenant, car vous pouvez définir chaque option comme PHP constant ou environment variable plutôt que via le tableau de bord. Idéal pour le staging et la production, et pour le config-as-code où vous gérez vos réglages dans votre dépôt plutôt que site par site.
define( 'LETTERMINT_API_TOKEN', 'lm_project_token' );
define( 'LETTERMINT_FROM_EMAIL', 'bonjour@example.fr' );
Chaque réglage a sa propre constant, du token API au niveau de log. Votre token reste ainsi en dehors de la base de données, même si vous partagez votre code ou le placez sous gestion de versions.
Les réglages via wp-config ou une environment variable ont la priorité sur ce que vous saisissez dans WordPress. C'est pourquoi ils y apparaissent en read-only.
Niveaux de log et conservation
Si et comment vous stockez les données d'e-mail, vous le décidez désormais vous-même. Le logging était auparavant seulement activé ou désactivé. Vous choisissez maintenant parmi quatre niveaux :
- Ne rien enregistrer
- Erreurs uniquement
- Métadonnées, sans le contenu de l'e-mail
- L'e-mail complet
Vous ne conservez ainsi pas plus que nécessaire.
En complément, vous définissez une durée de conservation. Les logs plus anciens que votre durée sont supprimés. Si vous préférez ne pas conserver les données plus longtemps que nécessaire, choisissez une durée courte.
Maintenant disponible
Mettez à jour le plugin Lettermint vers la dernière version depuis votre interface d'administration WordPress ou le WordPress Plugin Directory.