Jerarquía de plantillas: confusión con index.php, front-page.php, home.php

El archivo front-page.php es la plantilla de la página de inicio del sitio. Siempre se utilizará en la página de inicio de tu sitio, independientemente de si get_option( 'show_on_front' ) está configurado como page o posts.

El archivo de plantilla home.php es la plantilla del índice de entradas del blog. Siempre se utilizará para mostrar el índice de entradas del blog, ya sea que este índice se muestre en la página de inicio del sitio o en una página diferente.

En el caso de que existan tanto front-page.php como home.php, y get_option( 'show_on_front' ) esté configurado como posts (es decir, la página de inicio muestra el índice de entradas del blog), el archivo front-page.php tendrá prioridad sobre el archivo home.php.

El archivo index.php es la plantilla de respaldo predeterminada para todos los contextos en la Jerarquía de Plantillas. Solo se utiliza si no existe un archivo de plantilla más específico para el contexto actual.

La jerarquía de plantillas para la página de inicio del sitio es:

• front-page.php
• Si 'page' == get_option( 'show_on_front' ): jerarquía de página
• Si 'posts' == get_option( 'show_on_front' ): jerarquía del índice de entradas del blog

La jerarquía de plantillas para el índice de entradas del blog es:

• home.php
• index.php

La jerarquía de plantillas para páginas es:

• Plantilla de página personalizada
• page-{slug}.php
• page-{id}.php
• page.php
• index.php

Todo esto proviene de una lectura detallada de la Jerarquía de Plantillas.

home.php se utiliza si:

• La página frontal de tu sitio está configurada para mostrar una lista de publicaciones, o
  • Se ha establecido una página frontal estática, y
  • Un visitante accede a la página que has definido como tu "lista de publicaciones" (ej. http://example.com/blog/)
• Y el tema tiene un archivo home.php

Si no se cumple la última condición (es decir, no hay un archivo home.php en el tema), entonces se cargará index.php.

front-page.php se utilizará si:

• Se ha establecido una página frontal estática, y
• Un visitante accede a la página que has definido como tu "página de inicio estática" (es decir, http://example.com/), y
• El tema tiene un archivo front-page.php

Si no se cumple la última condición (es decir, no hay un archivo front-page.php en el tema), entonces se cargará index.php.

En resumen

Si deseas personalizar tu lista de publicaciones, usa home.php.
Si deseas personalizar tu página de inicio estática, usa front-page.php.

En resumen:

• index.php es solo una plantilla de respaldo, en caso de que no se encuentre una plantilla adecuada
• home.php se utiliza para el blog (un listado de publicaciones recientes)
• front-page.php se utiliza para la página de inicio

La plantilla universal index.php

El archivo de plantilla index.php es una plantilla de respaldo. Se utiliza como último recurso cuando no hay disponible una plantilla más apropiada. Por ejemplo, si no tienes un front-page.php ni un home.php, entonces se usará index.php. Esto también es cierto para cuando falten archive.php o single.php y así sucesivamente.

Sobre front-page.php VS home.php

Ahora, la diferencia entre las plantillas front-page.php y home.php es que front-page.php se utiliza, como su nombre lo indica, como la página principal del sitio, mientras que home.php está destinado a ser el inicio de la sección de Blog.

¿Qué plantilla se usará para la página de inicio de mi sitio?

La plantilla front-page.php, si está presente, se utilizará para la página principal del sitio (ej. http://www.example.com/). Si no está presente, entonces se usará home.php en su lugar. Si faltan tanto la plantilla front-page.php como home.php, entonces se utilizará la plantilla de respaldo index.php.

¿Qué plantilla se usará para mi página de blog?

WordPress te permite tener una página "Blog" (que listará publicaciones recientes) en una página diferente a la de inicio (ej. http://www.example.com/blog/). Entonces, si este es el caso en tu sitio, la página del Blog siempre usará la plantilla home.php. Si home.php no existe, entonces se usará la plantilla de respaldo index.php.

¿Cómo configurar la página de inicio y la página de blog?

Para configurar qué contenido mostrar en tu página de inicio, ve al Administrador de WordPress, en Ajustes > Lectura, allí puedes configurar "Tu portada muestra" para mostrar una página estática o tus publicaciones más recientes.

En el caso de que elijas mostrar una página estática en la portada, también tienes la posibilidad de establecer qué página usar como marcador de posición para la página del Blog (que usará la plantilla home.php):

tomado de Jerarquía de plantillas de WordPress

Visualización de la página de inicio

Por defecto, WordPress configura la página de inicio de tu sitio para mostrar tus publicaciones de blog más recientes. Esta página se llama índice de publicaciones del blog. También puedes configurar tus publicaciones para que se muestren en una página estática separada. El archivo de plantilla home.php se utiliza para renderizar el índice de publicaciones del blog, ya sea que se esté utilizando como página frontal 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 existe front-page.php, anulará la plantilla home.php.

Visualización de la página frontal

El archivo de plantilla front-page.php se utiliza para renderizar la página frontal de tu sitio, ya sea que la página frontal muestre el índice de publicaciones del blog (mencionado anteriormente) o una página estática. La plantilla de página frontal tiene prioridad sobre la plantilla del índice de publicaciones del blog (home.php). Si el archivo front-page.php no existe, WordPress usará home.php o page.php dependiendo de la configuración en Ajustes → Lectura. Si ninguno de esos archivos existe, usará el archivo index.php.

1. front-page.php – Se utiliza tanto para "tus últimas publicaciones" como para "una página estática" según lo configurado en la sección de visualización de la página frontal de Ajustes → Lectura.

2. home.php – Si WordPress no puede encontrar front-page.php y "tus últimas publicaciones" está configurado en la sección de visualización de la página frontal, buscará home.php. Adicionalmente, WordPress buscará este archivo cuando la página de publicaciones esté configurada en la sección de visualización de la página frontal.

3. page.php – Cuando "página frontal" está configurado en la sección de visualización de la página frontal.

4. index.php – Cuando "tus últimas publicaciones" está configurado en la sección de visualización de la página frontal pero home.php no existe o cuando la página frontal está configurada pero page.php no existe.

Como puedes ver, hay muchas reglas sobre la ruta que sigue WordPress. Usar el diagrama anterior es la mejor manera de determinar qué mostrará WordPress.

Diagrama de jerarquía de plantillas:

Decidí probar qué plantilla se utiliza para cada una de las siguientes páginas cuando se configuran las distintas opciones de Visualización de la página de inicio.

• example.net
• example.net/home/
• example.net/blog/

Los resultados son bastante extensos, pero pueden usarse como referencia o "hoja de trucos".

Fuente: ¿En qué se diferencian las plantillas front-page.php y home.php en WordPress?

Nota para el editor: Intenté copiar y pegar las tablas aquí, pero se requiere formato markdown en lugar de HTML. Por favor, conviértelo a markdown si es posible.