Le plugin Journal d’activité inclut des commandes WP-CLI pour exporter les données du journal et purger les anciennes entrées depuis la ligne de commande. Ceci est utile pour automatiser les exportations de journaux, l’intégration avec des scripts, ou la gestion des journaux sur des environnements headless ou de staging.

Configuration requise

Vous aurez besoin de WP-CLI installé sur votre serveur et de l’accès pour l’exécuter depuis la ligne de commande. Le plugin Journal d’activité doit être installé et activé. Exécutez toutes les commandes depuis la racine de votre installation WordPress.

Commande d’exportation

La commande export affiche les entrées du journal d’activité dans le terminal ou dans un fichier. Vous pouvez filtrer les résultats en utilisant n’importe quelle combinaison des options disponibles.

wp duplicator-activity-log export

Par défaut, cela affiche toutes les entrées du journal sous forme de tableau formaté. Ajoutez des options pour filtrer et modifier le format de sortie.

Options d’exportation

Toutes les options sont facultatives et peuvent être combinées librement.

--format=

Format de sortie. Accepte table (par défaut), csv, ou json.

--category_l1=

Filtrer par catégorie d’événement de premier niveau. 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 ID 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=

Rechercher dans les messages d’événement et les noms d’objets. Équivalent au champ Rechercher les événements dans l’administration.

--date_from=

Afficher les événements à partir de cette date. Accepte tout format de date que strtotime() de PHP comprend, par exemple 2026-01-01 ou yesterday.

--date_to=

Afficher les événements jusqu’à cette date incluse.

--site_id=

Sur un réseau WordPress Multisite, filtrer les événements pour un site spécifique par son ID de blog. Par défaut, il s’agit du site actuel.

--fields=

Liste séparée par des virgules des champs à inclure dans la sortie. Utile pour affiner 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 de plugin pour une plage de dates spécifique dans 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 des champs spécifiques pour un CSV léger :

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 de journal plus anciennes que votre période de rétention configurée (définie dans Journal d’activité › Paramètres › Général). C'est la même action que celle exécutée automatiquement par la tâche cron quotidienne.

wp duplicator-activity-log purge

Ceci est utile si vous avez modifié votre période de rétention et que vous 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 de journal, quel que soit leur âge, utilisez plutôt le bouton Purger tous les journaux dans Journal d’activité › Paramètres › Outils.