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
Temas WordPress consistem em vários arquivos. Isso inclui arquivos de modelo, tags e funções de modelo personalizadas, partes de modelo, imagens, JavaScript e arquivos CSS.
Todos os melhores temas WordPress seguem as melhores práticas oficiais. Isso significa que eles organizam todo o código usando a estrutura padrão de arquivos e modelos.
Por exemplo, todos os temas WordPress têm archive.php, single.php, functions.php e outros arquivos.
Cada arquivo é usado como um modelo para exibir uma área específica do seu site WordPress.
Por exemplo, o modelo single.php exibe posts individuais. Enquanto isso, o modelo page.php exibe uma página individual.
Compreender a hierarquia de templates do WordPress oferece um melhor entendimento de como o WordPress funciona. Se você precisar adicionar ou editar código em 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 Temas 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: Por favor, tenha em mente que este plugin está um pouco desatualizado e não foi testado com as atualizações mais recentes do WordPress. No entanto, nós o testamos em nossos sites de staging recentemente e descobrimos que ele ainda funciona perfeitamente.
Se você tiver preocupações, recomendamos consultar 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.
Alterações diretas no seu tema do WordPress não são recomendadas. Essas alterações serão apagadas quando você atualizar seu tema.
Fazer alterações diretas no seu tema do WordPress também é uma má ideia. Isso porque essas alterações desaparecerão quando você atualizar seu tema.
Se você só precisa adicionar algum CSS, pode fazer isso como CSS personalizado no WordPress.
Para alterações mais extensas nos seus arquivos de tema, você deve criar um tema filho. O plugin 'What The File' pode ajudá-lo a localizar os arquivos de tema que você precisa copiar e editar no 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 vinculará a um site externo. Você só deve usar este plugin 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ê não precisa editar seus arquivos de tema para adicionar funcionalidades ao seu site WordPress.
Por exemplo, você pode querer apenas adicionar código personalizado à área de cabeçalho ou rodapé do seu site para inserir scripts de rastreamento ou códigos de verificação.
Nesses casos, você pode usar plugins para adicionar trechos de código sem editar os arquivos de tema, como o WPCode.
Usamos o WPCode para gerenciar trechos de código em vários dos nossos sites, e nós adoramos. 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, aqui adicionamos um código de rastreamento personalizado no cabeçalho do nosso site de demonstração:
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? Estas perguntas frequentes podem ajudá-lo a tomar decisões mais inteligentes e seguras ao personalizar seu 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 trechos de código como o WPCode ou a folha de estilos de um tema filho. Esses métodos garantem que seus estilos não serão perdidos durante as atualizações do tema.
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
- How to Add a Parallax Effect to Any WordPress Theme
- Como Adicionar um Efeito de Rolagem Suave para o Topo no WordPress Usando jQuery
- O Que é um Framework de Tema do WordPress?
- Guia Rápido de Desenvolvimento de Temas do WordPress
- Classes CSS Geradas pelo WordPress para Estilizar Seus Temas
- Temas Gratuitos vs. Premium para WordPress (Prós e Contras para Proprietários de Sites)
- Melhores Temas Simples do WordPress que Você Deveria Experimentar
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