O Que é a Hierarquia de Templates do WordPress e Como Funciona?

Se deseja desenvolver temas, é crucial compreender a hierarquia de templates do WordPress. O CMS utiliza arquivos de template para exibir conteúdo no front-end, por isso, dominar os fundamentos da hierarquia do WordPress é vital para personalizar ou criar temas do zero.

Embora criar um tema no WordPress não seja uma tarefa complexa, entender o básico é essencial. Além de uma hospedagem WP segura, domínio, tema e plugins, é importante conhecer a hierarquia de templates. Neste artigo, abordamos como funciona a hierarquia de templates do WordPress, a estrutura das páginas e os arquivos de template, para que você possa começar a construir e personalizar temas com confiança. Vamos começar!

O que é a Hierarquia de Templates do WordPress?

A hierarquia de templates do WordPress é o sistema que determina quais templates serão utilizados e em qual ordem ao exibir uma página web. Em termos técnicos, ela utiliza strings de consulta para percorrer a hierarquia até encontrar o primeiro template adequado. Isso permite que desenvolvedores web criem layouts personalizados para diferentes tipos de conteúdo, dando prioridade a arquivos de template específicos em relação aos mais genéricos.

Se o WordPress não encontrar um template específico, ele continuará na hierarquia até encontrar o primeiro arquivo utilizável. Compreender e utilizar essa hierarquia oferece maior flexibilidade e controle sobre a aparência e funcionalidade de um site WordPress.

Sites estáticos geralmente utilizam HTML e CSS para renderizar o conteúdo no front-end. No entanto, o WordPress, como uma plataforma dinâmica, é baseado na linguagem de programação PHP. Cada site WordPress carrega uma série de arquivos PHP, cada um responsável por definir como diferentes partes da página serão exibidas.

Sempre que carrega uma aplicação web, o Sistema de Gerenciamento de Conteúdo busca pelos arquivos de template. Por exemplo, ao utilizar a função de busca do WordPress, o CMS procura por dois arquivos de template específicos.

1. Search.php determina como suas páginas de busca serão exibidas.
2. Index.php é o arquivo de template padrão que o WordPress usa quando não consegue identificar a opção principal dentro de uma hierarquia.

O que são Arquivos de Template do WordPress?

Os arquivos de template são fundamentais na arquitetura do WordPress. Eles determinam como o conteúdo será exibido em posts, páginas e outras áreas do site. A hierarquia de templates do WordPress é incorporada em cada tema ou layout que você utiliza. Temas clássicos do WordPress normalmente utilizam arquivos PHP, que combinam códigos HTML e PHP. Já os temas modernos baseados em blocos utilizam exclusivamente arquivos HTML.

A maioria dos sites WordPress necessita de diversos arquivos de template para apresentar o conteúdo de maneira adequada. A seguir, estão os sete arquivos de template mais utilizados que você deve conhecer:

1. Index.php
2. Header.php
3. Footer.php
4. Sidebar.php
5. Functions.php
6. Comments.php
7. Single.php

Posts de blog geralmente utilizam o arquivo single.php como o template padrão para a exibição de conteúdo, enquanto o cabeçalho, rodapé e barra lateral em páginas individuais utilizam seus próprios arquivos .php. Esses três últimos arquivos são conhecidos como templates parciais, pois podem ser reutilizados para compor outros templates. Vamos explorar isso mais adiante.

Entendendo Como Funciona a Hierarquia de Templates

Um tema típico do WordPress é composto por vários templates, e a plataforma precisa determinar qual deles utilizar ao exibir o conteúdo. Por isso, alguns arquivos de template têm prioridade sobre outros. Essa é a base da hierarquia de templates.

Templates de alta prioridade atuam como uma reserva caso o WordPress não consiga encontrar um template específico definido pelo usuário. Quando um usuário solicita a visualização de uma página, o WordPress tentará localizar o template adequado. Se não conseguir, ele usará a hierarquia para identificar o próximo template mais apropriado.

Por exemplo, ao tentar carregar uma página da web, como a de uma categoria de hospedagem compartilhada, é isso que ocorre nos bastidores.

