WordPress.org (Português)

como discutido, os arquivos modelo são Arquivos modulares, reutilizáveis, usados para gerar as páginas da web em seu site WordPress. Alguns arquivos de modelo (como o cabeçalho e o modelo de rodapé) são usados em todas as páginas do seu site, enquanto outros são usados apenas sob condições específicas.

Este artigo explica como o WordPress determina o(S) arquivo (s) Modelo (S) a usar em páginas individuais. Se você quiser personalizar um tema WordPress existente, ele irá ajudá-lo a decidir qual arquivo Modelo precisa ser editado.,

a hierarquia de Ficheiros de modelo #a hierarquia de Ficheiros de modelo

Visão Geral #Visão geral

WordPress usa o texto da consulta para decidir qual modelo ou conjunto de modelos deve ser usado para mostrar a página. A cadeia de consulta é informação que está contida no link para cada parte do seu site. Vem depois do ponto de interrogação inicial e pode conter uma série de parâmetros separados por amplificadores.,

simplificando, o WordPress procura na hierarquia de modelos até encontrar um ficheiro de modelo correspondente. Para determinar qual o ficheiro de modelo a usar, o WordPress:

1. corresponde a cada texto de consulta a um tipo de consulta para decidir qual a página que está a ser solicitada (por exemplo, uma página de pesquisa, uma página de categoria, etc);
2. selecciona o modelo na ordem determinada pela hierarquia de modelos;
3. procura ficheiros de modelos com nomes específicos na pasta do tema actual e usa o primeiro ficheiro de modelo correspondente, conforme especificado pela hierarquia.,

com excepção do ficheiro de modelo básico

, poderá escolher se deseja implementar ou não um ficheiro de modelo em particular.

Se o WordPress não conseguir encontrar um ficheiro de modelo com um nome correspondente, ele irá saltar para o próximo ficheiro na hierarquia. Se o WordPress não conseguir encontrar nenhum ficheiro de modelo correspondente, será usado o ficheiro index.php.,

Topo

Exemplos #Exemplos

Se o seu blog está no e um visitante clica em um link para uma página de categoria, tais como , o WordPress procura por um arquivo de modelo no tema atual do diretório que corresponda a categoria de IDENTIFICAÇÃO para gerar a página correta. Mais especificamente, o WordPress segue este procedimento:

1. procura por um arquivo de modelo no diretório do tema atual que corresponde ao slug da categoria. Se a categoria slug é “unicorns”, então WordPress procura por um arquivo modelo chamado category-unicorns.php.,
2. If category-unicorns.phpis missing and the category’s ID is 4, WordPress looks for a template file named category-4.php.
3. If category-4.phpis missing, WordPress will look for a generic category template file, category.php.
4. If category.phpdoes not exist, WordPress will look for a generic archive template,archive.php.
5. If archive.phpis also missing, WordPress will fall back to the main theme template file, index.php.,

Top

Visão Geral #Visão Geral

O diagrama seguinte mostra quais os ficheiros de modelo são chamados a gerar uma página WordPress com base na hierarquia do modelo WordPress.

Topo

O Modelo de Hierarquia Em Detalhes #O Modelo de Hierarquia Em Detalhes

Enquanto o modelo de hierarquia é mais fácil para entender como um diagrama, as seções a seguir descrevem a ordem na qual os arquivos de modelo são chamados pelo WordPress para um número de tipos de consulta.

Top

home Page display #Home Page display

por omissão, o WordPress define a home page do seu site para mostrar as suas últimas publicações no blog. Esta página é chamada de blog posts index. Você também pode definir suas postagens de blog para exibir em uma página estática separada., O arquivo modelo home.php é usado para desenhar o índice de posts do blog, quer esteja sendo usado como a primeira página ou em outra página estática separada. Se home.php não existir, o WordPress irá usar index.php.

1. home.php
2. index.php

Top

display #Front Page display

The front-page.php template file is used to renderizing your site ‘ s front page, whether the front page displays the blog posts index (mentioned above) or a static page. O modelo da primeira página tem precedência sobre o índice de posts do blog (home.php). Se o front-page.php o arquivo não existir, o WordPress vai usar o home.php ou page.php arquivos dependendo da configuração em Configurações → Leitura., Se nenhum desses arquivos existir, ele irá usar o arquivo index.php.

1. front-page.php – usado para ambos “as suas últimas publicações” ou “uma página estática” como definido na primeira página mostra a secção de Configurações → leitura.
2. home.php – Se o WordPress não é possível localizar front-page.php e “os seus últimos posts” é definido na primeira página exibe seção, será procure por home.php. Além disso, o WordPress vai procurar este arquivo quando a página de posts é definido na primeira página exibe seção.,
3. page.php – quando a “primeira página” é definida na secção de visualização da primeira página.
4. index.php – Quando “os seus últimos posts” é definido na primeira página exibe seção, mas home.php não existe ou quando a primeira página é definido, mas page.php não existe.

