“Editar um arquivo WordPress” pode significar alterar o texto de uma página, o código do tema, uma extensão ou um arquivo do núcleo. Só o conteúdo deve ser alterado no editor de páginas ou posts. Código exige identificar o arquivo e o componente que o mantém, pois uma mudança incorreta pode causar erro fatal ou desaparecer numa atualização.
Descubra o que precisa mudar
Se quer corrigir um parágrafo, imagem ou botão de uma página, use o editor de conteúdo. Para mudar partes compartilhadas do visual, confira se o tema oferece configurações ou o Editor do site. Se a mudança exige código, registre o comportamento esperado e descubra se ele pertence ao tema, a um plugin ou a uma personalização própria. Não edite arquivos do núcleo para mudar comportamento do site.
Prepare uma cópia e um ambiente de teste
Confirme que tem autorização e acesso de recuperação. Faça backup atual de arquivos e banco de dados e verifique como restaurar. Prefira staging. Anote o caminho completo, o nome do arquivo, a versão do tema/plugin e o estado inicial; mantenha uma cópia do arquivo original fora da pasta pública.
Escolha onde manter a personalização
O editor de arquivos do tema ou plugin no painel é básico e pode estar desabilitado por hospedagem, permissões ou política de segurança. Editar o tema pai ou plugin de terceiros diretamente pode ser substituído numa atualização. Para ajustes de tema, avalie um tema filho ou os mecanismos de personalização suportados; para uma função própria, considere um plugin próprio com controle de versão.
Se precisar transferir arquivos, use o método seguro aceito pelo ambiente, como SFTP ou o gerenciador do provedor, e altere apenas o alvo confirmado. Evite copiar um arquivo completo de outra versão ou substituir um pacote inteiro para fazer um ajuste pequeno. WordPress.com e algumas hospedagens gerenciadas podem não permitir acesso aos mesmos arquivos que uma instalação própria.
Valide e tenha um caminho de retorno
Teste a mudança no staging e verifique a sintaxe com as ferramentas adequadas à linguagem. Confira página inicial, páginas afetadas, acesso administrativo, formulários e registros de erro. Se o site parar de responder, restaure o arquivo original pelo método de hospedagem e investigue os logs antes de repetir.
Não publique credenciais, tokens ou dados pessoais no código. Registre quem mantém a personalização, o que uma atualização pode sobrescrever e como desfazê-la. Para alterações que afetam pagamentos, contas ou segurança, procure uma pessoa técnica responsável.
Fontes oficiais: WordPress Developer Resources — editar arquivos, WordPress.org — editor de arquivos de temas e WordPress.org — usar temas filhos.
Serviços de manutenção
Veja o escopo e os próximos passos do serviço relacionado a este tema.
Conteúdo da biblioteca de Diego Henrich. Confira as fontes citadas e valide orientações que dependem da versão de uma plataforma ou serviço.