WordPress.org (Español)
como se mencionó, los archivos de plantilla son Archivos modulares y reutilizables, que se utilizan para generar las páginas web en su sitio de WordPress. Algunos archivos de plantilla (como la plantilla de encabezado y pie de página) se utilizan en todas las páginas de su sitio, mientras que otros se utilizan solo bajo condiciones específicas.
Este artículo explica cómo WordPress determina qué archivo(s) de plantilla usar en páginas individuales. Si desea personalizar un tema de WordPress existente, le ayudará a decidir qué archivo de plantilla debe editarse.,
the Template File Hierarchy #the Template File Hierarchy
Overview # Overview
WordPress utiliza la cadena de consulta para decidir qué plantilla o conjunto de plantillas se debe utilizar para mostrar la página. La cadena de consulta es información contenida en el enlace a cada parte de su sitio web. Viene después del signo de interrogación inicial y puede contener una serie de parámetros separados por ampersands.,
En pocas palabras, WordPress busca a través de la jerarquía de plantillas hasta que encuentra un archivo de plantilla coincidente. Para determinar qué archivo de plantilla usar, WordPress:
- Hace coincidir cada cadena de consulta con un tipo de consulta para decidir qué página se está solicitando (por ejemplo, una página de búsqueda, una página de categoría, etc.);
- selecciona la plantilla en el orden determinado por la jerarquía de la plantilla;
- Busca archivos de plantilla con nombres específicos en el directorio del tema actual y utiliza el primer archivo de plantilla coincidente según lo especificado por la jerarquía.,
con la excepción del archivo de plantilla básico index.php
, puede elegir si desea implementar un archivo de plantilla en particular o no.
Si WordPress no puede encontrar un archivo de plantilla con un nombre coincidente, saltará al siguiente archivo en la jerarquía. Si WordPress no puede encontrar ningún archivo de plantilla coincidente, se utilizará el archivo index.php
del tema.,
Top
Ejemplos # Ejemplos
Si su blog está en y un visitante hace clic en un enlace a una página de categoría como
, WordPress busca un archivo de plantilla en el directorio del tema actual que coincida con el ID de la categoría para generar la página correcta. Más específicamente, WordPress sigue este procedimiento:
- Busca un archivo de plantilla en el directorio del tema actual que coincida con el slug de la categoría. Si el slug de categoría es «unicornios», entonces WordPress busca un archivo de plantilla llamado
category-unicorns.php
., - si
category-unicorns.php
falta y el ID de la categoría es 4, WordPress busca un archivo de plantilla llamadocategory-4.php
. - Si
category-4.php
falta, WordPress buscará una categoría genérica archivo de plantilla,category.php
. - si
category.php
no existe, WordPress buscará una plantilla de archivo genérica,archive.php
. - si
archive.php
también falta, WordPress volverá al archivo de plantilla del tema principal,index.php
.,
Top
Visual Overview # visual Overview
el siguiente diagrama muestra qué archivos de plantilla se llaman para generar una página de WordPress basada en la jerarquía de plantillas de WordPress.
Top
the Template Hierarchy in Detail #the Template Hierarchy in Detail
mientras que la jerarquía de la plantilla es más fácil de entender como un diagrama, las siguientes secciones describen el orden en el que WordPress llama a los archivos de plantilla para varios tipos de consultas.
Top
Home Page display # Home Page display
de forma predeterminada, WordPress establece la página de inicio de su sitio para mostrar sus últimas publicaciones de blog. Esta página se llama el índice de publicaciones del blog. También puedes configurar tus publicaciones de blog para que se muestren en una página estática separada., El archivo de plantilla home.php
se utiliza para representar el índice de publicaciones del blog, ya sea que se esté utilizando como portada o en una página estática separada. Si home.php
no existe, WordPress usará index.php
.
home.php
index.php
tenga en cuenta: Si front-page.php
existe, se anulará el home.php
plantilla.,
Top
Front Page display #Front Page display
el archivo de plantilla front-page.php
se utiliza para representar la página principal de su sitio, ya sea que la página principal muestre el índice de publicaciones del blog (mencionado anteriormente) o una página estática. La plantilla de portada tiene prioridad sobre la plantilla de índice de publicaciones de blog (home.php
). Si el archivo front-page.php
no existe, WordPress utilizará los archivos home.php
o page.php
dependiendo de la configuración en Configuración → lectura., Si ninguno de esos archivos existe, utilizará el archivo index.php
.
-
front-page.php
– se utiliza tanto para «sus últimos mensajes» o «una página estática» como se establece en la sección de visualización de la página principal de ajustes → lectura. -
home.php
– si WordPress no puede encontrarfront-page.php
y» sus últimos mensajes»se establece en la sección de pantallas de la página principal, buscaráhome.php
. Además, WordPress buscará este archivo cuando la página de publicaciones se establezca en la sección de pantallas de la página principal., -
page.php
– cuando» página principal » se establece en la sección de pantallas de la página principal. -
index.php
– Cuando «tus últimas entradas» se establece en la página frontal muestra la sección perohome.php
no existe o cuando la primera página es juego peropage.php
no existe.
como se puede ver, hay un montón de reglas para lo que toma WordPress ruta. Usar el gráfico de arriba es la mejor manera de determinar qué mostrará WordPress.,
Top
visualización de la página de Política de privacidad # visualización de la página de Política de privacidad
el archivo de plantillaprivacy-policy.php
se utiliza para representar la página de Política de Privacidad de su sitio. La plantilla de Página de Política de Privacidad tiene prioridad sobre la plantilla de Página estática (page.php
). Si el archivo privacy-policy.php
no existe, WordPress utilizará los archivos page.php
o singular.php
dependiendo de las plantillas disponibles. Si ninguno de esos archivos existe, utilizará el archivo index.php
.,
-
privacy-policy.php
div – – se utiliza para la página de Política de privacidad establecida en la sección Cambiar su página de Política de Privacidad de Configuración → Privacidad. -
custom template file
La página plantilla asignada a la página. Véaseget_page_templates()
. -
page-{slug}.php
– Si la página slug esprivacy
, WordPress se verá a usarpage-privacy.php
. -
page-{id}.php
– si el ID de la página es 6, WordPress buscará usarpage-6.php
., page.php
singular.php
-
index.php
Top
un Solo Post #Solo Post
El único post de archivo de plantilla se utiliza para representar un solo post. WordPress utiliza la siguiente ruta:
Top
Single Page # single Page
el archivo de plantilla utilizado para representar una página estática (page
post-type).,es, page
es especial para WordPress y utiliza la siguiente ruta:
Top
Category #Category
Rendering category archive index pages utiliza la siguiente ruta en WordPress:
Top
Tag #Tag
para mostrar una página de índice de archivo de etiquetas, WordPress utiliza la siguiente ruta:
Top
taxonomías personalizadas #taxonomías personalizadas
las taxonomías personalizadas utilizan una ruta de archivo de plantilla ligeramente diferente:
top
custom post types #custom post types
custom post types utilizan la siguiente ruta para representar la página de índice de archivo adecuada.,
-
archive-{post_type}.php
– Si el post es de tipoproduct
, WordPress buscaráarchive-product.php
. archive.php
index.php
(para representar una plantilla de tipo de publicación única, consulte la sección de visualización de publicación única anterior.,s sigue el mismo patrón que otros tipos de plantilla:
search.php
index.php
Top
404 (No Encontrado) #404 (No Encontrado)
Asimismo, 404 archivos de plantilla se llama en este orden:
404.php
index.php
Top
archivo Adjunto #archivo Adjunto
la Representación de un accesorio de la página (attachment
post-tipo) se utiliza la ruta de acceso siguiente:
Top
Incrusta #Incrusta
incrustar El archivo de plantilla se utiliza para representar un post en el que está integrado., Desde la versión 4.5, WordPress utiliza la siguiente ruta:
-
embed-{post-type}-{post_format}.php
– – primero, WordPress busca una plantilla para la publicación específica. Por ejemplo, si su tipo de publicación espost
y tiene el formato de audio, WordPress buscaríaembed-post-audio.php
. -
embed-{post-type}.php
– Si el post es de tipoproduct
, WordPress se buscaembed-product.php
. -
embed.php
WordPress, a continuación, vuelve a incrustar.php
., - Finalmente, WordPress finalmente vuelve a su propia plantilla
wp-includes/theme-compat/embed.php
.
Top
manejo de caracteres no ASCII # manejo de caracteres no ASCII
desde WordPress 4.7, cualquier parte dinámica de un nombre de plantilla que incluye caracteres no ASCII en su nombre en realidad soporta tanto la forma codificada como la no codificada, en ese orden. Puede elegir cuál usar.,
Aquí está la jerarquía de plantillas de página para una página llamada «Hello World Hello» con un ID de 6
:
page-hello-world-😀.php
page-hello-world-%f0%9f%98%80.php
page-6.php
page.php
singular.php
el mismo comportamiento se aplica a los slugs de publicaciones, nombres de términos y nombres de autor.
Top
jerarquía de filtros # jerarquía de filtros
El sistema de plantillas de WordPress te permite filtrar la jerarquía., Esto significa que puede insertar y cambiar cosas en puntos específicos de la jerarquía. El filtro (ubicado en la función get_query_template()
) usa este nombre de filtro: "{$type}_template"
donde $type
es el tipo de plantilla.,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., Esto permite una solicitud para / author / username donde username tiene el rol de editor para mostrar usando author-editor.php si está presente en el directorio themes actual.