Na maioria dos casos você não precisa de nada manual. Desde o WordPress 5.5, de agosto de 2020, enviar o ZIP de um item que já está instalado abre uma tabela comparando a versão enviada com a que está no ar, com um botão para substituir uma pela outra. É em Plugins > Adicionar novo > Enviar plugin, ou Aparência > Temas > Adicionar novo > Enviar tema.
Se em vez da tabela você recebeu a pasta de destino já existe e a instalação parou, o site está numa versão anterior à 5.5: aí sim o caminho é manual.
Os dois caminhos abaixo continuam valendo, e não só para WordPress antigo. Eles resolvem quando o arquivo passa do limite de upload do servidor, quando a substituição falha no meio, e quando você quer poder voltar atrás em segundos. Nenhum dos dois apaga as suas configurações: elas ficam no banco de dados, não nos arquivos.
Antes de qualquer um deles, inclusive do caminho direto: faça backup. É a diferença entre um contratempo de dois minutos e uma noite ruim.
Caminho manual 1: desativar, apagar, instalar
Para plugin:
- Em 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 não 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 manual 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/ouwp-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.
