{"id":41147,"date":"2021-01-04T04:24:33","date_gmt":"2021-01-04T12:24:33","guid":{"rendered":"https:\/\/kinsta.com\/?p=85856&preview=true&preview_id=85856"},"modified":"2025-02-14T09:10:37","modified_gmt":"2025-02-14T12:10:37","slug":"hierarquia-modelos-wordpress","status":"publish","type":"post","link":"https:\/\/kinsta.com\/pt\/blog\/hierarquia-modelos-wordpress\/","title":{"rendered":"Um Guia para a Hierarquia de Modelos do WordPress"},"content":{"rendered":"

Se voc\u00ea quiser personalizar os temas<\/a> ou construir novos a partir do zero, \u00e9 importante entender como funciona a hierarquia de modelos do WordPress.<\/p>\n

Antes de mais nada, este sistema WordPress ajuda a manter tudo organizado. Quando voc\u00ea souber quais s\u00e3o todos os arquivos de modelos de temas, o que eles fazem e como s\u00e3o priorizados, voc\u00ea conseguir\u00e1 alterar quase todos os aspectos de como seu site WordPress fica.<\/p>\n

Neste artigo, vamos explicar o que \u00e9 a hierarquia de modelos do WordPress e como ela funciona. Em seguida, forneceremos uma descri\u00e7\u00e3o completa dos arquivos de modelo envolvidos em cada tipo de p\u00e1gina do WordPress (incluindo uma folha de consulta para refer\u00eancia), para ajud\u00e1-lo a us\u00e1-los em seu benef\u00edcio.<\/p>\n

Vamos nessa!<\/p>\n

<\/div><\/kinsta-auto-toc>\n

Uma Introdu\u00e7\u00e3o \u00e0 Hierarquia de Modelos do WordPress<\/h2>\n

Tipicamente, os sites n\u00e3o-din\u00e2micos utilizam arquivos HTML e CSS est\u00e1ticos<\/a> para renderizar seu conte\u00fado. Entretanto, o WordPress \u00e9 uma plataforma din\u00e2mica baseada na linguagem de programa\u00e7\u00e3o PHP<\/a>. Cada site WordPress carrega m\u00faltiplos arquivos .php<\/em>, cada um deles governando a apar\u00eancia de uma se\u00e7\u00e3o ou componente espec\u00edfico.<\/p>\n

Sempre que voc\u00ea carrega um determinado tipo de p\u00e1gina, o Content Management System (CMS)<\/a> procura os arquivos modelo que correspondem a ele.<\/p>\n

Por exemplo, se voc\u00ea usar recurso de pesquisa do WordPress<\/a> e carregar uma p\u00e1gina de resultados de pesquisa, o CMS ir\u00e1 procurar por dois arquivos modelo:<\/p>\n

    \n
  1. search.php<\/em>, que rege a apar\u00eancia de suas p\u00e1ginas de resultados de pesquisa<\/li>\n
  2. index.php<\/em>, que \u00e9 o arquivo modelo padr\u00e3o que o WordPress usa quando n\u00e3o consegue encontrar a op\u00e7\u00e3o superior dentro de cada hierarquia<\/li>\n<\/ol>\n

    Os arquivos modelo a que voc\u00ea tem acesso depender\u00e1 do tema que voc\u00ea usar. Todos os temas de WordPress<\/a>\u00a0s\u00e3o uma cole\u00e7\u00e3o de modelos, stylesheets<\/a> e outros elementos, tais como imagens<\/a>. Portanto, no exemplo acima, se o tema que voc\u00ea utiliza inclui um modelo search.php<\/em>, o WordPress ir\u00e1 encontr\u00e1-lo e carreg\u00e1-lo.<\/p>\n

    Em alguns casos, voc\u00ea pode usar um tema que n\u00e3o inclua arquivos de modelos para os tipos de p\u00e1ginas que voc\u00ea deseja carregar. \u00c9 a\u00ed que entra a hierarquia de modelos do WordPress. \u00c9 um sistema embutido que diz ao WordPress quais arquivos de modelos devem ser carregados e em que ordem.<\/p>\n

    Para uma p\u00e1gina de pesquisa, se o WordPress n\u00e3o conseguir encontrar o arquivo search.php<\/em>, ele descer\u00e1 para o pr\u00f3ximo arquivo na hierarquia, que \u00e9 index.php<\/em>. Este arquivo \u00e9 o \u00faltimo recurso para cada branch dentro da hierarquia do modelo.<\/p>\n

    Em teoria, voc\u00ea pode ter um tema totalmente funcional que inclui apenas um arquivo modelo, e que \u00e9 index.php<\/em>.<\/p>\n

    Na pr\u00e1tica, por\u00e9m, um tema com um \u00fanico arquivo de modelo dificilmente incluiria qualquer personaliza\u00e7\u00e3o de estilo, e todo tipo de p\u00e1gina teria o mesmo aspecto. A menos que seja isso o que voc\u00ea pretende, compreender a hierarquia de modelos do WordPress \u00e9 um dos passos mais importantes que voc\u00ea pode dar como desenvolvedor de um tema<\/a>.<\/p>\n\n

    Como funciona a Hierarquia de Modelos do WordPress<\/h2>\n

    Como voc\u00ea deve saber, o WordPress permite o uso de v\u00e1rios tipos de p\u00e1ginas, dependendo do que voc\u00ea deseja publicar. H\u00e1 sete categorias principais que voc\u00ea pode usar:<\/p>\n

      \n
    1. Primeira p\u00e1gina<\/li>\n
    2. Artigos individuais<\/li>\n
    3. P\u00e1ginas individuais<\/li>\n
    4. Tipos de e-mail personalizados<\/li>\n
    5. P\u00e1ginas de resultados de pesquisa<\/li>\n
    6. Categorias e p\u00e1ginas de etiquetas<\/li>\n
    7. P\u00e1ginas de erro 404<\/li>\n<\/ol>\n

      Cada uma dessas p\u00e1ginas tem sua pr\u00f3pria hierarquia personalizada, o que significa que ela usa um conjunto espec\u00edfico de arquivos modelo.<\/p>\n

      Se voc\u00ea der uma r\u00e1pida olhada em qualquer pasta do seu tema, voc\u00ea normalmente encontrar\u00e1 uma cole\u00e7\u00e3o de arquivos de modelos. A seguir, um exemplo de arquivos de modelos listados dentro do diret\u00f3rio de temas para um artigo de blog:<\/p>\n

      \"Arquivos
      Arquivos de modelos listados em um diret\u00f3rio de temas do WordPress<\/figcaption><\/figure>\n

      Este \u00e9 um tipo de p\u00e1gina de artigo \u00fanico, o que significa que ele usa o arquivo single.php <\/em>como modelo para o conte\u00fado principal da p\u00e1gina (o pr\u00f3prio artigo do blog).<\/p>\n

      Al\u00e9m disso, ele tem um arquivo modelo separado para cada elemento da p\u00e1gina, a maioria dos quais voc\u00ea deve ser capaz de identificar num relance, inclusive:<\/p>\n