A Hierarquia de Modelos do WordPress

Jun 30, 2021
admin

TemasWordPress permitem alterar o design do seu site, proporcionando controle sobre a aparência e a sensação. Eles são essencialmente coleções de diferentes arquivos de modelos que trabalham juntos e produzem o design geral do seu site.

Antes de aprofundar os temas do WordPress, é importante que você tenha uma compreensão de como o WordPress funciona e como as diferentes páginas do seu site são criadas. O WordPress interage com um banco de dados para armazenar seu conteúdo. Isso significa que sempre que você cria um novo post ou página, o conteúdo do seu post ou página vive em uma base de dados e só é exibido usando templates quando o visitante pede esse conteúdo em particular.

Um tema WordPress é uma coleção de templates (arquivos CSS e PHP) que o WordPress usa para exibir o conteúdo da base de dados. O WordPress irá procurar arquivos em um tema para usar para renderizar a página atual em uma ordem específica. Isso é chamado de ‘hierarquia de modelos’, que é usado para criar e estender os temas do WordPress.

Temas do WordPress decidem como o seu conteúdo deve ser exibido no seu site. Um template no WordPress é um único arquivo que determina como uma página específica ou conjunto de páginas deve ser exibido no front end do seu site. Quando você muda seu tema, você está mudando a maneira como o conteúdo é exibido sem alterar o conteúdo em si.

WordPress temas utilizam diferentes arquivos de templates para gerar uma página web completa. Por exemplo, quando você acessa um site do WordPress, você pode realmente ver vários arquivos de modelos diferentes combinados para criar uma página completa.

Por exemplo, se você olhar para uma página de índice, como a página inicial de um blog, você geralmente verá um cabeçalho criado pelo modelo header.php, conteúdo criado por index.php, sidebar criado por sidebar.php e o rodapé criado por footer.php

Um Tema Básico do WordPress

No entanto, se você acessar uma única página, você ainda verá o mesmo cabeçalho, a mesma barra lateral e o mesmo rodapé, mas o conteúdo seria criado por single.php em seu lugar. A questão é como você sabe quais desses arquivos de template entram em ação e em que momento? É aí que entra a hierarquia de modelos do WordPress.

A hierarquia de modelos do WordPress determina em que ordem seus arquivos de modelos são carregados dentro do seu tema do WordPress. O WordPress pesquisa esses arquivos, para determinar como carregar seu site.

Se você abrir a pasta de temas ‘Twenty Fifteen’ (um dos temas padrão do WordPress), existem mais de 15 arquivos de modelos. Estes incluem arquivos de template para 404, arquivo, autor-bio, comentários e link de conteúdo, apenas para citar alguns. O WordPress usará as informações da Query String contidas em cada link do seu site para decidir qual modelo ou conjunto de modelos será usado para exibir a página.

WordPress decide que tipo de página (página de pesquisa, página de categoria ou página inicial, por exemplo) está sendo solicitada e então escolhe o modelo apropriado sugerido pela hierarquia de modelos do WordPress para gerar o conteúdo.

Naming Convention

WordPress tem uma convenção de nomenclatura especial e rigorosa associada a arquivos de temas, assim todos os temas compartilham um conjunto de arquivos com nomes bastante comuns no back end. Por exemplo, para gerenciar facilmente seu conteúdo você pode criar arquivos header.php e footer.php. Estes ficheiros de template devem ser nomeados com os nomes header.php e footer.php.

WordPress procura ficheiros de template com nomes específicos no directório do tema actual para determinar qual o template a utilizar, sendo mais comum utilizar o primeiro ficheiro de template correspondente. Se o WordPress não conseguir encontrar um ficheiro de modelo com um nome correspondente, ele salta para o nome do ficheiro seguinte na hierarquia. Se o WordPress não encontrar nenhum arquivo de template correspondente, ele usará index.php (o arquivo de template da página inicial do tema).

Então, quando você estiver editando arquivos de template, o que você tem que pensar é sobre o tipo de conteúdo, então edite o arquivo de template apropriado para esse tipo de conteúdo. O mesmo se aplica quando você está criando temas do WordPress do zero.

Requisitos Mínimos do Tema

Os únicos arquivos necessários para um tema do WordPress funcionar são index.php e style.css. O index.php é o principal e único arquivo que irá processar cada consulta do WordPress, assim como a estrutura do site.

Os arquivos mínimos necessários para um tema WordPress funcionar e estar visível no painel de controle do WordPress para ativação são index.php e style.css.

Se index.php ou style.css estiverem faltando, você verá o seguinte erro.

Os seguintes temas estão instalados mas estão incompletos. Os temas devem ter uma folha de estilo e um modelo.

  • style.css (obrigatório)

  • index.php (obrigatório)

  • functions.php (opcional)

  • screenshot.png (opcional)

Esta separação aumenta muito a eficiência. Combinando tudo em um grande arquivo único index.php poderia tecnicamente funcionar, mas não seria bonito, e causaria problemas intermináveis no final da linha. Também editar um tema seria um pesadelo!

Aqui está a lista dos arquivos de temas reconhecidos pelo WordPress.

  • style.css

  • rtl.css

  • index.php

  • comments.php

  • front-page.php

  • single.php

  • page.php

  • >

  • >author.php

  • archive.php

Há muitos outros ficheiros também, você pode ver a lista de arquivos modelo para mais detalhes.

Vinte Quinze Hierarquia de Modelos Exemplo

Suponha que você tenha ativado o tema Vinte Quinze e um usuário visite a página yoursite.com/author/tahir/. Primeiro, o WordPress irá procurar pelo template rotulado author-tahir.php mas author-tahir.php não está disponível. O WordPress procurará então por author.php, se ele também não existir, procurará por archive.php. Este arquivo está disponível em Twenty Fifteen theme. Se você excluir ou renomear archive.php, então o WordPress usará index.php para renderizar a página.

A cada vez que um usuário visitar seu site, o WordPress subirá a hierarquia de modelos até encontrar um arquivo de modelo que corresponda. Isso tem tudo a ver com a forma como esses arquivos são nomeados.

O Plugin ‘What The File’ Plugin

Para descobrir qual arquivo e modelo o WordPress está usando para exibir o conteúdo da página que você está visualizando atualmente, você pode usar o muito útil What The File Plugin. Este é um plugin gratuito desenvolvido por Barry Kooij.

Este plugin adiciona uma opção à sua barra de ferramentas mostrando qual arquivo e modelos estão sendo usados. Eu instalei o ‘What The File Plugin’ para fins de teste no meu servidor local e achei que funcionava muito bem.

Para testar quais arquivos o WordPress usa se um arquivo específico não está disponível, renomeei dois arquivos (no Twenty Fifteen Theme). Na captura de tela abaixo você pode ver quais arquivos o WordPress usa para exibir o conteúdo.

The What The File Plugin

Você pode ver o tema Twenty Fifteen usa o arquivo content-search.php para exibir os resultados da pesquisa. Se você excluir ou renomear content-search.php, o WordPress irá usar content.php para exibir os resultados da pesquisa em seu lugar.

O plugin ‘What The File’ também permite que você clique no nome do arquivo diretamente para editá-lo através do editor de temas. Este plugin requer WordPress 3.1 ou superior, ele funciona bem com WordPress 4.1 também.

Recursos Úteis

Deixe uma resposta

O seu endereço de email não será publicado.