Como reverter updates WordPress com segurança: rollback de plugins e core

Um update de plugin quebrou o site. Acontece nas melhores agências. A diferença entre resolver em 15 minutos ou em 3 horas está na preparação: ter o backup certo, saber onde está e ter praticado o processo. Este guia cobre todas as opções de rollback — do simples ao complexo.

A primeira decisão: rollback ou correção?

Quando um update causa problema, existem duas abordagens:

• Rollback: reverter para a versão anterior do componente que causou o problema. Rápido mas deixa uma versão potencialmente vulnerável instalada.
• Correção: investigar o problema específico e corrigir sem reverter. Mais demorado mas resulta numa versão atualizada e funcional.

Para sites de produção com utilizadores ativos, o rollback é quase sempre a primeira ação — restaurar o site primeiro, investigar depois. Para problemas em staging, vale a pena investir na correção.

Rollback de plugin: método mais rápido

Via WP Rollback (plugin gratuito)

WP Rollback permite instalar versões anteriores de qualquer plugin do repositório WordPress.org com 1 clique. Disponível em Plugins → [plugin em questão] → Rollback. Selecione a versão anterior e confirme.

Limitação: não funciona se o painel WP-Admin não está acessível (por exemplo, se o update causou um erro 500). Nesse caso, use os métodos abaixo.

Via FTP/SSH: substituir ficheiros manualmente

1. Aceda ao repositório oficial do plugin: wordpress.org/plugins/[nome-do-plugin]/advanced/
2. Descarregue o zip da versão anterior
3. Via FTP ou SSH, renomeie a pasta do plugin problemático: mv plugin-nome plugin-nome-broken
4. Faça upload e extraia o zip da versão anterior para wp-content/plugins/
5. Verifique se o site funciona
6. Se funciona, ative o plugin via WP-Admin e elimine a pasta -broken

Via WP-CLI

# Instalar versão específica de um plugin
wp plugin install woocommerce --version=8.0.0 --force

# Verificar versão instalada
wp plugin get woocommerce --field=version

Rollback de WordPress core

Reverter o WordPress core é mais delicado mas possível:

Via WP-CLI

# Downgrade de WordPress para versão específica
wp core update --version=6.3.2 --force

Via download manual

1. Descarregar a versão anterior de wordpress.org/download/releases/
2. Extrair localmente
3. Via FTP/SSH, substituir wp-admin/ e wp-includes/ (não toque em wp-content/)
4. Substituir os ficheiros PHP na raiz (wp-login.php, wp-cron.php, etc.) mas não o wp-config.php

Rollback completo via restore de backup

Se o problema é mais grave — base de dados corrompida, múltiplos componentes afetados — o restore de um backup completo é a solução mais limpa. Isto pressupõe ter backups recentes e funcionais. Ver o guia sobre importância de testar restores.

Com backups UpdraftPlus:

1. Settings → UpdraftPlus → Existing backups
2. Selecionar backup anterior ao update
3. Restore → selecionar componentes (plugins, temas, uploads, base de dados)
4. Confirmar e aguardar

Com managed hosting (Kinsta, WP Engine): painel do hosting tem restore de 1 clique para qualquer ponto no histórico de backups.

Após o rollback: o que fazer

1. Confirmar que o site está funcional: testar homepage, páginas internas, checkout (se WooCommerce), formulários
2. Identificar o update problemático: se reverteu múltiplos componentes, ative-os um a um para isolar o culpado
3. Reportar o bug: no repositório WordPress.org do plugin ou ao developer. Inclua versão de WordPress, PHP, e descrição do erro. Isto ajuda a comunidade.
4. Monitorizar releases: verificar quando o developer lança correção antes de fazer update novamente
5. Documentar o incidente: incluir no relatório ao cliente — demonstra transparência e competência

Prevenir a necessidade de rollback

O processo correto para evitar rollbacks é o update seguro via staging: fazer update em ambiente de staging, testar, depois aplicar em produção. Quando isso não é possível, o backup imediatamente antes do update é o safety net. O plugin UpdraftPlus ou Duplicator podem fazer backup automático antes de cada update.