Jerarquía Plantilla

WordPress utiliza la cadena de consulta para decidir qué plantilla o un conjunto de plantillas se debe utilizar para mostrar la página. La cadena de consulta es la información que se contiene en el enlace a cada parte de su sitio web. Viene después de la marca inicial de preguntas y puede contener un número de parámetros separados por los símbolos de unión.

En pocas palabras, WordPress busca a través de la jerarquía de la plantilla hasta que encuentra un archivo de plantilla a juego. Para determinar qué plantilla de archivo de usar, WordPress:

1. Coincide cualquier cadena de consulta a un tipo de consulta para decidir qué página se solicita (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 plantilla;
3. Busca los archivos de plantilla con nombres específicos en el directorio del tema actual y utiliza el primer archivo de la plantilla correspondiente según lo especificado por la jerarquía.

Con la excepción de la básica index.php archivo de plantilla, 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, se saltará al siguiente archivo en la jerarquía. Si WordPress no puede encontrar ningún archivo de plantilla a juego, de la temática index.php será utilizada archivo.

Arriba ↑

Ejemplos #

Si tu blog está en http://example.com/blog/ y un visitante hace clic en un enlace a una página de la categoría, como  http://example.com/blog/category/your-cat/, WordPress busca una plantilla presentar en el directorio del tema actual que coincide con el ID de la categoría a la generación de 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 coincide con bala de la categoría. Si la categoría babosa es "unicornios", entonces WordPress busca un archivo plantilla denominada categoría unicorns.php.
2. Si categoría unicorns.php falta y el ID de la categoría es 4, WordPress busca un archivo plantilla denominada categoría 4.php.
3. Si categoría 4.php falta, WordPress buscará un archivo de la categoría plantilla genérica, category.php.
4. Si category.php no existe, WordPress buscará un genérico archivo plantilla,archive.php.
5. Si archive.php también falta, WordPress caerá de nuevo al archivo principal plantilla de tema, index.php.

Arriba ↑

Visual general #

Los siguientes muestra el diagrama que se denominan archivos de plantilla para generar una página de WordPress basado en la jerarquía plantilla de WordPress.

También puede interactuar con este diagrama.

Arriba ↑

La Jerarquía Plantilla en detalle #

Mientras que la jerarquía de la plantilla es más fácil de entender como un diagrama, las siguientes secciones se describe el orden en que los archivos de plantilla son llamados por WordPress para varios tipos de consulta.

Arriba ↑

Inicio pantalla Página #

Por defecto, WordPress establece la página de inicio de su sitio para mostrar los mensajes más recientes del blog. Esta página se llama el índice de entradas de blog.También puede configurar su blog para mostrar en una página estática separada. El archivo de plantilla home.php se utiliza para representar el índice de entradas de blog, ya está siendo utilizado como la primera página o en la página estática separada. Si home.php  no existe, WordPress utilizará  index.php.

1. home.php
2. index.php

Nota: Si front-page.php  existe, anulará el  home.php  plantilla.

Arriba ↑

Front Page pantalla #

El front-page.php archivo de plantilla se utiliza para hacer la primera página de su sitio, si la portada muestra el índice de entradas de blog (mencionado anteriormente) o una página estática. La plantilla de la portada tiene prioridad sobre el índice de entradas de blog (home.php plantilla). Si la primera page.php no existe archivo, WordPress o bien utilizar el home.php o page.php archivos dependiendo de la configuración en Configuración → Lectura. Si ninguno de esos archivos existen, utilizará el index.php archivo.

1. front-page.php  - Se utiliza tanto para "sus últimos mensajes" o "una páginaestática" que figura en el frente página muestra la sección de Ajustes → Lectura.
2. home.php  - Si WordPress no puede encontrar  de primera page.php y "susúltimos mensajes" se establece en el página se muestra delante sección, buscará home.php. Además, WordPress buscará este archivo cuando la página de mensajes se encuentra en la página se muestra delante sección.
3. page.php  - Cuando "portada" se encuentra en el página se muestra delantesección.
4. index.php  - Cuando "sus últimos mensajes" se encuentra en la página se muestra delante sección, pero  home.php no existe o  cuando portada está establecido pero page.php no existe.

Como se puede ver, hay un montón de reglas para qué camino toma WordPress.Utilizando la tabla de arriba es la mejor manera de determinar lo que se mostrará WordPress.

Arriba ↑

Mensaje Individual #

El archivo de plantilla de entrada solo se utiliza para representar un solo puesto.WordPress utiliza la siguiente ruta:

1. simple {tipo de post} - {slug} .php  - (Desde 4.4) En primer lugar, WordPress busca una plantilla para el puesto específico. Por ejemplo, si el tipo de post es producto y el puesto babosa es DMC-12, WordPress buscaría un solo producto-dmc-12.php.
2. simple {tipo de post} .php - Si el tipo de mensaje es producto, WordPress sería buscar una sola product.php.
3. single.php - WordPress luego cae de nuevo a single.php.
4. singular.php - Entonces cae de nuevo a singular.php.
5. index.php - Por último, como se mencionó anteriormente, en última instancia, WordPress cae de nuevo a index.php.

Arriba ↑

Una sola página #

El archivo de plantilla utiliza para representar una página estática (página de tipo post). Tenga en cuenta que a diferencia de otros post-tipos, la página es especial para WordPress y utiliza el siguiente parche:

1. archivo de plantilla  - La plantilla de página asignado a la página. Verget_page_templates ().
2. página- {slug} .php  - Si la página babosa es reciente noticia, WordPress buscará utilizar la página-reciente-news.php.
3. página- {id} .php  - Si el ID de la página es 6, WordPress buscará utilizar lapágina-6.php.
4. page.php
5. singular.php
6. index.php

Arriba ↑

Categoría #

Representación de páginas de índice categoría de archivos utiliza la siguiente ruta en WordPress:

1. categoría- {slug} .php  - Si babosa de la categoría es noticia, WordPress buscará categoría news.php.
2. categoría- {id} .php  - Si el ID de la categoría es 6, WordPress buscarácategoría 6.php.
3. category.php
4. archive.php
5. index.php

Arriba ↑

Tag #

Para mostrar una página de índice de archivo de variables, WordPress utiliza la siguiente ruta:

1. TAG-{slug} .php  - Si babosa de la etiqueta es somebutton, WordPress buscará tag-sometag.php.
2. TAG-{id} .php  - Si el ID de la etiqueta es 6, WordPress buscará tag-6.php.
3. tag.php
4. archive.php
5. index.php

Arriba ↑

Custom taxonomías #

Taxonomías personalizadas utilizan una ruta de archivo de plantilla ligeramente diferente:

1. taxonomy- {taxonomía} - {término} .php  - Si la taxonomía es sometax, y el término de taxonomía es someterm, WordPress buscará. taxonomía-sometax-someterm.php En el caso de los formatos de correos, la taxonomía es 'post_format' y los términos son "post-formateada {format}. es decir, la taxonomía-post_format post-format-link.php  para el formato de mensaje de enlace.
2. taxonomy- {taxonomía} .php  - Si la taxonomía eran sometax, WordPress buscaría taxonomía-sometax.php.
3. taxonomy.php
4. archive.php
5. index.php

Arriba ↑

Custom Publicar Tipos #

Custom Pon Tipos utilizan la siguiente ruta para hacer la página de índice de archivos correspondiente.

1. Archivo- {post_type} .php  - Si el tipo de mensaje es producto, WordPress buscará archive-product.php.
2. archive.php
3. index.php

(Para la prestación de una única plantilla de tipo de mensaje, consulte la pantalla posterior sola sección anterior.)

Arriba ↑

Autor pantalla #

Con base en los ejemplos anteriores, la prestación de páginas de índice de archivos autor es bastante explicativo:

1. autoridad {nicename} .php  - Si bueno el nombre del autor es mate, WordPress buscará autor matt.php.
2. autoridad {id} .php  - Si la identificación del autor eran 6, WordPress buscará autor 6.php.
3. author.php
4. archive.php
5. index.php

Arriba ↑

Fecha #

Páginas de índice de archivo basadas en fechas se representan como era de esperar:

1. date.php
2. archive.php
3. index.php

Arriba ↑

Resultados de la búsqueda #

Resultados de búsqueda siguen el mismo patrón que otros tipos de plantilla:

1. search.php
2. index.php

Arriba ↑

404 (Not Found) #

Del mismo modo, 404 archivos de plantilla se denominan en este orden:

1. 404.php
2. index.php

Arriba ↑

Anexo #

Representación de una página de conexión (archivo adjunto de tipo post) requiere seguir el camino sigue:

1. MIME_type.php - puede ser cualquier tipo MIME (Por ejemplo:  image.php,video.php, application.php). Para text / plain, la siguiente ruta se utiliza (en orden):
   1. text.php
   2. plain.php
   3. text_plain.php
2. attachment.php
3. solo attachment.php
4. single.php
5. index.php

Arriba ↑

Filtra Jerarquía #

El sistema de plantillas de WordPress permite filtrar la jerarquía. Esto significa que usted puede insertar y cambiar las cosas en puntos específicos de la jerarquía. El filtro (ubicado en el get_query_template () función) utiliza esta Filtro: "{$} tipo _Template" donde $ tipo es un nombre de archivo en la jerarquía sin el .phpextensión.

Aquí está una lista completa de todos los tipos de plantilla en la jerarquía de filtro:

• index_template
• 404_template
• archive_template
• author_template
• category_template
• tag_template
• taxonomy_template
• date_template
• home_template
• front_page_template
• page_template
• paged_template
• search_template
• single_template
• text_template, plain_template, text_plain_template (todos los tipos MIME)
• attachment_template
• comments_popup

Arriba ↑

Ejemplo #

Por ejemplo, tomemos la jerarquía por defecto autor:

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

Para agregar autoridad {función} .php antes author.php, podemos manipular la jerarquía real utilizando el tipo de plantilla 'author_template'. Esto permite que una solicitud de / autor / nombre de usuario, donde nombre de usuario tiene el rol de editor de visualizar utilizando autor editor.php si está presente en el directorio de temas actuales.

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18

función author_role_template ($ plantillas = '') {     $ autor = get_queried_object ();     $ función = $ autor -> papeles [0];     si (! is_array ($ plantillas) &&! empty ($ plantillas)) {         $ plantillas = locate_template (array ("autoridad $ role.php", plantillas de $), false);     } Elseif (vacías (plantillas de $)) {         $ plantillas = locate_template ("autoridad $ role.php", false);     } Otro {         $ new_template = locate_template (array ("autoridad $ role.php"));         si (! vacía ($ new_template)) {             array_unshift (plantillas de $, $ new_template);         }     }     devolver $ plantillas; } add_filter ('author_template', 'author_role_template');

fuente: https://developer.wordpress.org/themes/basics/template-hierarchy/