WordPress
Jerarquía de plantillas

Observaciones

Introducción

Una de las cosas más importantes que debe aprender cuando está creando un tema de WordPress es la jerarquía de plantillas de WordPress para los temas. La jerarquía de plantillas define qué archivo de plantilla se cargará para cada solicitud y en qué orden. Si la primera plantilla no existe en la jerarquía, WordPress intentará cargar la siguiente y así sucesivamente hasta que termine en index.php .

Para describir en detalle la jerarquía de plantillas, la mejor manera es, por supuesto, utilizar una imagen con la estructura completa:

La jerarquía de plantillas comienza con los tipos principales de páginas como archivo, página singular o página frontal y luego los subtipos como archivo de autor, archivo de etiquetas, página o publicación de blog.

Después de esto encontraremos las plantillas reales que serán cargadas. Primero, están las plantillas más específicas que utilizan slugs o ID para dirigirse a tipos de archivo o publicaciones específicos.

Por ejemplo, category-$slug.php que solo se dirige a la categoría con un slug específico, por ejemplo category-books.php se usaría solo para la categoría con el book slug. Otro ejemplo es page-$id.php que solo se dirige a una página con una ID específica, por ejemplo, page-41.php solo apuntaría a la página con la ID 41.

Después de las plantillas dirigidas a tipos específicos o publicaciones, llegamos a las plantillas de tipo genérico, como archive.php para todas las páginas de archivo o page.php para todas las páginas. Pero recuerde, esos solo se utilizarán si la página actual no coincide con ninguna de las plantillas que están en una jerarquía superior.

Por último, si WordPress no pudo encontrar ninguna plantilla coincidente en el directorio de plantillas, la última alternativa alternativa es siempre index.php que es el único archivo de plantilla requerido en un tema de WordPress.

Depuración

Es fácil perderse mientras se depura la búsqueda. Puede utilizar el comando debug_backtrace .

Coloque el siguiente fragmento dentro de cualquier plantilla que desee depurar y vea la página generada:

<!--
<?php print_r( debug_backtrace() ) ?>
-->