WordPress : Jerarquia de plantillas - Que Plantilla mostrar en cada caso

Fecha Publicación:       14 de Agosto de 2022
Fecha Modificación:       12 de Marzo de 2024

→ Ir a la Página oficial de la documentacion : Jerarquía de plantillas - Cómo interpreta WordPress qué plantilla mostrar en cada caso

 

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.

 

Si WordPress no puede encontrar un archivo de plantilla con un nombre coincidente, pasará al siguiente archivo en la jerarquíaSi WordPress no puede encontrar ningún archivo de plantilla coincidenteindex.php se utilizará el archivo del tema.

¿Qué es la jerarquía de plantillas?

Para que una plantilla funcione correctamente con WordPress, debe seguir la jerarquía adecuada entre sus archivos y funciones.

Esto se aplica al orden en que la plataforma busca páginas específicas para mostrar al usuario. En este caso, estamos hablando de la página principal que se muestra cuando su visitante accede al nivel superior de su sitio.

Se llama jerarquía de plantillas porque si no encuentra una en concreto va a la siguiente, y todas desembocan al final en index.php. Por ejemplo, si queremos visualizar el detalle de un custom post type, primero buscará si existe en nuestro tema un archivo single-{posttype}.php.

En caso de no encontrarlo buscará el single.php, y en caso de no encontrarlo, mostrará el index.php.

Jerarquía de la Plantilla de WordPress por Tipo de Página

Como ya sabrás, WordPress te permite usar múltiples tipos de páginas dependiendo de lo que quieras publicar. Hay siete categorías principales que puedes usar:

Página principal
Publicaciones individuales
Páginas individuales
Tipos de publicaciones personalizados
Páginas de resultados de la búsqueda
Páginas de categorías y etiquetas
Páginas de error 404
Cada una de esas páginas tiene su propia jerarquía personalizada, lo que significa que utiliza un conjunto específico de archivos de plantilla.

Descripción general visual

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.

El esquema de la jerarquía de las plantillas de WorPress se lee de izquierda a derecha

La jerarquía de plantillas en detalle

Si bien la jerarquía de plantillas 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.

Visualización de la página de inicio

De forma predeterminada, WordPress configura la página de inicio de su sitio para mostrar las últimas publicaciones de su blog. Esta página se llama índice de publicaciones de blog. También puede configurar las publicaciones de su 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 utilice como página principal o en una página estática separada. Si  home.php no existe, WordPress usará  index.php.

  1. home.php
  2. index.php

 

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

Visualización de la página principal

El front-page.php archivo de plantilla 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 la página principal (front-page.php)  tiene prioridad sobre la home.php ( plantilla del índice de publicaciones del blog () ).

 

Si el front-page.php archivo no existe, WordPress utilizará los archivos home.php page.php según la configuración en Configuración  Lectura. Si ninguno de esos archivos existe, utilizará el index.php archivo.

 

  1. front-page.php – Se utiliza tanto para "Tus últimas entradas" como para "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.php y " Tus últimas entradas " está configurado en la sección de visualización de la página principal , buscará home.php. Además, WordPress buscará este archivo cuando la página de publicaciones esté configurada en la sección de visualización de la página principal .
  3. page.php– Cuando se configura  “ página principal ” en la sección de visualización de la página principal .
  4. index.php – Cuando " tus últimas publicaciones " está configurado en la sección de visualización de la página principal pero  home.php no existe o  cuando la página principal está configurada pero page.php no existe.

 

Como puede ver, existen muchas reglas sobre el camino que toma WordPress. Usar el cuadro anterior es la mejor manera de determinar qué mostrará WordPress.

Vea Tambien

WordPress : Estructura y componentes dentro de un tema

Una Guía para la Jerarquía de Plantillas de WordPress (Edición 2022)

 

Articulo : 1040 - Veces Leidas
Compartir Articulo:

Artículos Relacionados