Atualizar sem perder a customização – Ultrapack
23.484 itens no catálogo12.026 atualizações entregues este mês
981 sites recebendo auto-updates via UAU
Atualização e auto-updater

Atualizar sem perder a customização

Se você editou arquivos do tema, a próxima atualização apaga tudo. O tema filho resolve — e leva dez minutos.

A regra que evita o prejuízo é uma só: o que você editar dentro da pasta do tema ou do plugin será apagado na próxima atualização. Não é bug e não tem aviso — atualizar substitui a pasta inteira.

Se você já editou e ainda não atualizou, copie os arquivos alterados para um lugar seguro antes de seguir.

Tema: use um tema filho

O tema filho é uma pasta separada que herda tudo do tema principal e guarda só as suas alterações. Ele não é atualizado — o pai é. Suas mudanças sobrevivem.

Muitos temas do catálogo já vêm com um -child.zip no pacote. Se vier, instale os dois e ative o filho: está pronto.

Se não vier, criar é rápido. Uma pasta em wp-content/themes/, digamos meutema-child, com um arquivo style.css começando assim:

  • /*
  • Theme Name: Meu Tema Child
  • Template: meutema
  • */

O valor de Template tem que ser exatamente o nome da pasta do tema pai — é o erro número um aqui, e o sintoma é o WordPress dizer que o tema principal está faltando. Junto, um functions.php que carregue o CSS do pai, e o filho está funcional. Ative-o em Aparência > Temas.

Depois disso: CSS novo vai no style.css do filho; funções novas vão no functions.php do filho; para alterar um template, copie o arquivo do pai para o filho mantendo o mesmo caminho e edite a cópia.

CSS: nem sempre precisa de tema filho

Para ajuste só visual, Aparência > Personalizar > CSS adicional guarda o código no banco, e ele sobrevive a qualquer atualização. É a solução mais simples quando a customização é só de aparência.

Plugin: não edite o plugin

Plugin não tem equivalente ao tema filho. O que fazer:

  • Use os hooks que o plugin expõe, a partir do functions.php do seu tema filho. É o mecanismo que os autores oferecem justamente para isso.
  • Se o plugin permite sobrescrever templates a partir do tema — o WooCommerce é o exemplo mais conhecido —, use esse caminho, que é feito para sobreviver a atualização.
  • Em último caso, um plugin próprio, pequeno, com a sua alteração. Ele não é tocado quando o outro atualiza.

Antes de atualizar, mesmo com tudo certo

Backup e, se o site for importante, um ambiente de teste. Tema filho protege o que você escreveu; ele não protege contra a versão nova do autor mudar algo que o seu site usava. Se acontecer, dá para voltar.