Como atualizar um tema ou plugin manualmente

Se você tentou instalar a versão nova por cima e o WordPress avisou que a pasta de destino já existe, isso é esperado: ele não sobrescreve item instalado pela tela de envio. Existem dois caminhos, e nenhum dos dois apaga as suas configurações — elas ficam no banco de dados, não nos arquivos.

Antes de qualquer um dos dois: faça backup. É a diferença entre um contratempo de dois minutos e uma noite ruim.

Caminho 1: desativar, apagar, instalar

Para plugin:

• En Plugins, clique em Desativar no item.
• Clique em Excluir.
• Vá em Adicionar novo > Enviar plugin e envie o ZIP da versão nova.
• Ative.

Apagar o plugin se apaga as configurações dele na esmagadora maioria dos casos: elas estão em tabelas do banco e continuam lá quando a versão nova ativa. As exceções são plugins que oferecem explicitamente «apagar todos os dados ao desinstalar» — se essa opção existir e estiver ligada, desligue antes.

Para tema, o WordPress não deixa excluir o tema ativo. Ative outro tema temporariamente (o padrão do WordPress serve), exclua o antigo, instale a versão nova e reative. Se você usa tema filho, ative o filho e atualize só o pai — o filho nem precisa sair do ar.

Caminho 2: substituir por FTP

Mais rápido quando o item é grande, e não passa pelo limite de upload do WordPress:

• Extraia o ZIP da versão nova no seu computador.
• Conecte por FTP ou pelo gerenciador de arquivos da hospedagem.
• Vá até wp-content/plugins/ ou wp-content/themes/.
• Renomeie a pasta antiga para algo como nome-do-item-old — não apague ainda.
• Envie a pasta nova com o nome original.
• Confira o site. Deu tudo certo, apague a pasta antiga.

Renomear em vez de apagar é o detalhe que transforma esse caminho no mais seguro dos dois: se algo der errado, voltar é renomear de novo.

Duas coisas para conferir depois

A versão instalada, em Plugins ou Aparência > Temas — é a confirmação de que a troca pegou. E o site em si, em uma página que use o item, porque erro de atualização costuma aparecer no front antes do painel.

Se você faz isso toda semana

Manual não escala. Quem mantém vários sites tende a migrar para o Ultrapack Auto Updater, que faz o mesmo processo pelo painel e tira uma cópia do item antes de cada atualização.