Después de nuestra infografía sobre cómo funciona WordPress detrás de escena, varios usuarios nos pidieron que cubriéramos cómo funciona un tema de WordPress detrás de escena.
En este artículo, explicaremos la jerarquía de plantillas de WordPress para principiantes. Esta hoja de trucos es extremadamente útil al personalizar una plantilla o crear un tema personalizado de WordPress.
Consejo profesional: ¿Quieres crear páginas de destino personalizadas sin cambiar tu tema de WordPress? Prueba SeedProd, es el constructor de páginas de WordPress de arrastrar y soltar #1.
¿Por qué aprender sobre la jerarquía de plantillas de WordPress?
Todos los temas modernos de WordPress consisten en plantillas, hojas de estilo, javascript e imágenes. Juntos, estos archivos controlan cómo se ve tu sitio a los usuarios.
Relacionado: 9 cosas que debes buscar al seleccionar el tema perfecto de WordPress para tu sitio.
WordPress tiene una jerarquía de plantillas estándar. Esto significa que las plantillas con ciertos nombres de archivo afectan áreas específicas de tu sitio web. También te indica qué nombre de plantilla usar para un elemento específico.
La mayoría de los temas modernos de WordPress vienen con plantillas para mostrar categorías, fechas, archivos, publicaciones individuales, páginas personalizadas y más. Como usuario, puedes crear más plantillas creando un tema hijo.
Dicho esto, veamos cómo funciona esta jerarquía de plantillas de WordPress detrás de escena.
Visualización de la jerarquía de plantillas de WordPress (Hoja de referencia)
WordPress utiliza un patrón fácil de entender y significativo para los nombres de las plantillas. La hoja de referencia visual a continuación explica qué archivos de plantilla se utilizan para mostrar diferentes páginas en un sitio de WordPress.
Aquí hay un desglose de qué archivos de plantilla de WordPress editar para diferentes páginas en un sitio típico de WordPress.
¿Qué archivos de plantilla utiliza la página de inicio?
Por defecto, WordPress muestra tus publicaciones de blog en la página de inicio de tu sitio web. También puedes configurarlo para usar una página de inicio personalizada (también conocida como página principal) visitando la página Ajustes » Lectura en el área de administración de WordPress.
1. front-page.php – Si estás utilizando una página de inicio estática, WordPress buscará primero este archivo de plantilla y lo usará para mostrar la página de inicio.
2. home.php – Si estás utilizando una página de inicio estática y no tienes el archivo de plantilla front-page.php en tu tema, entonces WordPress buscará el archivo de plantilla home.php. También se utiliza para mostrar las publicaciones de blog predeterminadas en la página de inicio.
3. index.php – Si front-page.php o home.php no existen, entonces WordPress recurre a la plantilla index.php para mostrar la página de inicio. Esta plantilla es la plantilla de respaldo predeterminada en WordPress para mostrar cualquier página.
¿Qué archivos de plantilla se utilizan para una publicación individual?
WordPress busca estos archivos para mostrar una publicación individual.
1. single-{post-type}-{slug}.php – Usa esta plantilla para modificar la visualización de una publicación individual específica en cualquier tipo de publicación. Por ejemplo, si el tipo de publicación es 'review' y el slug de publicación es acme-phone, entonces WordPress buscaría single-review-acme-phone.php.
2. single-{post-type}.php – WordPress luego verificará si existe una plantilla para mostrar este tipo de publicación específico. Por ejemplo, si el tipo de publicación es review, entonces WordPress buscaría single-review.php.
3. single.php – WordPress luego recurrirá a single.php.
4. singular.php – Esta plantilla agrega otra opción de respaldo para mostrar un elemento único de cualquier tipo de publicación.
5. index.php – Finalmente, como se mencionó anteriormente, WordPress recurre en última instancia a index.php.
¿Qué archivos de plantilla se utilizan para la página individual?
Las páginas de WordPress son uno de los tipos de publicación predeterminados. Te permiten crear páginas estáticas en tu sitio web en lugar de entradas. Consulta nuestra guía sobre la diferencia entre entradas y páginas.
1. Plantilla de página personalizada – La plantilla de página asignada a la página. Vea cómo crear una plantilla de página personalizada en WordPress.
2. page-{slug}.php – Si el slug de la página es contact-us, WordPress intentará usar page-contact-us.php.
3. page-{id}.php – Si el ID de la página es 17, entonces WordPress buscará un archivo de plantilla llamado page-17.php.
4. page.php – La plantilla para mostrar todas las páginas estáticas.
5. singular.php – Esta plantilla es una opción de respaldo predeterminada para todos los elementos de tipo de publicación única.
6. index.php – La plantilla de respaldo predeterminada.
¿Qué archivos de plantilla se utilizan para los archivos de categorías?
WordPress utiliza estos archivos para mostrar páginas relacionadas con categorías en WordPress.
1. category-{slug}.php – Esta plantilla se utiliza para mostrar la página de archivo de categoría para una categoría específica. Por ejemplo, si el slug de la categoría es reviews, entonces WordPress buscará la plantilla category-reviews.php.
2. category-{id}.php – WordPress luego busca una plantilla con el ID de categoría. Por ejemplo, si el ID de categoría es 17, entonces WordPress buscará category-17.php.
3. category.php – Esta es la plantilla predeterminada para mostrar todas las páginas de archivo de categoría en WordPress.
4. archive.php – Esta es la plantilla predeterminada que utiliza WordPress para mostrar cualquier página de archivo.
5. index.php – La plantilla de respaldo predeterminada.
¿Qué archivos de plantilla se utilizan para los archivos de etiquetas?
WordPress usa estos archivos para mostrar las páginas de archivo de etiquetas.
1. tag-{slug}.php – Si el slug de la etiqueta es 'frutas', WordPress buscará tag-frutas.php.
2. tag-{id}.php – Si el ID de la etiqueta es 17, WordPress buscará la plantilla tag-17.php.
3. tag.php – La plantilla predeterminada para los archivos de etiquetas.
4. archive.php – La plantilla predeterminada para cualquier página de archivo.
5. index.php – La plantilla de respaldo predeterminada.
¿Qué archivos de plantilla se utilizan para los archivos de taxonomía personalizada?
Las categorías y las etiquetas son dos taxonomías predeterminadas de WordPress. Los usuarios también pueden crear sus propias taxonomías personalizadas. Así es como WordPress busca plantillas para mostrar las páginas de taxonomía personalizada.
1. taxonomy-{taxonomy}-{term}.php – Si tienes una taxonomía personalizada llamada 'género' y hay un término 'thriller', entonces WordPress buscará taxonomy-género-thriller.php.
2. taxonomy-{taxonomy}.php – Si la taxonomía fuera 'género', WordPress buscaría taxonomy-género.php.
3. taxonomy.php – La plantilla predeterminada para mostrar cualquier archivo de taxonomía personalizada.
4. archive.php – El respaldo predeterminado para todas las páginas de archivo en WordPress.
5. index.php – La plantilla de respaldo predeterminada en WordPress.
¿Qué archivos de plantilla se utilizan para los tipos de publicación personalizados?
Así es como WordPress busca plantillas para mostrar los archivos de tipos de publicación personalizados.
1. archive-{post_type}.php – Si tienes un tipo de publicación llamado 'reseña', WordPress buscará archive-reseña.php.
2. archive.php – La plantilla predeterminada para mostrar todas las páginas de archivo en WordPress.
3. index.php – La plantilla de respaldo predeterminada en WordPress.
¿Qué archivos de plantilla se utilizan para mostrar los archivos de autor?
WordPress genera páginas de archivo para cada autor en tu sitio de WordPress. Así es como se ve para la plantilla de archivo de autor.
1. author-{nicename}.php – Si el nombre "nice name" del autor es matt, WordPress buscará author-matt.php.
2. author-{id}.php – Si el ID de usuario del autor es 6, entonces WordPress buscará author-6.php.
3. author.php – La plantilla predeterminada utilizada para mostrar las páginas de archivo de autor en WordPress.
4. archive.php – La plantilla predeterminada para mostrar todas las páginas de archivo en WordPress.
5. index.php – La plantilla de respaldo predeterminada en WordPress.
¿Qué archivos de plantilla se utilizan para mostrar los archivos basados en fechas?
WordPress también muestra tus publicaciones en páginas de archivo basadas en fechas para meses y años. Así es como se ve para las plantillas de estas páginas.
1. date.php – La plantilla predeterminada para archivos basados en fechas.
2. archive.php – La plantilla predeterminada utilizada para mostrar las páginas de archivo de autor en WordPress.
3. index.php – La plantilla de respaldo predeterminada en WordPress.
¿Qué archivos de plantilla se utilizan para mostrar las páginas de búsqueda?
1. search.php – La página predeterminada para mostrar los resultados de búsqueda en WordPress.
2. searchform.php – La plantilla para mostrar un formulario de búsqueda en WordPress.
3. index.php – La plantilla de respaldo predeterminada en WordPress.
¿Qué archivos de plantilla se utilizan para mostrar las páginas de error 404?
La página de error 404 se muestra cuando WordPress no puede encontrar el contenido solicitado. Consulta nuestra guía sobre cómo mejorar tu plantilla de página 404.
1. 404.php – La plantilla predeterminada para mostrar la página de error 404 en WordPress.
2. index.php – La plantilla de respaldo predeterminada en WordPress.
¿Qué archivos de plantilla se utilizan para mostrar las páginas de adjuntos?
1. MIME_type.php – Mime_type significa tipo de archivo. Por ejemplo, image.php, video.php, application.php.
2. attachment.php – La plantilla predeterminada para mostrar páginas de adjuntos.
3. single-attachment.php – Para mostrar un solo adjunto.
4. single.php – La plantilla predeterminada para mostrar elementos de tipo de publicación individual.
5. index.php – La plantilla de respaldo predeterminada en WordPress.
¿Qué archivos de plantilla se utilizan para mostrar incrustaciones (embeds)?
Desde WordPress 4.5, puedes usar plantillas para renderizar una publicación incrustada en WordPress.
1. embed-{post-type}-{post_format}.php – WordPress buscará primero una plantilla de tipo de publicación y formato de publicación. Por ejemplo, si tienes una reseña con video, WordPress buscará embed-review-video.php.
2. embed-{post-type}.php – Si el tipo de publicación es reseña, WordPress buscaría embed-review.php.
3. embed.php – El respaldo predeterminado para todas las incrustaciones.
Esperamos que este tutorial te haya ayudado a aprender sobre la jerarquía de plantillas de WordPress. También te puede interesar ver nuestra lista de los mejores constructores de páginas de WordPress de arrastrar y soltar.
Si te gustó este artículo, suscríbete a nuestro Canal de YouTube para tutoriales de video de WordPress. También puedes encontrarnos en Twitter y Facebook.
Mrteesurez
Esta es una publicación bien detallada, contiene todas las plantillas esenciales. Estoy descubriendo nombres y jerarquías de nuevas plantillas aquí, ya que solo conocía algunas de estas antes.
Gracias, es muy útil para quienes nos dedicamos al desarrollo.
Moinuddin Waheed
He estado usando WordPress durante varios años y solo conocía algunos archivos y pensaba que esos eran los únicos archivos detrás de escena.
Esta es una descripción muy perspicaz y detallada de la estructura de plantillas de todos los archivos.
La infografía se explica por sí sola y ayuda a comprender qué archivo utiliza otros archivos para mostrar el contenido.
Gracias por la detallada guía de la estructura de archivos de WordPress.
Soporte de WPBeginner
Glad we could clarify how the template hierarchy works
Administrador
Jiří Vaněk
Vi los archivos de plantilla en FTP, pero solo conocía la función de ellos, como function, header, footer, y eso es todo. Realmente no sabía mucho sobre el resto de los archivos. Tu infografía es perfecta. Hace un gran trabajo al mostrar cómo se enlazan los archivos individuales y para qué los usa WordPress. Uno tiene una comprensión mucho mejor de la estructura de cómo funciona la plantilla y luego es mucho más fácil hacer, por ejemplo, algunas modificaciones al código fuente si es necesario. Aunque todavía no entiendo todo, intentaré revisar los archivos individuales de mi plantilla y descubrir mucho más sobre cómo funciona todo. Gracias por este tutorial completo.
mjasia
Hola
¿Qué pasa con los atributos de producto de WooCommerce?
¿Cómo se muestran?
Soporte de WPBeginner
Dependería de tu tema específico cómo se muestran, pero se tratan de manera similar a los campos personalizados. Puedes ver más sobre campos personalizados en nuestro artículo a continuación:
https://www.wpbeginner.com/wp-tutorials/wordpress-custom-fields-101-tips-tricks-and-hacks/
Administrador
Connie
¿qué pasa con los archivos de idioma en los temas hijos?
Este es uno de los grandes misterios en WP porque todavía hay gente (¡la mayoría!) que necesita archivos de traducción para tener su instalación en su idioma ;=)
Soporte de WPBeginner
That would be a subject for a different guide
Administrador