Utilizzo di WP-CLI con il registro delle attività
Il plugin Activity Log include comandi WP-CLI per esportare i dati di log ed eliminare le vecchie voci dalla riga di comando. Ciò è utile per automatizzare le esportazioni dei log, integrarli con gli script o gestirli su ambienti headless o di staging.
Requisiti
È necessario che WP-CLI sia installato sul server e che sia possibile eseguirlo dalla riga di comando. Il plugin Activity Log deve essere installato e attivato. Eseguire tutti i comandi dalla root dell'installazione di WordPress.
Comando Esporta
Il comando export invia le voci del registro attività al terminale o a un file. È possibile filtrare i risultati utilizzando qualsiasi combinazione dei flag disponibili.
wp duplicator-activity-log export
Per impostazione predefinita, questo comando visualizza tutte le voci di log sotto forma di tabella formattata. Aggiungere flag per filtrare e modificare il formato di output.
Esporta bandiere
Tutti i flag sono opzionali e possono essere combinati liberamente.
--format=
Formato di output. Accetta table (predefinito), csv, o json.
--category_l1=
Filtra per categoria di eventi di primo livello. Valori accettati: user, content, media, plugin, theme, wordpress, appearance, taxonomy, settings.
--severity=
Filtra per livello di gravità. Valori accettati: info, low, medium, high, critical.
--user_id=
Filtra gli eventi in base a un ID utente WordPress specifico.
--event_type=
Filtra in base a un codice di tipo di evento specifico. Ad esempio: user_login_failed, plugin_activated, content_post_published.
--search=
Cerca tra i messaggi degli eventi e i nomi degli oggetti. Equivalente al campo Cerca eventi nell'amministrazione.
--date_from=
Mostra gli eventi a partire da questa data. Accetta qualsiasi formato di data PHP. strtotime() capisce, ad esempio 2026-01-01 o yesterday.
--date_to=
Mostra gli eventi fino a questa data inclusa.
--site_id=
Su WordPress Multisite, filtra gli eventi per un sito specifico in base al suo ID blog. L'impostazione predefinita è il sito corrente.
--fields=
Elenco separato da virgole dei campi da includere nell'output. Utile per restringere le esportazioni CSV. Campi disponibili: id, date_gmt, user_login, user_role, severity, event_type, message, object_name, ip_address, is_cli.
Esempi di esportazione
Esporta tutti gli eventi come file CSV:
wp duplicator-activity-log export --format=csv > activity-log.csv
Esporta solo gli eventi di gravità elevata degli ultimi 7 giorni:
wp duplicator-activity-log export --severity=high --date_from="7 days ago"
Esporta tutti i tentativi di accesso non riusciti in formato JSON:
wp duplicator-activity-log export --event_type=user_login_failed --format=json
Esporta tutti gli eventi del plugin relativi a un intervallo di date specifico in un file:
wp duplicator-activity-log export --category_l1=plugin --date_from=2026-01-01 --date_to=2026-01-31 --format=csv > plugins-jan.csv
Esporta solo campi specifici per un CSV leggero:
wp duplicator-activity-log export --format=csv --fields=date_gmt,user_login,severity,message > compact-log.csv
Comando di pulizia
Il comando di pulizia elimina tutte le voci di registro più vecchie del periodo di conservazione configurato (impostato in Registro attività › Impostazioni › Generale). Si tratta della stessa azione eseguita automaticamente dal cron job giornaliero.
wp duplicator-activity-log purge
Ciò è utile se hai modificato il periodo di conservazione e desideri eliminare immediatamente le voci obsolete senza attendere la prossima esecuzione pianificata, oppure se devi attivarlo manualmente in uno script di distribuzione.
Per eliminare tutte le voci del registro indipendentemente dalla loro anzianità, utilizzare invece il pulsante Elimina tutti i registri in Registro attività › Impostazioni › Strumenti.