Tutorial de desarrollo WordPress: guía completa para principiantes en 2026
Esta guía es el manual práctico que me habría gustado tener cuando empecé a entregar sitios WordPress en 2006. No da nada por supuesto salvo un equipo limpio y ganas de leer documentación. Al terminar tendrás un entorno local, un tema de bloques funcional, un plugin escrito por ti y una vía de despliegue. Sin magia y sin atajos que se rompen más adelante.
La siguiente etapa está en el pilar de servicios de WordPress headless y la capa de front-end en la guía de Tailwind CSS en el desarrollo WordPress.
En resumen
- WordPress 6.7+ sobre PHP 8.3 es la línea estable de 2026.
- Temas de bloques, theme.json y un poco de PHP forman el kit de inicio moderno.
- Composer, WP-CLI y un entorno local basado en Docker no son opcionales.
- Headless es una habilidad de segunda etapa, no un punto de partida.
- La forma más rápida de aprender es entregar un sitio real (pequeño), no acumular un portafolio de tutoriales a medias.
Qué es WordPress en 2026
WordPress es un sistema de gestión de contenidos de código abierto que impulsa una parte considerable de los sitios web del mundo. Funciona sobre PHP y guarda el contenido en una base de datos (normalmente MySQL o MariaDB). Sobre el núcleo conviven dos modelos de extensión: los temas (controlan la presentación y la experiencia editorial) y los plugins (añaden funcionalidades). El editor de bloques (Gutenberg), incluido en el núcleo desde WordPress 5.0 en 2018, es la interfaz editorial por defecto y el terreno principal del desarrollo nuevo.
Qué ha cambiado en 2026 respecto a 2018: el editor de bloques ha madurado hasta el Full Site Editing (FSE), los temas de bloques han sustituido a los clásicos en los proyectos nuevos, theme.json se ha convertido en la fuente de verdad de los tokens de diseño y la REST API junto con WPGraphQL ha hecho viables los front-ends headless a gran escala. El mínimo de PHP ha subido: da por hecho PHP 8.3 como mínimo.
WordPress headless o tradicional para principiantes
Un error frecuente en 2026 es empezar por headless. No lo hagas. WordPress headless es una arquitectura por capas: un back-end (WordPress), un front-end separado (Astro, Next.js, etc.) y una plataforma de alojamiento (Cloudflare Workers, Vercel, etc.). Quien aprende las tres a la vez no entiende ninguna.
Empieza por el monolito. Construye algunos sitios en los que WordPress muestre tanto el editor como las páginas públicas. Cuando el modelo de datos, la experiencia del editor y el ciclo de despliegue te resulten familiares, añade un front-end headless. El orden importa porque los front-ends headless consumen lo que produce WordPress; no puedes razonar sobre el front-end sin entender antes la forma de los datos.
Headless tiene sentido como habilidad de segunda etapa. El pilar de servicios de WordPress headless explica cuándo compensa esa complejidad.
Cómo configurar un entorno local de desarrollo WordPress
La base para 2026:
- Instala Docker Desktop (u OrbStack en macOS).
- Instala Lando o DDEV para tener una pila reproducible de WordPress y base de datos.
- Añade Composer para gestionar las dependencias de PHP.
- Añade WP-CLI para operar WordPress desde la línea de comandos.
- Usa una terminal de verdad: zsh en macOS, PowerShell moderno en Windows o cualquier shell de Linux.
Evita XAMPP y MAMP en proyectos nuevos. Ambos funcionan la primera tarde y fallan de forma sutil la primera vez que colaboras con otro desarrollador o despliegas en un hosting real.
Comprueba la configuración levantando un sitio nuevo con WordPress 6.7+, iniciando sesión, instalando un plugin con WP-CLI y editando un bloque en el editor. Si las tres cosas funcionan en menos de quince minutos, el entorno está listo.
Cómo crear tu primer tema de bloques de WordPress
Los temas de bloques son el estándar en 2026. El modelo mental mínimo:
- El editor de bloques lee los tokens globales (colores, fuentes, espaciados, anchos de diseño) desde
theme.json. - Las plantillas y las partes de plantilla son archivos HTML con marcado de bloques, no archivos PHP.
- Los patrones (patterns) son composiciones de bloques reutilizables, registradas mediante hooks de PHP o incluidas como archivos PHP en
/patterns. - Los bloques a medida (cuando de verdad hacen falta) son componentes de JavaScript y React compilados a partir de
block.jsony un bundle JS.
Primer proyecto práctico: crea un tema de bloques de una sola página con un hero en la portada, tres tarjetas de características y un pie de página. Nada de PHP salvo la cabecera del tema y una llamada a add_theme_support. Haz evolucionar el diseño solo a través de theme.json y del marcado de bloques. Este único proyecto enseña temas de bloques en aproximadamente una semana.
Para la capa del sistema de diseño, Tailwind v4 con WordPress 6.7+ es el patrón estable de producción en 2026, explicado en detalle en la guía de Tailwind CSS en el desarrollo WordPress.
Cómo escribir tu primer plugin de WordPress
Los plugins amplían WordPress con funciones que no deben pertenecer al tema. Ejemplos: un tipo de contenido personalizado para “case study”, un endpoint REST que sirve un catálogo en JSON, una tarea Cron que purga una caché.
Esqueleto mínimo de un plugin:
<?php
/**
* Plugin Name: My Site Utilities
* Description: Site-specific helpers for My Site.
* Version: 0.1.0
* Requires PHP: 8.3
*/
declare(strict_types=1);
namespace MySiteUtils;
add_action('init', static function (): void {
register_post_type('case_study', [
'public' => true,
'label' => 'Case studies',
'supports' => ['title', 'editor', 'thumbnail', 'custom-fields'],
'show_in_rest' => true,
'rest_base' => 'case-studies',
]);
});Este plugin registra un tipo de contenido personalizado, lo muestra en el editor y lo pone a disposición vía REST. Con diez líneas de PHP, un principiante tiene en sus manos toda la primitiva de modelado de contenido sobre la que está construido WordPress.
El siguiente paso son los hooks. WordPress tiene actions (eventos a los que respondes) y filters (valores que transformas). Lee el Make WordPress Plugin Handbook para el modelo de referencia. La idea clave: no modifiques archivos del núcleo; usa hooks.
Tablas de la base de datos de WordPress que todo desarrollador debe conocer
Muchos principiantes evitan la base de datos durante los primeros seis meses. Ese es el error. WordPress guarda casi todo en wp_posts, wp_postmeta, wp_options, wp_users y wp_usermeta. En cuanto estas cinco tablas cobran sentido, ningún plugin ni tema vuelve a parecer magia.
Ejercicio práctico: abre wp-cli shell e inspecciona algunas filas. Busca la entrada que acabas de publicar. Mira su post_content. Mira sus metadatos. Escribe una consulta que liste todas las entradas del tipo de contenido personalizado por estado. Veinte minutos de esto enseñan más que una semana leyendo código de plugins.
Cómo usar la REST API de WordPress
La REST API de WordPress forma parte del núcleo desde la versión 4.7, en 2016, y es estable en 2026. Por defecto, todos los tipos de contenido públicos, todas las taxonomías y todos los comentarios están disponibles en /wp-json/wp/v2/.... Los tipos de contenido personalizados se activan con 'show_in_rest' => true.
Para un principiante, la REST API importa porque:
- Es la forma en que el editor de bloques habla con el back-end (el propio editor es un cliente REST).
- Es la principal superficie de integración para front-ends headless (Astro, Next.js).
- Es la vía por la que los sistemas externos (una app móvil, un agente de IA vía MCP, una herramienta de sincronización) leen el contenido de WordPress.
Ejercicio práctico: abre https://your-local-site.localhost/wp-json/wp/v2/posts en un navegador. Lee el JSON. Añade ?per_page=5&_fields=id,title,link. En diez minutos, la REST API deja de parecer abstracta.
Fundamentos de seguridad en WordPress y Core Web Vitals
Dos áreas en las que los principiantes se queman durante el primer año si las ignoran:
Seguridad. Usa contraseñas de administrador largas y únicas, 2FA desde el primer día, un plugin de seguridad de confianza (Wordfence, Kadence Security o un WAF a nivel de hosting) y una solución de copias de seguridad de verdad. Nunca edites wp-config.php de forma que los secretos acaben en un repositorio público. No instales plugins pirateados (nulled); el riesgo de malware es real.
Core Web Vitals. Largest Contentful Paint, Interaction to Next Paint y Cumulative Layout Shift afectan directamente al posicionamiento en buscadores y a la percepción de los usuarios. Pasa PageSpeed Insights por tu sitio cada semana. Las mayores mejoras para un principiante: optimiza las imágenes (AVIF o WebP), evita maquetadores pesados en sitios donde el rendimiento es crítico y quédate en un hosting WordPress gestionado que se ocupe de la caché y la CDN.
La accesibilidad se trata en la guía de WCAG 2.2, BFSG y la Ley Europea de Accesibilidad. El techo de rendimiento se trata en el pilar de servicios de WordPress headless.
Cómo aprender desarrollo WordPress en el primer mes
Una lista práctica de hitos que supera cualquier enfoque basado solo en tutoriales:
- Semana 1: entorno local, primer tema de bloques, primer plugin, una entrada publicada.
- Semana 2: un tipo de contenido personalizado con tres entradas, una consulta REST que las devuelve, un patrón de bloques propio.
- Semana 3: desplegar en un hosting gestionado, configurar HTTPS, configurar copias de seguridad, añadir un plugin de seguridad básico.
- Semana 4: escribir una única entrada de blog de 1500 palabras sobre algo que hayas aprendido y publicarla.
Al final del mes habrás entregado un sitio real (pequeño), escrito código real (pequeño) y tendrás un resultado público. Esa es la puerta de entrada al trabajo profesional con WordPress en 2026, no un portafolio de ejercicios de tutoriales interactivos a medias que nunca salieron del entorno de pruebas.
Qué aprender después de los fundamentos de WordPress
Después del primer mes:
- Aprende theme.json a fondo leyendo la referencia de theme.json.
- Aprende en profundidad un plugin del ecosistema (WooCommerce o Advanced Custom Fields).
- Añade Tailwind v4 al tema de bloques con la guía de Tailwind CSS en el desarrollo WordPress.
- Pasa uno de tus sitios a headless con Astro o Next.js según el pilar de servicios de WordPress headless.
- Lee cada mes las notas de versión de WordPress 6.x. La plataforma avanza; mantenerse al día forma parte del trabajo.
A los seis meses ya no eres principiante. El camino a partir de ahí es la especialización: rendimiento, seguridad, headless, integración de IA, cumplimiento normativo de la UE. WPPoland contrata en todas estas áreas desde 2007; la página de empleo recoge los puestos abiertos.
