O plugin Activity Log inclui comandos WP-CLI para exportar dados de log e eliminar entradas antigas a partir da linha de comando. Isso é útil para automatizar exportações de log, integrar com scripts ou gerir logs em ambientes headless ou de teste.

Requisitos

Você precisará ter o WP-CLI instalado no seu servidor e acesso para executá-lo a partir da linha de comando. O plugin Activity Log deve estar instalado e ativado. Execute todos os comandos a partir da raiz da sua instalação do WordPress.

Comando Exportar

O comando export exporta entradas do registo de atividades para o terminal ou para um ficheiro. Pode filtrar os resultados usando qualquer combinação dos sinalizadores disponíveis.

wp duplicator-activity-log export

Por predefinição, isto apresenta todas as entradas do registo como uma tabela formatada. Adicione sinalizadores para filtrar e alterar o formato de saída.

Bandeiras de exportação

Todas as flags são opcionais e podem ser combinadas livremente.

--format=

Formato de saída. Aceita table (padrão), csv, ou json.

--category_l1=

Filtrar por categoria de evento de nível superior. Valores aceites: user, content, media, plugin, theme, wordpress, appearance, taxonomy, settings.

--severity=

Filtrar por nível de gravidade. Valores aceites: info, low, medium, high, critical.

--user_id=

Filtre eventos por um ID de utilizador específico do WordPress.

--event_type=

Filtre por um código de tipo de evento específico. Por exemplo: user_login_failed, plugin_activated, content_post_published.

--search=

Pesquise mensagens de eventos e nomes de objetos. Equivalente ao campo Pesquisar eventos no administrador.

--date_from=

Mostrar eventos a partir desta data. Aceita qualquer formato de data do PHP. strtotime() compreende, por exemplo 2026-01-01 ou yesterday.

--date_to=

Mostrar eventos até e incluindo esta data.

--site_id=

No WordPress Multisite, filtre eventos para um site específico pelo seu ID de blog. O padrão é o site atual.

--fields=

Lista separada por vírgulas dos campos a incluir na saída. Útil para restringir exportações CSV. Campos disponíveis: id, date_gmt, user_login, user_role, severity, event_type, message, object_name, ip_address, is_cli.

Exemplos de exportação

Exportar todos os eventos como um ficheiro CSV:

wp duplicator-activity-log export --format=csv > activity-log.csv

Exportar apenas eventos de gravidade elevada dos últimos 7 dias:

wp duplicator-activity-log export --severity=high --date_from="7 days ago"

Exportar todas as tentativas de login falhadas como JSON:

wp duplicator-activity-log export --event_type=user_login_failed --format=json

Exportar todos os eventos do plugin para um intervalo de datas específico para um ficheiro:

wp duplicator-activity-log export --category_l1=plugin --date_from=2026-01-01 --date_to=2026-01-31 --format=csv > plugins-jan.csv

Exportar apenas campos específicos para um CSV leve:

wp duplicator-activity-log export --format=csv --fields=date_gmt,user_login,severity,message > compact-log.csv

Comando de purga

O comando purge elimina todas as entradas de registo mais antigas do que o período de retenção configurado (definido em Registo de Atividades › Definições › Geral). Esta é a mesma ação que a tarefa cron diária executa automaticamente.

wp duplicator-activity-log purge

Isso é útil se você alterou o período de retenção e deseja limpar imediatamente as entradas antigas sem esperar pela próxima execução programada ou se precisar acioná-lo manualmente em um script de implementação.

Para eliminar todas as entradas do registo, independentemente da idade, utilize o botão Eliminar todos os registos em Registo de atividades › Definições › Ferramentas.