Após nosso infográfico sobre como o WordPress funciona nos bastidores, vários usuários nos pediram para cobrir como um tema do WordPress funciona nos bastidores.
Neste artigo, explicaremos a hierarquia de templates do WordPress para iniciantes. Esta folha de referência é extremamente útil ao personalizar um template ou criar um tema personalizado do WordPress.
Dica Profissional: Quer criar landing pages personalizadas sem alterar seu tema do WordPress? Experimente o SeedProd, é o construtor de páginas arrastar e soltar para WordPress com a melhor classificação.
Por que Aprender Sobre a Hierarquia de Templates do WordPress?
Todos os temas modernos do WordPress consistem em templates, folhas de estilo, javascript e imagens. Juntos, esses arquivos controlam como seu site aparece para os usuários.
Relacionado: 9 coisas que você deve observar ao selecionar o tema perfeito do WordPress para o seu site.
O WordPress possui uma hierarquia de modelos padrão. Isso significa que modelos com nomes de arquivos específicos afetam áreas específicas do seu site. Ele também informa qual nome de modelo usar para um item específico.
A maioria dos temas modernos do WordPress vem com modelos para exibir categorias, datas, arquivos, posts individuais, páginas personalizadas e muito mais. Como usuário, você pode criar mais modelos criando um tema filho.
Dito isso, vamos dar uma olhada em como essa hierarquia de modelos do WordPress funciona nos bastidores.
Visualizando a Hierarquia de Modelos do WordPress (Folha de Dicas)
O WordPress usa um padrão fácil de entender e significativo para os nomes dos modelos. A folha de dicas visual abaixo explica quais arquivos de modelo são usados para exibir diferentes páginas em um site WordPress.
Aqui está um detalhamento de quais arquivos de modelo do WordPress editar para diferentes páginas em um site WordPress típico.
Quais arquivos de modelo são usados pela página inicial?
Por padrão, o WordPress exibe seus posts de blog na página inicial do seu site. Você também pode configurá-lo para usar uma página inicial personalizada (também conhecida como página de destino) visitando a página Configurações » Leitura na área de administração do WordPress.
1. front-page.php – Se você estiver usando uma página de destino estática, o WordPress procurará primeiro por este arquivo de modelo e o usará para exibir a página de destino.
2. home.php – Se você estiver usando uma página de destino estática e não tiver o modelo front-page.php em seu tema, o WordPress procurará o modelo home.php. Ele também é usado para exibir posts de blog padrão na página inicial.
3. index.php – Se front-page.php ou home.php não existirem, o WordPress recorrerá ao modelo index.php para exibir a página inicial. Este modelo é o modelo de fallback padrão no WordPress para exibir qualquer página.
Quais arquivos de modelo são usados por um post individual?
O WordPress procura por esses arquivos para exibir um post individual.
1. single-{post-type}-{slug}.php – Use este modelo para modificar a exibição de uma postagem individual específica em qualquer tipo de postagem. Por exemplo, se o tipo de postagem for 'review' e o slug da postagem for acme-phone, o WordPress procurará por single-review-acme-phone.php.
2. single-{post-type}.php – O WordPress verificará se há um modelo para exibir este tipo de postagem específico. Por exemplo, se o tipo de postagem for review, o WordPress procurará por single-review.php.
3. single.php – O WordPress então recorrerá a single.php.
4. singular.php – Este modelo adiciona outra opção de fallback para exibir um item único de qualquer tipo de postagem.
5. index.php – Finalmente, como mencionado acima, o WordPress recorrerá ao index.php.
Quais arquivos de modelo são usados pela página single?
Páginas do WordPress são um dos tipos de postagem padrão. Elas permitem que você crie páginas estáticas em seu site em vez de posts. Veja nosso guia sobre a diferença entre posts e páginas.
1. Modelo de Página Personalizado – O modelo de página atribuído à página. Veja como criar um modelo de página personalizado no WordPress.
2. page-{slug}.php – Se o slug da página for contato-us, o WordPress procurará usar page-contact-us.php.
3. page-{id}.php – Se o ID da página for 17, o WordPress procurará um arquivo de modelo chamado page-17.php.
4. page.php – O modelo para exibir todas as páginas estáticas.
5. singular.php – Este modelo é um fallback padrão para todos os itens de tipo de postagem única.
6. index.php – O modelo de fallback padrão.
Quais arquivos de modelo são usados por arquivos de categoria?
O WordPress usa esses arquivos para exibir páginas relacionadas a categorias no WordPress.
1. category-{slug}.php – Este modelo é usado para exibir a página de arquivo de categoria para uma categoria específica. Por exemplo, se o slug da categoria for reviews, o WordPress procurará o modelo category-reviews.php.
2. category-{id}.php – O WordPress então procura um modelo com o ID da categoria. Por exemplo, se o ID da categoria for 17, o WordPress procurará category-17.php.
3. category.php – Este é o modelo padrão para exibir todas as páginas de arquivo de categoria no WordPress.
4. archive.php – Este é o modelo padrão usado pelo WordPress para exibir quaisquer páginas de arquivo.
5. index.php – O modelo de fallback padrão.
Quais arquivos de modelo são usados por arquivos de tag?
O WordPress usa esses arquivos para exibir páginas de arquivo de tags.
1. tag-{slug}.php – Se o slug da tag for fruits, o WordPress procurará por tag-fruits.php.
2. tag-{id}.php – Se o ID da tag for 17, o WordPress procurará pelo template tag-17.php.
3. tag.php – O template padrão para arquivos de tags.
4. archive.php – O template padrão para qualquer página de arquivo.
5. index.php – O modelo de fallback padrão.
Quais arquivos de template são usados por arquivos de taxonomia personalizada?
Categorias e tags são duas taxonomias padrão do WordPress. Os usuários também podem criar suas próprias taxonomias personalizadas. Veja como o WordPress procura por templates para exibir páginas de taxonomia personalizada.
1. taxonomy-{taxonomy}-{term}.php – Se você tiver uma taxonomia personalizada chamada genre, e houver um termo 'thriller', o WordPress procurará por taxonomy-genre-thriller.php.
2. taxonomy-{taxonomy}.php – Se a taxonomia fosse genre, o WordPress procuraria por taxonomy-genre.php.
3. taxonomy.php – O template padrão para exibir quaisquer arquivos de taxonomia personalizada.
4. archive.php – O fallback padrão para todas as páginas de arquivo no WordPress.
5. index.php – O template de fallback padrão no WordPress.
Quais arquivos de template são usados por tipos de postagem personalizados?
Veja como o WordPress procura por templates para exibir arquivos de tipos de postagem personalizados.
1. archive-{post_type}.php – Se você tiver um tipo de postagem review, o WordPress procurará por archive-review.php.
2. archive.php – O template padrão para exibir todas as páginas de arquivo no WordPress.
3. index.php – O template de fallback padrão no WordPress.
Quais arquivos de template são usados para exibir arquivos de autor?
O WordPress gera páginas de arquivo para cada autor em seu site WordPress. Veja como fica para o template de arquivo de autor.
1. author-{nicename}.php – Se o nome amigável do autor for matt, o WordPress procurará por author-matt.php.
2. author-{id}.php – Se o ID de usuário do autor for 6, o WordPress procurará por author-6.php.
3. author.php – O template padrão usado para exibir páginas de arquivo de autor no WordPress.
4. archive.php – O template padrão para exibir todas as páginas de arquivo no WordPress.
5. index.php – O template de fallback padrão no WordPress.
Quais arquivos de template são usados para exibir arquivos baseados em data?
O WordPress também exibe suas postagens em páginas de arquivo baseadas em data para meses e anos. Veja como ficam os templates para essas páginas.
1. date.php – O template padrão para arquivos baseados em data.
2. archive.php – O template padrão usado para exibir páginas de arquivo de autor no WordPress.
3. index.php – O template de fallback padrão no WordPress.
Quais arquivos de template são usados para exibir páginas de busca?
1. search.php – A página padrão para exibir resultados de busca no WordPress.
2. searchform.php – O template para exibir um formulário de busca no WordPress.
3. index.php – O template de fallback padrão no WordPress.
Quais arquivos de template são usados para exibir páginas de erro 404?
A página de erro 404 é exibida quando o WordPress não consegue encontrar o conteúdo solicitado. Veja nosso guia sobre como melhorar seu template de página 404.
1. 404.php – O template padrão para exibir a página de erro 404 no WordPress.
2. index.php – O template de fallback padrão no WordPress.
Quais arquivos de template são usados para exibir páginas de anexos?
1. MIME_type.php – Mime_type significa tipo de arquivo. Por exemplo, image.php, video.php, application.php.
2. attachment.php – O template padrão para exibir páginas de anexos.
3. single-attachment.php – Para exibir um único anexo.
4. single.php – O template padrão para exibir itens de post type únicos.
5. index.php – O template de fallback padrão no WordPress.
Quais arquivos de template são usados para exibir embeds?
Desde o WordPress 4.5, você pode usar templates para renderizar um post incorporado no WordPress.
1. embed-{post-type}-{post_format}.php – O WordPress procurará primeiro por um template de post type e formato de post. Por exemplo, se você tiver uma avaliação em vídeo, o WordPress procurará por embed-review-video.php.
2. embed-{post-type}.php – Se o post type for review, o WordPress procurará por embed-review.php.
3. embed.php – O fallback padrão para todos os embeds.
Esperamos que este tutorial tenha ajudado você a aprender sobre a hierarquia de modelos do WordPress. Você também pode querer ver nossa lista dos melhores construtores de páginas WordPress drag & drop.
Se você gostou deste artigo, então 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 Facebook.
Mrteesurez
Este é um post bem detalhado, contém todos os modelos essenciais. Estou descobrindo novos nomes de modelos e hierarquia aqui, pois eu só conhecia poucos deles antes.
Obrigado, é útil para nós que estamos em desenvolvimento.
Moinuddin Waheed
Eu uso o WordPress há vários anos e conhecia apenas alguns arquivos e pensava que esses eram os únicos arquivos por trás das cortinas.
Esta é uma descrição muito perspicaz e detalhada da estrutura de modelos de todos os arquivos.
A infografia é autoexplicativa e ajuda a entender qual arquivo usa quais outros arquivos para exibir o conteúdo.
Obrigado pelo guia detalhado da estrutura de arquivos do WordPress.
WPBeginner Support
Glad we could clarify how the template hierarchy works
Admin
Jiří Vaněk
Eu vi os arquivos de modelo no FTP, mas eu só conhecia a função deles, como função, cabeçalho, rodapé, e é só isso. Eu realmente não sabia muito sobre o resto dos arquivos. Sua infografia é perfeita. Ela faz um ótimo trabalho mostrando como os arquivos individuais estão vinculados e para que o próprio WordPress os utiliza. Uma pessoa tem uma compreensão muito melhor da estrutura de como o modelo funciona e, em seguida, é muito mais fácil fazer, por exemplo, algumas modificações no código-fonte, se necessário. Embora eu ainda não entenda tudo, tentarei revisar os arquivos individuais do meu modelo e descobrir muito mais sobre como tudo funciona. Obrigado por este tutorial abrangente.
mjasia
Olá
E os atributos de produto do WooCommerce?
Como eles são exibidos?
WPBeginner Support
Dependeria do seu tema específico para a forma como eles são exibidos, mas eles são tratados de forma semelhante a campos personalizados, você pode ver mais sobre campos personalizados em nosso artigo abaixo:
https://www.wpbeginner.com/wp-tutorials/wordpress-custom-fields-101-tips-tricks-and-hacks/
Admin
Connie
e quanto aos arquivos de idioma em temas filhos?
Este é um dos grandes mistérios do WP porque ainda há pessoas (a maioria!) que precisam de arquivos de tradução para que sua instalação fique em seu idioma ;=)
WPBeginner Support
That would be a subject for a different guide
Admin