Uma das perguntas mais comuns que ouvimos dos usuários do WordPress é: “Quero personalizar meu tema, mas não sei qual arquivo editar.”
E, honestamente, essa confusão faz todo o sentido. Editar o arquivo errado pode quebrar seu site ou fazer com que suas alterações desapareçam na próxima atualização do seu tema.
Além disso, não ajuda o fato de que a maioria dos temas contém dezenas de arquivos com nomes misteriosos. Isso pode parecer avassalador quando você está apenas tentando mudar uma coisa.
Ao longo dos anos, trabalhamos em todos os tipos de projetos WordPress e tivemos que rastrear os arquivos de modelo corretos mais vezes do que podemos contar. É exatamente por isso que criamos este guia.
Vamos guiá-lo através dos passos exatos que usamos para descobrir qual arquivo de modelo editar, como funciona a hierarquia de modelos do WordPress e como fazer alterações que realmente permaneçam. 🎨
Entendendo os Arquivos de Modelo de Temas WordPress
Antes de começar a editar, é útil saber como os temas são construídos. Temas do WordPress consistem em vários arquivos, incluindo arquivos de template, tags e funções de template personalizadas, partes de template, imagens, JavaScript e arquivos CSS.
A maioria dos temas Clássicos segue a hierarquia oficial de templates do WordPress. (Temas de Bloco, por outro lado, funcionam de maneira diferente e permitem que você edite layouts de página visualmente usando templates HTML no Editor do Site.)
Isso significa que eles organizam o código de forma padronizada. Cada arquivo é usado como um template para exibir uma área específica do seu site WordPress.
Aqui estão alguns dos arquivos de template mais comuns que você verá em um tema Clássico:
| Arquivos do Tema | O que Eles Fazem |
|---|---|
functions.php | Adiciona recursos e funcionalidades, como criar novos tamanhos de imagem, tipos de postagem personalizados ou widgets |
single.php | Exibe um único post de blog |
page.php | Exibe uma página estática (como sua página Sobre ou Página de Contato) |
archive.php | Exibe uma lista de posts, como categorias ou tags |
header.php | Contém a seção de cabeçalho (logo, menu) exibida em todas as páginas |
footer.php | Contém a seção de rodapé exibida em todas as páginas |
Entender essa hierarquia ajuda você a identificar qual arquivo controla uma página específica. Se você precisar adicionar ou editar código no seu tema do WordPress, isso também o ajudará a determinar quais arquivos você precisa editar.
Para mais detalhes, veja nossa folha de consulta para a hierarquia de templates do WordPress.
Com isso em mente, mostraremos como encontrar facilmente quais arquivos editar em um tema do WordPress. Veja o que cobriremos:
Vamos começar!
Encontrando Arquivos de Template para Editar em um Tema do WordPress
A primeira coisa que você precisa fazer é instalar e ativar o plugin What The File. Para mais detalhes, veja nosso guia passo a passo sobre como instalar um plugin do WordPress.
O plugin funciona imediatamente, e não há configurações para você configurar.
🚨 Importante: Você pode ver um aviso de que este plugin está desatualizado. Mas testamos este plugin em nossos ambientes de staging e confirmamos que ele funciona corretamente para temas Clássicos.
No entanto, ele pode não fornecer dados úteis para temas de Bloco modernos que usam templates HTML. Se você tiver preocupações, confira nosso guia para ver se é seguro usar plugins desatualizados para mais informações.
Após a ativação, você precisa visitar o front-end do seu site e notará um novo menu ‘What The File’ na barra de administração do WordPress.
Agora, você só precisa passar o mouse sobre o item do menu. Isso exibirá um menu suspenso listando os arquivos de template usados para exibir esta página.
Clicar no nome do arquivo o levará ao editor de arquivos padrão do WordPress, onde você poderá editar esse arquivo específico.
No entanto, não recomendamos o uso do editor de arquivos do WordPress para editar arquivos de tema, pois ele não possui uma opção de desfazer. Se você cometer um erro e se bloquear do seu site, precisará usar um cliente FTP para corrigi-lo.
Em vez disso, sugerimos o uso de um cliente FTP ou o aplicativo Gerenciador de Arquivos no painel de controle de hospedagem do seu WordPress.
Com essas ferramentas, você pode editar arquivos de tema usando qualquer editor de texto simples, como o Bloco de Notas. Fazer alterações diretas no seu tema do WordPress é uma má ideia porque essas alterações desaparecerão quando você atualizar seu tema.
Se você só precisa alterar cores ou fontes, não precisa editar arquivos PHP. Em temas Clássicos, você pode ir em Aparência » Personalizar » CSS Adicional para adicionar CSS personalizado.
Para alterações mais extensas, você deve criar um tema filho. O plugin ‘What The File’ pode ajudar você a localizar os arquivos de tema que precisa copiar e editar em seu tema filho.
☝ Observação: O item de menu adicionado pelo plugin na barra de administração será visível para todos os usuários logados e linkará diretamente para o editor de arquivos de tema. Recomendamos usar este plugin apenas em um ambiente de desenvolvimento, como um site de staging.
Dica Bônus: Adicionando Código Personalizado de Cabeçalho e Rodapé no WordPress
Às vezes, você pode pensar que precisa editar header.php ou footer.php apenas para adicionar um script de rastreamento ou código de verificação. No entanto, editar esses arquivos diretamente pode ser arriscado e difícil de gerenciar.
Em vez disso, você pode usar um plugin gratuito como o WPCode. Ele permite que você insira com segurança trechos de código em seu cabeçalho ou rodapé sem abrir um único arquivo de template.
Na verdade, usamos o WPCode em alguns de nossos sites parceiros. Ele mantém nossas personalizações seguras durante as atualizações de tema e evita que erros de código quebrem o site.
Se você estiver curioso sobre nossas experiências, confira nossa análise detalhada do WPCode.
O WPCode tem uma interface simples para colar seu código. Dessa forma, os arquivos do seu tema permanecem intocados e suas alterações ficam seguras durante as atualizações.
Por exemplo, veja como é fácil adicionar um script de rastreamento:
Usar plugins como este economiza tempo e reduz erros. É uma maneira mais segura de adicionar novos recursos ao seu site. Para mais detalhes, você pode ver nosso guia sobre como adicionar código no cabeçalho e rodapé do WordPress.
Perguntas Frequentes: Quais Arquivos Editar em Seu Tema do WordPress
Ainda não tem certeza por onde começar ou como evitar erros comuns? Aqui estão algumas respostas rápidas para perguntas frequentes sobre a edição de arquivos de tema do WordPress.
Por que não devo editar os arquivos do meu tema principal do WordPress?
Editar os arquivos do seu tema principal diretamente é arriscado porque quaisquer alterações que você fizer serão substituídas na próxima vez que o tema for atualizado. As atualizações do WordPress geralmente substituem toda a pasta do tema, o que significa que suas personalizações podem desaparecer sem aviso.
O que é um tema filho e por que ele é importante?
Um tema filho é um tema separado que herda a funcionalidade e o estilo de um tema pai. É a maneira mais segura de personalizar seu site porque mantém suas edições separadas dos arquivos do tema original. Dessa forma, você pode atualizar o tema pai com segurança sem perder suas alterações.
Posso pré-visualizar as alterações antes de publicá-las?
Com certeza. Usar um site de staging é uma das melhores maneiras de visualizar alterações sem afetar seu site ativo. Você também pode usar o Personalizador de Tema ou o Editor de Site Completo (se o seu tema suportar) para testar ajustes de design simples em tempo real antes de publicá-los.
Preciso de habilidades de codificação para editar arquivos de tema do WordPress?
Se você deseja editar diretamente arquivos de tema como header.php, functions.php ou single.php, então sim, um conhecimento básico de HTML, CSS e PHP é importante para evitar quebrar seu site.
No entanto, para personalizações simples como alterar cores, fontes ou layouts, muitos temas oferecem opções de personalização integradas no Personalizador de Tema ou no Editor de Site Completo. Você também pode usar construtores de página como SeedProd e Elementor para fazer alterações visuais sem mexer no código.
Existem ferramentas para me ajudar a encontrar qual arquivo de tema editar?
Sim! Ferramentas como o plugin What The File podem dizer exatamente qual arquivo de template está sendo usado em qualquer página. Você também pode consultar a hierarquia de templates do WordPress para entender como diferentes arquivos de tema são carregados dependendo do tipo de conteúdo que está sendo exibido.
Como adiciono CSS personalizado com segurança ao meu site WordPress?
Uma das maneiras mais fáceis de adicionar CSS personalizado é através do Personalizador de Tema em Aparência » Personalizar » CSS Adicional.
Alternativamente, você pode usar um plugin de trecho de código como o WPCode ou a folha de estilo de um tema filho. Esses métodos garantem que seus estilos não sejam perdidos durante as atualizações do tema, especialmente se você estiver usando um tema de Bloco onde o menu Personalizar pode estar oculto.
Recursos Adicionais: Mais Dicas e Truques para Temas do WordPress
Esperamos que este artigo tenha ajudado você a encontrar quais arquivos editar em seu tema do WordPress. Em seguida, você também pode querer ver nossos guias sobre:
- Como Usar o Personalizador de Temas do WordPress Como um Profissional
- Um Guia Completo para Iniciantes sobre Edição de Site Completo no WordPress
- Como Exibir Informações de Plugins e Temas no WordPress
- Guia Rápido de Desenvolvimento de Temas do WordPress
- Temas Gratuitos vs. Premium para WordPress (Prós e Contras para Proprietários de Sites)
Se você gostou deste artigo, por favor, inscreva-se em nosso Canal do YouTube para tutoriais em vídeo do WordPress. Você também pode nos encontrar no Twitter e no Facebook.
Dennis Muthomi
Eu aprecio particularmente sua ênfase em usar temas filhos para alterações extensas.
Este é um conselho crucial que muitos iniciantes negligenciam.
Na minha experiência, criar um tema filho me poupou inúmeras horas de frustração ao atualizar temas.
kzain
Existe alguma maneira de visualizar as alterações feitas nos arquivos do tema antes de publicá-las no site? Isso seria muito útil para evitar quaisquer interrupções não intencionais. Obrigado por fornecer conselhos tão claros e práticos!
Comentários WPBeginner
Uma opção seria usar um site de staging ou um servidor local para testar o tema antes que as alterações sejam publicadas.
Moinuddin Waheed
Esta é uma tarefa um pouco voltada para desenvolvedores, mas sim, às vezes nos deparamos com a questão de editar o arquivo e entramos no dilema de qual editar para fazer as alterações desejadas.
Eu costumava pensar que era sempre o arquivo functions.php que deveria ser alterado, mas não, a alteração deve ser feita onde é desejada.
Vou explorar o plugin para ver onde precisaremos fazer a edição e as alterações.
Obrigado por este guia tutorial. é realmente útil para entender melhor esses conceitos.
WPBeginner Support
You’re welcome
Admin
Jiří Vaněk
Obrigado pela dica. Às vezes, preciso fazer uma alteração em um site e não se sabe imediatamente qual arquivo editar. Este plugin pode ser um ótimo ajudante para descobrir qual arquivo de template está sendo usado no momento.
WPBeginner Support
Glad we could share this plugin
Admin
Riyaz
Instalar este plugin tornou minha vida mais fácil. No entanto, alguns dos temas apenas deixam algo como isto:
$has_sidebar = is_active_sidebar( ‘single-blog’ );
do_action( ‘mytheme_page_header’ );
e até algumas funções que não consigo encontrar em lugar nenhum:
mytheme_get_listings_image(‘mytheme-list’)
Existe alguma maneira de encontrar essas coisas?
WPBeginner Support
Você precisaria percorrer os arquivos manualmente, normalmente eles seriam encontrados no arquivo functions.php
Admin
mark Swift
Oi,
ótimo artigo,
mas e se os arquivos não estiverem disponíveis no tema filho que eu tenho que editar??
Cos
Se você copiar os arquivos de template (.php) para o seu tema filho (para que você possa editá-los e não perder suas alterações quando o tema for atualizado), o que acontece se o arquivo que você copiou e editou for atualizado pelo desenvolvedor do tema? Você então perde o benefício da atualização deles?
Susan Sheridan
Que tal esse mesmo tipo de ferramenta para descobrir quais folhas de estilo estão sendo aplicadas?
Bond Shands
Eu esperava usar essas instruções para alterar a linha de Endereço Postal dos Correios na parte inferior do meu blog. No entanto, instalar e ativar o plugin What The File não produziu resultados discerníveis. Nada de novo apareceu na minha Barra de Menu. Além disso, para ser honesto, suas instruções me deixaram no escuro sobre como eu veria o plugin exibido ao visualizar a página do blog que eu queria ver. (Além disso, já sou assinante por meio de um endereço de e-mail alternativo).
WPBeginner Support
Olá Bond Shands,
Cada site WordPress usa alguns templates que são carregados em cada página. Por exemplo, os templates de cabeçalho e rodapé. Para alterar seu endereço postal, você precisará editar o arquivo footer.php. No entanto, certifique-se de fazer backup do seu tema WordPress antes de fazer quaisquer alterações diretas.
Obrigado
Admin