• O WordPress procurará um arquivo de template chamado “category-shared-hosting.php” dentro do diretório do tema instalado.
• Se não conseguir localizar o arquivo, o WordPress começará a buscar pelo ID da categoria em vez disso. Por exemplo, “category-2.php.”
• Caso não encontre nenhum dos arquivos de template, o WordPress procurará por um arquivo genérico “category.php.”
• A busca não termina aí, pois o próximo da fila é o arquivo “archive.php.”
• Se tudo falhar, o WordPress usará o arquivo “index.php” do seu tema como o template padrão.

Cada site WordPress é composto por diversas categorias, cada uma com sua própria hierarquia de templates para garantir uma navegação fluida e acesso rápido. Um site típico pode ser organizado em sete tipos principais de templates. Vamos explorar cada um deles em mais detalhes.

Página Inicial

A página inicial, ou homepage, é a principal porta de entrada de um site, sendo o ponto de acesso inicial para a maioria dos visitantes. A hierarquia da página inicial geralmente inclui três arquivos de template: front-page.php, home.php e index.php. O WordPress segue essa ordem hierárquica quando um usuário solicita a visualização da página inicial do seu site.

Posts Únicos

Há três arquivos de template principais para posts individuais, como blogs e artigos: single.php, singular.php e index.php. No entanto, devido à possibilidade de tipos de posts personalizados no site, o WordPress procura outros dois arquivos de template antes de recorrer a esses. Dessa forma, a hierarquia de templates é organizada da seguinte maneira.

1. Single-{post-type}-{slug}.php
2. Single-{post-type}.php
3. Single,php
4. Singular.php
5. Index.php

Páginas Únicas

Cada página num site WordPress, com exceção da página inicial, é classificada como uma página única. A hierarquia de templates segue um padrão similar ao dos posts individuais, com a adição de um arquivo de template personalizado opcional. Vamos explorar essa hierarquia.

1. (Custom template file)
2. Page-{slug}.php
3. Page-{id}.php
4. Page.php
5. Singular.php
6. Index.php

Páginas de Categoria

A hierarquia de templates para categorias opera de maneira semelhante à das páginas únicas. Por exemplo, ao invés de procurar pelo slug da página seguido pelo ID, o WordPress buscará primeiro pelo slug e ID da categoria, antes de verificar os arquivos category.php, archive.php e index.php.

Tipos de Post Personalizados

Se estiver a utilizar um plugin de tipos de post personalizados no WordPress ou se o seu tema tiver essa funcionalidade integrada, o CMS buscará primeiro o arquivo de arquivamento específico do tipo de post antes de recorrer aos arquivos archive.php e index.php padrão do tema. Por exemplo, ao procurar pelo tipo de post personalizado “produto”, a hierarquia de templates seguirá a seguinte ordem:

1. Archive-{post_type}.php
2. Archive.php
3. Index.php

Páginas de Resultados de Pesquisa

Atualmente, a maioria dos temas WordPress possui uma função de busca integrada, que exige o template search.php para exibir a página de resultados de pesquisa. Se o seu site utiliza a busca como uma funcionalidade essencial, é importante garantir que o tema WordPress escolhido inclua um template para a página de busca. Se você está começando no desenvolvimento web e precisa de orientação para escolher um bom tema WordPress, pode aprender como selecionar um tema WordPress adequado aqui.

Páginas de Erro 404

Quando os usuários digitam incorretamente uma URL ou tentam acessar uma página inexistente, o WordPress exibe uma página de erro 404. A hierarquia de templates do WordPress é relativamente simples: o CMS procura primeiro o arquivo 404.php e, na sua ausência, recorre ao index.php. A maioria dos temas WordPress inclui um arquivo 404.php padrão, mas, caso o seu tema não o tenha, é altamente recomendável criar um template personalizado para a página de erro.

Conclusão

A hierarquia de templates do WordPress descreve como o CMS procura arquivos ao carregar uma página da web. Conhecer a hierarquia de templates do seu site pode ser útil para otimizar os resultados de pesquisa e diminuir os tempos de carregamento, o que melhora a experiência do usuário. Não se preocupe com os detalhes logo de início. Comece aos poucos e familiarize-se com o processo por meio da prática.