Como você pode ver, há um monte de regras para o caminho WordPress leva. Usando o gráfico acima é a melhor maneira de determinar o que o WordPress irá exibir.,

Top

Privacy Policy Page display #Privacy Policy Page display

Theprivacy-policy.php template file is used to render your site’s Privacy Policy page. O modelo da Página de Política de Privacidade tem precedência sobre a página estática (page.php). Se o privacy-policy.php o arquivo não existir, o WordPress vai usar o page.php ou singular.php arquivos dependendo modelos disponíveis. Se nenhum desses arquivos existir, ele irá usar o arquivo index.php.,

1. privacy-policy.php – usado para a página de Política de Privacidade definida na secção mudar a sua página de Política de privacidade das Definições → Privacidade.
2. custom template file – o modelo de página atribuído à página. Ver get_page_templates().
3. page-{slug}.php – If the page slug isprivacy, WordPress irá procurar usarpage-privacy.php.
4. page-{id}.php – se o ID da página for 6, O WordPress irá usarpage-6.php.,
5. page.php
6. singular.php
7. index.php

Topo

Único Post #Único Post

O único post de arquivo de modelo é utilizado para compor um único post. O WordPress usa o seguinte caminho:

Top

Página Única #Página Única

o ficheiro modelo usado para desenhar uma página estática (page pós-tipo).,es, page é especial para WordPress e utiliza o seguinte caminho:

Topo

Categoria #Categoria

Renderização arquivo por categoria de páginas de índice usa o seguinte caminho no WordPress:

Topo

a Tag #Tag

Para exibir uma marca de arquivo de página de índice, o WordPress usa o seguinte caminho:

Topo

Custom Taxonomies #Custom Taxonomies

Custom taxonomies usar um pouco diferente do modelo de caminho do arquivo:

Topo

Custom Post Types #Tipos de Pós Personalizado

Custom Post Types usar o caminho a seguir para compor o apropriado arquivo de página de índice.,

1. archive-{post_type}.php – Se o tipo de post é product, o WordPress irá procurar por archive-product.php.
2. archive.php
3. index.php

(para representar um modelo de post tipo único, consulte a secção de post display único acima.,s seguem o mesmo padrão de outros tipos de modelo:

1. search.php
2. index.php

Topo

404 (Não Encontrado) #404 (Não Encontrado)

da Mesma forma, 404 arquivos de modelo são chamados por esta ordem:

1. 404.php
2. index.php

Topo

Anexo #Anexo

a Renderização de uma página de anexo (attachment pós-tipo) utiliza o seguinte caminho:

Topo

Incorpora #Incorpora

A incorporar o arquivo de modelo é utilizado para compor um post que está sendo incorporado., Desde 4.5, o WordPress usa o seguinte caminho:

1. embed-{post-type}-{post_format}.php – primeiro, o WordPress procura um modelo para o post específico. Por exemplo, se seu tipo de post é post e tem o formato de áudio, o WordPress iria procurar por embed-post-audio.php.
2. embed-{post-type}.php – If the post type isproduct, WordPress would look forembed-product.php.
3. embed.php – WordPress então cai de volta para embed .php.,finalmente, o WordPress finalmente volta para o seu próprio modelo wp-includes/theme-compat/embed.php template.

Top

tratamento de caracteres não-ASCII #tratamento de caracteres não-ASCII

desde o WordPress 4.7, qualquer parte dinâmica de um nome de modelo que inclua caracteres não-ASCII em seu nome realmente suporta tanto a forma não codificada como a codificada, nessa ordem. Você pode escolher qual usar.,

Aqui está a página de hierarquia de modelo para uma página chamada “Hello World 😀” com o ID 6:

• page-hello-world-😀.php
• page-hello-world-%f0%9f%98%80.php
• page-6.php
• page.php
• singular.php

O mesmo comportamento se aplica a pós lesmas, termo de nomes, e autor nicenames.

Top

hierarquia do filtro #hierarquia do filtro

o sistema de modelos WordPress permite filtrar a hierarquia., Isto significa que você pode inserir e mudar as coisas em pontos específicos da hierarquia. O filtro (localizado na pasta get_query_template() função) utiliza este filtro nome: "{$type}_template" onde $type é o tipo de modelo.,category_template

tag_template

author_template

date_template

archive_template

index_template

Top

Example #Example

For example, let’s take the default author hierarchy:

• author-{nicename}.php
• author-{id}.php
• author.php

To add author-{role}.php before author.php, we can manipulate the actual hierarchy using the ‘author_template’ template type., Isto permite um pedido de / author / utilizador onde o utilizador tem o papel de editor para mostrar usando o autor-editor.php se estiver presente na pasta de temas actuais.

---