Você atualizou um plugin, a página ficou branca ou o layout desmontou, e agora precisa decidir em minutos: faz downgrade de plugin WordPress ou corre atrás do conflito? O sintoma costuma ser claro. O site quebra logo depois do update, o erro aparece no log apontando para um arquivo do plugin, e a versão anterior funcionava. Nesse cenário, reverter é a saída mais rápida. O problema é que o repositório oficial só entrega a última versão, e ninguém guardou o ZIP antigo.
Antes de reverter: o downgrade resolve mesmo?
Nem todo site quebrado após atualização se conserta voltando a versão. Antes de mexer em arquivos, responda três perguntas. A resposta define se você faz downgrade ou se parte para correção.
| Sinal observado | O que provavelmente é | Caminho |
|---|---|---|
| Site quebrou imediatamente após atualizar o plugin | Incompatibilidade com a nova versão | Downgrade costuma resolver |
| Erro cita função do PHP ou versão do PHP no log | Plugin novo exige PHP mais recente que o seu | Atualizar PHP ou trocar de plugin |
| Quebrou após atualizar dois plugins juntos | Conflito entre plugins | Isolar o culpado antes de reverter |
| Erro aparece em qualquer versão do plugin | Conflito com o tema ou outro plugin | Não é downgrade, é conflito |
Na prática, o teste rápido é este: desative o plugin suspeito. Se o site volta, o problema está nele. Se o site continua quebrado com o plugin desativado, o downgrade não vai ajudar. Nesse caso, o artigo sobre plugin quebrado no WordPress mostra como isolar o culpado real.
Há ainda um caso que muita gente confunde: o plugin premium cuja licença expirou. Aí o comportamento estranho não vem da versão, vem da licença. Vale conferir o guia sobre plugin premium expirado antes de culpar o update.
Como baixar a versão anterior do plugin
O repositório do WordPress.org só serve a última versão pela interface normal. Para versões antigas, existe o diretório de downloads por versão. O endereço segue este padrão, trocando o slug e o número da versão:
https://downloads.wordpress.org/plugin/nome-do-plugin.1.2.3.zip
Para descobrir o número da versão anterior, abra a aba “Developers” da página do plugin no repositório. Lá ficam listadas as versões publicadas e a data de cada uma. Escolha a imediatamente anterior à que quebrou, não uma muito antiga: pular muitas versões traz de volta bugs já corrigidos e, às vezes, vulnerabilidades conhecidas.
Plugins premium não têm esse diretório público. Nesse caso, o ZIP antigo vem de três lugares: a área de downloads da sua conta no site do desenvolvedor, o backup do próprio site feito antes da atualização, ou o cache de atualizações da hospedagem. Se você não tem nenhum dos três, o downgrade fica inviável e a saída é abrir suporte com o fornecedor.
Reverter a versão de plugin WordPress: passo a passo
- Faça backup dos arquivos e do banco. O downgrade mexe em arquivos e, às vezes, em tabelas. Sem backup, um erro deixa o site pior do que estava.
- Ative o modo de manutenção ou trabalhe em staging. Se tiver ambiente de teste, faça tudo lá primeiro. Em produção, avise quem precisa saber.
- Desative o plugin pela tela de Plugins. Se o site estiver fora do ar e você não conseguir acessar o painel, renomeie a pasta do plugin por FTP ou pelo gerenciador de arquivos da hospedagem.
- Apague a pasta do plugin atual. Não sobrescreva: resquícios de arquivos da versão nova causam erro de função duplicada.
- Envie o ZIP antigo e instale por Plugins → Adicionar novo → Enviar plugin. Sem acesso ao painel, descompacte o ZIP direto em
/wp-content/plugins/via FTP. - Ative e teste. Abra a home, o painel, uma página de checkout se for WooCommerce, e o log de erros do PHP.
Se o site não voltar mesmo com a versão antiga, o problema não era a atualização. Pode ser banco de dados corrompido, cache de objeto servindo dados velhos ou conflito com outro plugin. Limpe o cache do site e o cache de objeto antes de concluir qualquer coisa.
Travar a atualização para o problema não voltar
Reverter sem travar a atualização é trabalho perdido: na próxima madrugada o WordPress instala a versão quebrada de novo. Existem três formas de segurar isso, e cada uma serve a um cenário.
- Desativar atualizações automáticas do plugin. Plugins individuais podem ser excluídos do update automático com o filtro
auto_update_pluginnofunctions.phpdo tema filho ou em um mu-plugin. É a forma mais cirúrgica. - Segurar a versão com um plugin de gestão. Painéis de gerenciamento remoto permitem fixar a versão de um plugin em vários sites ao mesmo tempo, sem editar arquivo em cada um.
- Bloquear a checagem de update do plugin específico. Funciona, mas é a opção mais agressiva: você para de receber também os avisos de segurança daquele plugin.
A escolha depende de quanto tempo você vai levar para resolver a causa raiz. Se for questão de dias, travar o update automático basta. Se o plugin ficou sem manutenção, o certo é planejar a troca. O artigo sobre plugin abandonado no WordPress ajuda nessa decisão.
Fazer downgrade de plugin WordPress em vários sites sem repetir o download
Quem administra dez sites não vai baixar o mesmo ZIP dez vezes. O caminho é guardar os arquivos em um lugar só e distribuir. Duas abordagens funcionam bem.
A primeira é manter uma pasta local ou em nuvem com os ZIPs das versões que você considera estáveis, nomeados com slug e versão. Quando um site quebra, você já tem o arquivo em mãos.
A segunda é usar um painel de gestão remota que permita instalar um pacote específico em vários sites de uma vez. Isso reduz o tempo de reação quando o problema atinge mais de um cliente ao mesmo tempo, o que costuma acontecer quando a versão quebrada é de um plugin popular.
Além disso, vale padronizar: se todos os seus sites usam a mesma versão de um plugin crítico, atualize um site piloto primeiro. Só depois de alguns dias sem erro, libere para os demais. Esse hábito evita que uma atualização ruim derrube a carteira inteira no mesmo dia.
Quando o downgrade não é a resposta
Existem situações em que voltar a versão anterior é o caminho errado, e insistir nele só atrasa a solução real.
- O plugin antigo tem vulnerabilidade conhecida. Reverter para uma versão com falha de segurança troca um problema visível por um risco silencioso. Nesse caso, o certo é corrigir a causa ou trocar de plugin.
- O conflito é com a versão do PHP. Se o plugin novo exige PHP mais recente, o downgrade pode funcionar por um tempo, mas você está adiando uma atualização obrigatória do servidor.
- O conflito é com outro plugin ou com o tema. Reverter um não resolve o choque entre dois. Isole o culpado e decida qual dos dois sai.
- O plugin é essencial e está sem manutenção. Reverter vira muleta permanente. Melhor procurar substituto.
Em resumo, o downgrade é solução de curto prazo para um problema de curto prazo. Se o motivo da quebra é estrutural, ele só compra tempo.
Erros comuns ao fazer downgrade de plugin WordPress
Alguns tropeços aparecem com frequência em quem faz esse procedimento pela primeira vez.
- Sobrescrever a pasta do plugin em vez de apagar e reinstalar, deixando arquivos órfãos.
- Reverter sem backup, e depois não conseguir voltar ao estado anterior se algo der errado.
- Esquecer de limpar o cache do site e do navegador, e concluir que o downgrade não funcionou.
- Voltar para uma versão muito antiga, reintroduzindo bugs já corrigidos.
- Não travar a atualização automática e ver o problema voltar no dia seguinte.
Prevenção: como não precisar reverter às pressas
A melhor forma de lidar com downgrade é não precisar dele em produção. Três hábitos reduzem muito o risco.
- Atualize em staging primeiro. Um ambiente de teste com os mesmos plugins e o mesmo tema pega o conflito antes do cliente ver.
- Faça backup antes de cada rodada de atualização. Backup recente é o que permite reverter sem depender do repositório.
- Atualize em lotes pequenos. Um plugin por vez, com teste entre eles, identifica o culpado na hora.
Se você administra vários sites, o custo de fazer isso manualmente cresce rápido. É aí que um painel como o 100% WP entra: ele centraliza atualizações, backups e monitoramento, então você vê qual site quebrou e age antes de o cliente abrir chamado. Para quem tem uma carteira grande, essa visão única é o que separa manutenção tranquila de apagar incêndio toda semana.
Por fim, se o problema atinge muitos sites ao mesmo tempo e você não tem equipe para tratar cada um, pode valer apoio especializado em plugins quebrados. O downgrade é uma ferramenta, não uma estratégia. Usado no momento certo, resolve em minutos. Usado como hábito, esconde problemas que voltam maiores.
