Hierarquia de modelos

A hierarquia de modelos do WordPress é o sistema que ele usa para determinar quais arquivos de modelo devem ser usados ao exibir uma determinada página em um site. Essa hierarquia permite grande flexibilidade e personalização de como diferentes tipos de conteúdo, páginas, posts e categorias são exibidos em seu site. Entender como funciona a hierarquia de modelos o ajudará a personalizar seu tema do WordPress de forma eficaz.

Aqui está uma visão detalhada de como funciona a hierarquia de modelos do WordPress:

O que é a hierarquia de modelos do WordPress?

A hierarquia de modelos é um conjunto de regras que o WordPress segue para escolher qual(is) arquivo(s) de modelo deve(m) ser usado(s) ao renderizar uma página. Esses modelos são armazenados na pasta do seu tema e permitem que o WordPress gere dinamicamente o layout e o design corretos com base no tipo de conteúdo que está sendo exibido.

Por exemplo:

• Ao exibir uma única postagem de blog, o WordPress procurará primeiro um modelo chamado single.php. Se não o encontrar, ele se desloca para baixo na hierarquia, procurando alternativas como index.php.
• Ao exibir uma página de categoria, o WordPress procurará primeiro category-slug.php ou category-ID.php, e assim por diante.

Arquivos de modelo básicos no WordPress

Todo tema do WordPress tem alguns arquivos de modelo essenciais. Aqui estão os mais comuns:

• index.php: O modelo de fallback para todas as páginas se não houver outros modelos mais específicos disponíveis.
• header.php: Define a seção de cabeçalho do seu site (por exemplo, logotipo, navegação).
• footer.php: Define a seção de rodapé do seu site (por exemplo, informações de direitos autorais, widgets de rodapé).
• single.php: Exibe posts de blog únicos.
• page.php: Exibe páginas individuais.
• archive.php: Exibe páginas de arquivo (por exemplo, categorias, tags, autores).
• category.php: Exibe páginas de arquivo de categoria.
• tag.php: Exibe páginas de arquivo de tags.
• search.php: Exibe as páginas de resultados de pesquisa.
• 404.php: Exibe uma página de erro 404 quando uma página não é encontrada.

Como funciona a hierarquia de modelos do WordPress

O WordPress determina o modelo a ser usado com base no tipo de conteúdo que está sendo solicitado. Vamos examinar alguns tipos comuns de páginas e como o WordPress seleciona o modelo:

1. Postagem única (single.php)

Ao exibir uma única postagem, o WordPress procurará os seguintes modelos, nesta ordem:

1. single-{post-type}.php (para tipos de post personalizados, por exemplo, single-product.php)
2. single.php
3. index.php

2. Página (page.php)

Ao exibir uma página individual (como uma página Sobre nós ou Contato), o WordPress seguirá esta ordem:

1. custom-page-slug.php (se a página tiver um modelo personalizado)
2. page-{slug}.php (por exemplo, page-about.php)
3. page-{ID}.php (por exemplo, page-2.php)
4. page.php
5. index.php

3. Arquivo de categorias (category.php)

Para páginas de arquivo de categoria (por exemplo, uma lista de publicações em uma categoria específica), a hierarquia é a seguinte:

1. category-{slug}.php (por exemplo, category-news.php)
2. category-{ID}.php (por exemplo, category-3.php)
3. category.php
4. archive.php
5. index.php

4. Arquivo de tags (tag.php)

Para páginas de arquivo de tags, o WordPress usa:

1. tag-{slug}.php (por exemplo, tag-recipes.php)
2. tag-{ID}.php
3. tag.php
4. archive.php
5. index.php

5. Tipos de post personalizados

Os tipos de post personalizados podem ter seus próprios modelos. O WordPress procura por:

1. single-{post-type}.php (por exemplo, single-product.php)
2. single.php
3. index.php

Da mesma forma, para arquivos de tipos de post personalizados:

1. archive-{post-type}.php (por exemplo, archive-product.php)
2. archive.php
3. index.php

6. Arquivo de autores (author.php)

Para páginas de autor, o WordPress segue esta hierarquia:

1. author-{nicename}.php (por exemplo, author-john.php)
2. author-{ID}.php
3. author.php
4. archive.php
5. index.php

7. Resultados da pesquisa (search.php)

Ao exibir os resultados da pesquisa, o WordPress usa a seguinte ordem:

1. search.php
2. index.php

8. página de erro 404 (404.php)

Quando uma página não é encontrada, o WordPress usa:

1. 404.php
2. index.php

9. Arquivo de datas (date.php)

Para arquivos baseados em datas, o WordPress usa:

1. date.php
2. archive.php
3. index.php

10. Página inicial

O WordPress oferece duas opções para a página inicial: o índice do blog ou uma página estática.

• Para o índice do blog:
  1. home.php
  2. index.php
• Para uma página inicial estática:
  1. front-page.php
  2. home.php
  3. page.php
  4. index.php

Representação visual da hierarquia de modelos

Veja a seguir um fluxo visual simplificado para entender melhor a hierarquia:

• Postagem única: single-{post-type}.php → single.php → index.php
• Página: custom-page-slug.php → page-{slug}.php → page.php → index.php
• Arquivo de categorias: category-{slug}.php → category.php → archive.php → index.php
• Arquivo de tags: tag-{slug}.php → tag.php → archive.php → index.php
• Arquivo de autores: author-{nicename}.php → author.php → archive.php → index.php
• Resultados da pesquisa: search.php → index.php
• erro 404: 404.php → index.php
• Página inicial: front-page.php → home.php → index.php

Personalização da hierarquia de modelos

Você pode criar modelos personalizados seguindo as convenções de nomenclatura da hierarquia. Por exemplo, para criar um modelo personalizado para uma categoria específica (por exemplo, “Notícias”), crie um arquivo chamado category-news.php e coloque-o na pasta do tema. O WordPress usará automaticamente esse modelo ao exibir publicações da categoria “Notícias”.

Além disso, você pode substituir os modelos padrão criando arquivos de modelo mais específicos, como single-product.php para um tipo de post personalizado ou page-about.php para uma página específica.

Dicas para trabalhar com a hierarquia de modelos

1. Use tags condicionais: Você pode usar tags condicionais como is_single(), is_page() ou is_category() no index.php ou em outros modelos para aplicar um código específico a determinados tipos de conteúdo.
2. Partes do modelo: Use get_template_part() para incluir trechos de código reutilizáveis (por exemplo, um cabeçalho ou rodapé comum) em vários modelos.
3. Temas filhos: Se estiver fazendo alterações em um tema existente, crie um tema filho para poder modificar os modelos sem afetar os arquivos do tema original.
4. Depuração: Se não tiver certeza de qual modelo o WordPress está usando para uma determinada página, você pode usar plug-ins como What The File para descobrir.

Conclusão

A hierarquia de modelos do WordPress é um sistema poderoso que oferece aos desenvolvedores flexibilidade para criar layouts personalizados para vários tipos de conteúdo. Ao compreender a hierarquia, você pode controlar como o seu site WordPress exibe diferentes tipos de conteúdo, garantindo uma experiência de usuário consistente e exclusiva. Seja criando modelos personalizados para páginas específicas ou personalizando layouts de arquivos, o domínio da hierarquia de modelos lhe dará o controle necessário para ajustar o seu site WordPress.