Tableless

Busca Menu

Hierarquia de arquivos do WordPress

Seja o primeiro a comentar por

Para criar um bom theme para WordPress, você precisa conhecer bem a estrutura de arquivos que são utilizados no construir estes themes. São usados vários arquivos que setorizam as várias funcionalidades do blog ou site. Veja abaixo arquivos que são normalmente utilizados:

  • Página de Erro 404 – 404.php
  • Histórico e Arquivo – archive.php
  • Index de Histórico e Arquivo – archives.php
  • Página de uma Categoria – category.php
  • Comentários – comments.php
  • Rodapé – footer.php
  • Cabeçalho – header.php
  • Links – links.php
  • Home e Principal – index.php
  • Páginas – page.php
  • Post – single.php
  • Formulário de busca – searchform.php
  • Resultados de busca – search.php
  • Sidebar – sidebar.php
  • Stylesheet – style.css

O WordPress usa as Query String de cada link do seu site para saber qual arquivo ele deve mostrar na página. Ele decide qual tipo de página será requisitada – uma página de busca, categoria, a home etc.
Ele procura esses arquivo dentro do diretório do seu template. Caso o WP não encontre o arquivo requisitado, ele escolhe o template padrão do index.php para ser usado. Há uma hierarquia de arquivos de template que o WordPress irá requisitar caso ele não encontre o correto.

Por exemplo: imagine que seu visitante clique em um link de seu site que o leve para dentro de uma categoria. O WordPress irá procurar o arquivo referente a categoria personalizada. Suponha que o ID da categoria seja 40, ele procuraria o arquivo category-40.php, que é o arquivo que personaliza a página desta categoria. Caso ele não o encontre, o WordPress procura pelo arquivo genérico que gera as páginas de categorias, no caso o category.php. Contudo, se ele não encontrá-lo também, ele procurará o archive.php que é o documento que gera as páginas de históricos e arquivos. Caso ele também não o encontre, ele irá utilizar o arquivo principal index.php
Assim, seu sistema/blog/site não fica com erros por não encontrar um determinado documento.

Abaixo segue a hierarquia de alguns arquivos. Você pode ver muito mais detalhes aqui.

Home Page
  1. home.php
  2. index.php
Visualizando o post
  1. single.php
  2. index.php
Páginas
  1. nomedapagina.php – Seria um arquivo para uma página especifica personalizada
  2. page.php
  3. index.php
Category display
  1. category-id.php – Categoria específica, onde o ID é o número de identificação da categoria
  2. category.php
  3. archive.php
  4. index.php
Histórico
  1. date.php
  2. archive.php
  3. index.php
Tag
  1. tagslug.php – Arquivo personalizado para uma tag específica
  2. tag.php
  3. archive.php
  4. index.php
404
  1. 404.php
  2. index.phpc

Na documentação do WordPress há um diagrama muito esclarecedor:
template_hierarchy

Muitos desenvolvedores por aí, aconselham que você comece seu theme a partir de um já pronto. Eu já vou além e sugiro que você comece fazendo os arquivos à medida em que for precisando dos arquivos. Assim você evita grandes quantidade de documentos inúteis na pasta do seu template. Isso é muito importante caso você esteja fazendo um site, por exemplo. Quanto mais organizado e menor a quantidade de arquivos, melhor. Mesmo assim, não atole todas as funções no index.php. Divida cuidadosamente as seções do site para não haver confusão em apenas um arquivo.

É possível saber quais os arquivos você precisará utilizar em seu template logo quando recebemos os documentos em HTML. Você pode utilizá-los como base para a criação dos arquivos dos templates. É a melhor maneira de começar criando um theme do zero.

No site do WordPress há outras muitas informações importantes sobre a Hierearquia dos Arquivos.

Publicado no dia