Tema clásico 01: estructura mínima profesional

Define la base de carpetas y archivos de un tema clásico para escalar sin caos cuando empieces a añadir plantillas y lógica.

La mayoría de problemas en temas clásicos empiezan con una base desordenada: archivos mezclados, includes sin criterio y funciones repartidas sin convención.

Esta primera lección define una estructura mínima que te permite crecer sin romper el proyecto en cuanto aparezcan nuevos requisitos.

Vamos a separar correctamente archivos raíz obligatorios, plantillas, partes reutilizables y recursos estáticos.

También fijaremos una regla importante: en plantillas se renderiza; en funciones auxiliares se prepara lógica reutilizable.

  • Empieza por lo esencial: style.css para cabecera de tema e index.php como fallback universal.
  • WordPress necesita style.css con metadatos válidos para reconocer el tema en el panel de administración.
  • index.php es la red de seguridad de la jerarquía: aunque falten plantillas específicas, evita errores fatales de render.
  • functions.php centraliza hooks y registro de capacidades del tema, pero no debería convertirse en un archivo monolítico.
  • style.css: identidad y metadatos del tema.

Archivos obligatorios y su responsabilidad

Empieza por lo esencial: style.css para cabecera de tema e index.php como fallback universal.

WordPress necesita style.css con metadatos válidos para reconocer el tema en el panel de administración.

index.php es la red de seguridad de la jerarquía: aunque falten plantillas específicas, evita errores fatales de render.

functions.php centraliza hooks y registro de capacidades del tema, pero no debería convertirse en un archivo monolítico.

  • style.css: identidad y metadatos del tema.
  • index.php: fallback final de plantillas.
  • functions.php: bootstrap técnico del tema.
  • screenshot.png: vista previa legible en admin.

Árbol recomendado para iniciar

No necesitas 40 archivos el día uno; necesitas una estructura coherente que no te bloquee mañana.

Bootstrap limpio en functions.php

Usa functions.php como punto de entrada y delega a archivos de inc para mantener orden.

Una práctica sólida es cargar setup y utilidades mediante require_once desde functions.php.

Con eso reduces conflictos al trabajar en equipo y encuentras rápido dónde editar cada comportamiento.

Evita incluir lógica de consultas pesadas en este archivo; reserva ese trabajo para hooks y contextos concretos.

WordPress Themes Pro
11

Tema clásico 01: estructura mínima profesional

Define la base de carpetas y archivos de un tema clásico para escalar sin caos cuando empieces a añadir plantillas y lógica.

Código del tema: style.css header

📘 Teoría

Archivos obligatorios y su responsabilidad

Empieza por lo esencial: style.css para cabecera de tema e index.php como fallback universal.

WordPress necesita style.css con metadatos válidos para reconocer el tema en el panel de administración.

index.php es la red de seguridad de la jerarquía: aunque falten plantillas específicas, evita errores fatales de render.

functions.php centraliza hooks y registro de capacidades del tema, pero no debería convertirse en un archivo monolítico.

  • style.css: identidad y metadatos del tema.
  • index.php: fallback final de plantillas.
  • functions.php: bootstrap técnico del tema.
  • screenshot.png: vista previa legible en admin.

Árbol recomendado para iniciar

No necesitas 40 archivos el día uno; necesitas una estructura coherente que no te bloquee mañana.

Estructura mínima escalable
mi-tema-clasico/
├─ style.css
├─ functions.php
├─ index.php
├─ header.php
├─ footer.php
├─ sidebar.php
├─ template-parts/
│  └─ content.php
├─ assets/
│  ├─ css/main.css
│  ├─ js/main.js
│  └─ img/
└─ inc/
   ├─ setup.php
   └─ helpers.php

Bootstrap limpio en functions.php

Usa functions.php como punto de entrada y delega a archivos de inc para mantener orden.

1

Una práctica sólida es cargar setup y utilidades mediante require_once desde functions.php.

2

Con eso reduces conflictos al trabajar en equipo y encuentras rápido dónde editar cada comportamiento.

3

Evita incluir lógica de consultas pesadas en este archivo; reserva ese trabajo para hooks y contextos concretos.

functions.php inicial
<?php
if (!defined('ABSPATH')) {
  exit;
}

require_once get_theme_file_path('/inc/setup.php');
require_once get_theme_file_path('/inc/helpers.php');

🧪 Aprende probando

Ejemplo Ejemplo: cabecera válida en style.css Metadatos mínimos para que WordPress detecte el tema correctamente.

🏁 Retos

Reto Reto: cargar archivo de setup Completa functions.php para incluir el archivo de configuración inicial del tema.

🧰 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 .