Utilisation de WP-CLI avec le journal d'activité
Le plugin Activity Log comprend des commandes WP-CLI permettant d'exporter les données du journal et de purger les anciennes entrées à partir de la ligne de commande. Cela est utile pour automatiser les exportations de journaux, intégrer des scripts ou gérer les journaux dans des environnements sans interface graphique ou de test.
Exigences
Vous devez avoir installé WP-CLI sur votre serveur et pouvoir l'exécuter à partir de la ligne de commande. Le plugin Activity Log doit être installé et activé. Exécutez toutes les commandes à partir de la racine de votre installation WordPress.
Commande d'exportation
La commande export affiche les entrées du journal d'activité sur le terminal ou dans un fichier. Vous pouvez filtrer les résultats à l'aide de n'importe quelle combinaison des indicateurs disponibles.
wp duplicator-activity-log export
Par défaut, cela affiche toutes les entrées du journal sous forme de tableau formaté. Ajoutez des indicateurs pour filtrer et modifier le format de sortie.
Drapeaux d'exportation
Tous les indicateurs sont facultatifs et peuvent être combinés librement.
--format=
Format de sortie. Accepte table (par défaut), csvou json.
--category_l1=
Filtrer par catégorie d'événement de niveau supérieur. Valeurs acceptées : user, content, media, plugin, theme, wordpress, appearance, taxonomy, settings.
--severity=
Filtrer par niveau de gravité. Valeurs acceptées : info, low, medium, high, critical.
--user_id=
Filtrer les événements par un identifiant utilisateur WordPress spécifique.
--event_type=
Filtrer par un code de type d'événement spécifique. Par exemple : user_login_failed, plugin_activated, content_post_published.
--search=
Recherchez parmi les messages d'événement et les noms d'objet. Équivalent au champ Rechercher des événements dans l'administration.
--date_from=
Afficher les événements à partir de cette date. Accepte tous les formats de date PHP. strtotime() comprend, par exemple 2026-01-01 ou yesterday.
--date_to=
Afficher les événements jusqu'à cette date incluse.
--site_id=
Sur WordPress Multisite, filtrez les événements pour un site spécifique en fonction de son identifiant de blog. La valeur par défaut est le site actuel.
--fields=
Liste des champs à inclure dans la sortie, séparés par des virgules. Utile pour réduire les exportations CSV. Champs disponibles : id, date_gmt, user_login, user_role, severity, event_type, message, object_name, ip_address, is_cli.
Exemples d'exportation
Exporter tous les événements sous forme de fichier CSV :
wp duplicator-activity-log export --format=csv > activity-log.csv
Exporter uniquement les événements de gravité élevée des 7 derniers jours :
wp duplicator-activity-log export --severity=high --date_from="7 days ago"
Exporter toutes les tentatives de connexion échouées au format JSON :
wp duplicator-activity-log export --event_type=user_login_failed --format=json
Exporter tous les événements du plugin pour une plage de dates spécifique vers un fichier :
wp duplicator-activity-log export --category_l1=plugin --date_from=2026-01-01 --date_to=2026-01-31 --format=csv > plugins-jan.csv
Exportez uniquement les champs spécifiques pour obtenir un fichier CSV allégé :
wp duplicator-activity-log export --format=csv --fields=date_gmt,user_login,severity,message > compact-log.csv
Commande de purge
La commande purge supprime toutes les entrées du journal plus anciennes que la période de conservation que vous avez configurée (définie dans Journal d'activité › Paramètres › Général). Il s'agit de la même action que celle exécutée automatiquement par la tâche cron quotidienne.
wp duplicator-activity-log purge
Cette fonction est utile si vous avez modifié votre période de conservation et souhaitez nettoyer immédiatement les anciennes entrées sans attendre la prochaine exécution planifiée, ou si vous devez la déclencher manuellement dans un script de déploiement.
Pour purger toutes les entrées du journal, quel que soit leur âge, utilisez plutôt le bouton Purger tous les journaux dans Journal d'activité › Paramètres › Outils.