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:

1. 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.);
2. selecciona la plantilla en el orden determinado por la jerarquía de la plantilla;
3. 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:

1. 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.,
2. si category-unicorns.php falta y el ID de la categoría es 4, WordPress busca un archivo de plantilla llamado category-4.php.
3. Si category-4.php falta, WordPress buscará una categoría genérica archivo de plantilla, category.php.
4. si category.php no existe, WordPress buscará una plantilla de archivo genérica, archive.php.
5. 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.

1. home.php
2. index.php

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.

1. 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.
2. home.php – si WordPress no puede encontrar front-page.phpy» 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.,
3. page.php – cuando» página principal » se establece en la sección de pantallas de la página principal.
4. index.php – Cuando «tus últimas entradas» se establece en la página frontal muestra la sección pero home.php no existe o cuando la primera página es juego pero page.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.,

1. 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.
2. custom template file La página plantilla asignada a la página. Véase get_page_templates().
3. page-{slug}.php – Si la página slug es privacy, WordPress se verá a usar page-privacy.php.
4. page-{id}.php – si el ID de la página es 6, WordPress buscará usar page-6.php.,
5. page.php
6. singular.php
7. 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.,

1. archive-{post_type}.php – Si el post es de tipo product, WordPress buscará archive-product.php.
2. archive.php
3. 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:

1. search.php
2. index.php

Top

404 (No Encontrado) #404 (No Encontrado)

Asimismo, 404 archivos de plantilla se llama en este orden:

1. 404.php
2. 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:

1. 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 es post y tiene el formato de audio, WordPress buscaría embed-post-audio.php.
2. embed-{post-type}.php – Si el post es de tipo product, WordPress se busca embed-product.php.
3. embed.php WordPress, a continuación, vuelve a incrustar.php.,
4. 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

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.