Tema de bloques 02: templates y template parts sin duplicación

Aprende a estructurar plantillas de tema de bloques con HTML de bloques y partes reutilizables para mantener coherencia en todo el sitio.

En temas de bloques, las plantillas viven en archivos HTML con comentarios de bloques, no en PHP tradicional.

Esto te permite construir estructura visual de forma más declarativa y editable desde el Site Editor.

La clave profesional es separar lo global en template parts (cabecera, pie, secciones compartidas) y dejar cada template enfocado a su contexto.

Si duplicas layout en cada archivo, el mantenimiento se vuelve lento y aparecen inconsistencias entre páginas muy rápido.

  • Piensa en capas: templates para contexto, parts para piezas repetidas.
  • El directorio templates define vistas completas como index, single, page, archive o 404.
  • El directorio parts contiene fragmentos reutilizables como header.html y footer.html.
  • Cuando una pieza aparece en varias plantillas, conviértela en part desde el principio para evitar divergencias.
  • templates/: contexto completo de la vista.

Cómo organizar /templates y /parts

Piensa en capas: templates para contexto, parts para piezas repetidas.

El directorio templates define vistas completas como index, single, page, archive o 404.

El directorio parts contiene fragmentos reutilizables como header.html y footer.html.

Cuando una pieza aparece en varias plantillas, conviértela en part desde el principio para evitar divergencias.

  • templates/: contexto completo de la vista.
  • parts/: bloques compartidos entre plantillas.
  • Menos copia y pega de markup.
  • Cambios globales más rápidos y seguros.

Crear index.html base con partes reutilizables

index.html debe ser sólido porque actúa como fallback del sistema de plantillas.

Diseñar template parts estables

Header y footer deben ser simples, semánticos y compatibles con navegación del editor.

Define parts con responsabilidad clara: navegación en header, enlaces legales o secundarios en footer.

Evita mezclar bloques de contenido editorial en template parts globales; eso complica reutilización.

Cuando un part cambie por tipo de contenido, crea variación específica en lugar de condicionar en exceso.

WordPress Themes Pro
22

Tema de bloques 02: templates y template parts sin duplicación

Aprende a estructurar plantillas de tema de bloques con HTML de bloques y partes reutilizables para mantener coherencia en todo el sitio.

Código del tema: wp:template-part

📘 Teoría

Cómo organizar /templates y /parts

Piensa en capas: templates para contexto, parts para piezas repetidas.

El directorio templates define vistas completas como index, single, page, archive o 404.

El directorio parts contiene fragmentos reutilizables como header.html y footer.html.

Cuando una pieza aparece en varias plantillas, conviértela en part desde el principio para evitar divergencias.

  • templates/: contexto completo de la vista.
  • parts/: bloques compartidos entre plantillas.
  • Menos copia y pega de markup.
  • Cambios globales más rápidos y seguros.

Crear index.html base con partes reutilizables

index.html debe ser sólido porque actúa como fallback del sistema de plantillas.

templates/index.html mínimo
<!-- wp:template-part {"slug":"header","tagName":"header"} /-->

<!-- wp:group {"tagName":"main","layout":{"type":"constrained"}} -->
<main class="wp-block-group">
  <!-- wp:query {"query":{"perPage":10,"pages":0,"offset":0,"postType":"post","order":"desc","orderBy":"date"}} -->
  <div class="wp-block-query">
    <!-- wp:post-template -->
    <!-- wp:post-title {"isLink":true} /-->
    <!-- wp:post-excerpt /-->
    <!-- /wp:post-template -->
    <!-- wp:query-pagination /-->
  </div>
  <!-- /wp:query -->
</main>
<!-- /wp:group -->

<!-- wp:template-part {"slug":"footer","tagName":"footer"} /-->

Diseñar template parts estables

Header y footer deben ser simples, semánticos y compatibles con navegación del editor.

1

Define parts con responsabilidad clara: navegación en header, enlaces legales o secundarios en footer.

2

Evita mezclar bloques de contenido editorial en template parts globales; eso complica reutilización.

3

Cuando un part cambie por tipo de contenido, crea variación específica en lugar de condicionar en exceso.

parts/header.html básico
<!-- wp:group {"layout":{"type":"constrained"}} -->
<div class="wp-block-group">
  <!-- wp:site-title {"level":0} /-->
  <!-- wp:navigation {"overlayMenu":"never"} /-->
</div>
<!-- /wp:group -->

🧪 Aprende probando

Ejemplo Ejemplo: plantilla 404 con UX de recuperación Estructura simple para ayudar al usuario a volver a contenido útil.

🏁 Retos

Reto Reto: incluir el footer como template part Completa un template para cerrar layout con la parte de pie.

🧰 Recursos

Test

Comprueba tus conocimientos con un test sobre WordPress Themes Pro.

Test de WordPress Themes Pro

¿Qué es esto?

Soy Cristian Eslava y a veces hago webs para procrastinar yo y vosotros 😉.

Esta la hice en febrero de 2026 para facilitar el aprendizaje de mis alumnxs. Aprender desarrollo web practicando. La idea es que crezca semanalmente con nuevos temas, tests y retos.

Inspirado en MDN, en W3Schools, en Codepen, en el crack de Manz y en mil sitios de documentación sobre desarrollo web. Quería aportar además de bloques teóricos con ejemplos, la gamificación de los retos y el sistema de test que ya tenía en culTest .

Si te gustó, si no te gustó, si quieres saludarme, o invitarme a 🍻 no dudes en escribirme en cristianeslava@gmail.com .