Cómo crear un tema de WordPress desde cero

tema WordPress creado desde cero con estructura de archivos PHP y jerarquía

Cómo crear un tema de WordPress desde cero

Crear un tema de WordPress desde cero tiene sentido en proyectos con requisitos muy específicos que ningún tema existente cubre, o cuando quieres entender en profundidad cómo funciona WordPress internamente. Para la mayoría de proyectos, un tema hijo o un starter theme son más eficientes. Pero si vas a hacerlo, aquí está el proceso real.

La estructura mínima de un tema WordPress

Un tema de WordPress necesita como mínimo dos archivos en una carpeta dentro de wp-content/themes/:

style.css — con la cabecera del tema:

/*
Theme Name: Mi Tema
Theme URI: https://miweb.com
Author: Tu Nombre
Description: Descripción del tema
Version: 1.0
*/

index.php — la plantilla de fallback para todo lo que WordPress no encuentre en otro archivo del tema. Con solo estos dos archivos ya tienes un tema activable, aunque en blanco.

La jerarquía de plantillas

WordPress usa un sistema de jerarquía para decidir qué archivo de plantilla cargar según el tipo de página que se está mostrando. Si no encuentra el archivo específico, sube en la jerarquía hasta llegar a index.php.

Los archivos más importantes:

front-page.php — la portada estática si está configurada.
home.php — el listado de posts del blog.
single.php — entrada individual del blog.
page.php — página estática.
archive.php — listados de categorías, etiquetas, fechas.
search.php — resultados de búsqueda.
404.php — página de error 404.
header.php — la cabecera, llamada con get_header().
footer.php — el pie, llamado con get_footer().
sidebar.php — la barra lateral, llamada con get_sidebar().
functions.php — funcionalidades del tema: hooks, soporte de características, registro de menús y áreas de widgets.

El Loop: cómo WordPress muestra el contenido

El Loop es el mecanismo central de WordPress para mostrar posts. Cualquier plantilla que muestre contenido usa esta estructura básica:

<?php if ( have_posts() ) : while ( have_posts() ) : the_post(); ?>
    <article id="post-<?php the_ID(); ?>" <?php post_class(); ?>>
        <h2><a href="<?php the_permalink(); ?>"><?php the_title(); ?></a></h2>
        <?php the_content(); ?>
    </article>
<?php endwhile; else : ?>
    <p>No se encontró contenido.</p>
<?php endif; ?>

El functions.php: declarar las capacidades del tema

El functions.php es donde el tema declara qué características de WordPress quiere usar. Sin estas declaraciones, algunas funcionalidades no estarán disponibles:

<?php
function mi_tema_setup() {
    // Soporte para imágenes destacadas
    add_theme_support( 'post-thumbnails' );
    
    // Soporte para el título dinámico en el <head>
    add_theme_support( 'title-tag' );
    
    // Soporte para menús de navegación
    register_nav_menus( array(
        'primary' => __( 'Menú principal', 'mi-tema' ),
        'footer'  => __( 'Menú del pie', 'mi-tema' ),
    ) );
    
    // Soporte para HTML5 en formularios y galerías
    add_theme_support( 'html5', array( 'search-form', 'gallery', 'caption' ) );
}
add_action( 'after_setup_theme', 'mi_tema_setup' );

// Cargar estilos y scripts correctamente
function mi_tema_scripts() {
    wp_enqueue_style( 'mi-tema-style', get_stylesheet_uri() );
}
add_action( 'wp_enqueue_scripts', 'mi_tema_scripts' );

Starter themes en lugar de empezar desde cero

Si el objetivo es tener un tema propio pero sin reinventar la rueda, los starter themes son el punto de partida correcto. Underscores (_s) es el starter theme oficial de WordPress: código mínimo, sin estilos impuestos, listo para construir encima. Sage de Roots es para desarrolladores que usan herramientas modernas (Blade, Laravel Mix, Tailwind). Timber separa la lógica PHP de las plantillas Twig, lo que hace el código más mantenible en proyectos grandes.

Hosting Web SSD ultrarrápido e ilimitado

Hosting Web SSD NVMe, 100% Ecológico y sostenible, máxima velocidad y tráfico ilimitado en tu Hosting Web, con certificado SSL gratuito 

Hosting Web logo

Hosting Web ecológico, profesional e ilimitado en España,  somos especialistas en servicios de Hosting SSD, con más de 22 años de experiencia y un equipo de profesionales altamente cualificados a su disposición las 24 Horas.