Está usted mirando el panel de administración de WordPress y pensando: «Puedo hacer más que solo arrastrar y soltar bloques». O quizá ya escribe PHP/JavaScript y quiere entender cómo funciona por dentro el CMS más popular del mundo. Ambos escenarios llevan a la misma pregunta: ¿por dónde empezar con el desarrollo en WordPress para no ahogarse en documentación y abandonar a la semana?

El problema no es la complejidad de WordPress. El problema es que la mayoría de las «guías para principiantes» o bien explican cómo instalar un tema desde el panel de administración, o bien lo lanzan a usted de inmediato a crear un plugin con hooks y la REST API. Casi no hay un punto intermedio, ni una hoja de ruta desde cero hasta su primer código con sentido. Nosotros pasamos por eso y lo reunimos aquí: sin relleno, con herramientas concretas y enlaces a recursos activos.

💡 Resumen rápido:

• PHP, CSS, HTML: tres lenguajes que necesita de inmediato; JavaScript viene después, una vez que domine lo básico
• Entorno local: WordPress Studio o Local, funcionando en 5 minutos, sin necesidad de hosting
• Temas: el mejor punto de entrada para principiantes; plugins: el siguiente nivel; núcleo: para desarrolladores PHP con experiencia
• Recursos oficiales: Developer Resources, Learn WordPress y WP-CLI cubren la mayoría de las dudas habituales
• Comunidad: foros, WordCamps y canales de Slack, lo que convierte el aprendizaje en solitario en una carrera profesional

1. Sobre qué está construido WordPress

WordPress está escrito en PHP y almacena datos en MySQL. No se trata de una combinación insulsa de «script más base de datos»: a lo largo de más de 20 años de evolución, ha crecido un ecosistema alrededor del núcleo con cientos de API, un sistema de hooks, la REST API, un editor de bloques y su propia utilidad de línea de comandos. Pero al empezar, un desarrollador solo necesita entender tres capas.

PHP maneja la lógica. Cada página del sitio se ensambla a partir de plantillas PHP que llaman a funciones del núcleo y de plugins, consultan la base de datos mediante WP_Query y generan la respuesta HTML. Sin PHP no puede escribir un solo tema ni plugin; es un requisito indispensable desde el primer día.

CSS y HTML forman la capa de presentación. Los temas de WordPress son principalmente archivos PHP, pero se ven como usted los describa en CSS. El WordPress moderno usa el editor de bloques (Gutenberg), y entender CSS Flexbox/Grid es más importante ahora que hace cinco años. HTML es el pegamento: el marcado para widgets, menús y plantillas.

JavaScript es el cuarto lenguaje. No es obligatorio al principio (puede escribir un tema sin nada de JS), pero si planea trabajar con bloques de Gutenberg o elementos interactivos, React y @wordpress/scripts se convertirán en sus herramientas. Deje JS para más adelante, una vez que domine la combinación de PHP y CSS.

2. Entorno local: dónde escribir código

La primera regla del desarrollo en WordPress: nunca experimente en un sitio en vivo. Un functions.php roto sin acceso FTP significa una noche de pánico y restaurar desde una copia de seguridad. Por suerte, montar un WordPress local es más fácil ahora que nunca.

WordPress Studio es una aplicación gratuita del equipo oficial que funciona en Windows y macOS. Se inicia con un clic, usa WebAssembly para aislar los sitios y no requiere Docker ni XAMPP. Una opción ideal para su primer contacto con el código.

Local (antes Local by Flywheel) es una alternativa con una interfaz más rica: cambio de versión de PHP, exploración de la base de datos mediante Adminer y URL de demostración para mostrar a clientes. Es adecuado si planea ejecutar varios proyectos en paralelo.

Para quienes ya están familiarizados con contenedores, la imagen oficial de Docker wordpress y wp-env (un paquete del equipo de Gutenberg) le dan control total sobre el entorno. Pero al principio esto es excesivo; Studio o Local cubrirán sus necesidades durante los próximos seis meses a un año.

3. Primer camino: desarrollo de temas

Los temas son la entrada más natural al desarrollo en WordPress. Ve resultados al instante, trabaja con los tres lenguajes principales (PHP, CSS, HTML) y puede curiosear cómo están construidos otros temas, ya que el código es abierto.

Empiece con un tema hijo. Este es el enfoque más seguro: crea una carpeta, añade un style.css con un comentario de cabecera y un functions.php que encola el tema padre. Luego sobrescribe una plantilla, añade un archivo CSS, se engancha a una acción. Pequeños logros cada día.

La jerarquía de plantillas de WordPress es un documento que vale la pena imprimir y colgar sobre su escritorio. Muestra qué archivo PHP se llama para cada página: front-page.php → home.php → index.php y así sucesivamente. Entender esta cadena es la mitad de la profesión del desarrollador de temas.

Una vez que domine el tema hijo, intente escribir un tema desde cero. El conjunto mínimo: index.php, style.css y functions.php. Añada soporte para el editor de bloques mediante add_theme_support('wp-block-styles') y menús mediante register_nav_menus(). WordPress Developer Resources contiene una lista completa de las opciones disponibles de add_theme_support con ejemplos; mantenga esa pestaña abierta.

4. Segundo camino: desarrollo de plugins

Los plugins son código que extiende WordPress de forma independiente al tema. Un foro, una tienda en línea, un sistema de reservas, tipos de contenido personalizados: todo son plugins. La barrera de entrada es más alta que con los temas: necesita entender los hooks (add_action, add_filter), conocer $wpdb y ser capaz de leer código ajeno.

Un plugin mínimo es un único archivo PHP con una cabecera /* Plugin Name: ... */. Ya puede contener un hook que, por ejemplo, añada texto al pie del sitio mediante add_filter('the_content', ...). Intente escribir uno hoy mismo; le llevará 10 minutos y le quitará el miedo a la palabra «plugin».

El siguiente paso es estudiar el Manual de plugins en los Recursos para desarrolladores. Cubre la estructura del plugin, la activación y desactivación, el trabajo con la base de datos y la creación de páginas de ajustes. No intente leerlo todo; abra la sección relevante según la necesite.

La regla principal para quien empieza con plugins: no reinvente la rueda. Ya existe un plugin para casi cualquier tarea. Vea cómo está resuelto en un plugin gratuito popular del repositorio; ese es el mejor libro de texto. El repositorio de WordPress.org contiene más de 60 000 plugins con código abierto.

5. Tercer camino: contribuir al núcleo de WordPress

Esto no es para principiantes, pero conocer esta posibilidad es útil. WordPress es un proyecto de código abierto y cada versión contiene parches de cientos de desarrolladores de todo el mundo.

La participación requiere conocimientos sólidos de PHP, conocer los Estándares de codificación y la disposición a pasar por una revisión de código. El proceso se gestiona mediante tickets de Trac en core.trac.wordpress.org. Puede empezar con la etiqueta good-first-bug: son errores pequeños seleccionados específicamente para nuevos colaboradores.

Incluso si no planea enviar parches al núcleo, leer los tickets de Trac y sus discusiones es una forma excelente de entender cómo se toman las decisiones de arquitectura en un proyecto con millones de instalaciones.

6. Dónde aprender: recursos vivos en lugar de enlaces obsoletos

El Codex ha muerto; viva Developer Resources. Este es el portal oficial que reemplazó al antiguo Codex: referencia de código para cada función y clase, guías sobre temas y plugins, el editor de bloques, la API REST y WP-CLI. Si va a abrir una sola pestaña, abra esta.

Learn WordPress ofrece cursos estructurados gratuitos del equipo de WordPress.org. Hay videos, materiales de texto y entornos de prueba para practicar. La ruta «Beginner WordPress Developer» lo lleva desde la instalación hasta su primer plugin en unas pocas horas.

Para preguntas específicas, use el foro de soporte de WordPress.org y Stack Overflow. En Stack Overflow la etiqueta wordpress contiene más de 60.000 preguntas respondidas; es casi seguro que alguien ya hizo la suya. El foro de soporte es bueno para problemas con plugins y temas específicos.

WP-CLI es una herramienta de línea de comandos que le ahorrará horas. El comando wp scaffold plugin crea un esqueleto de plugin, wp search-replace cambia URLs en toda la base de datos, wp cron event list muestra las tareas programadas. Domine al menos 10 comandos; la inversión se amortiza en su primera semana.

7. La comunidad sin la cual no puede triunfar

Un desarrollador en solitario que no se relaciona con la comunidad inevitablemente reinventa la rueda y se pierde cambios importantes. La comunidad de WordPress es una de las más amigables del código abierto.

Desde un punto de vista práctico: el Slack de WordPress tiene canales para cada área: #core para discusiones del núcleo, #themes para temas, #plugins para plugins y #docs para documentación. Puede hacer una pregunta allí y obtener respuesta de los desarrolladores que escriben ese mismo núcleo. Las WordCamps son conferencias de un día que se realizan en todo el mundo (incluyendo Rusia y la CEI) donde conoce a las personas cuyos plugins usa.

Hay otras formas de participar: traducir la documentación y la interfaz a su idioma, probar versiones beta, ayudar en el foro de soporte. Cada una de estas actividades profundiza su comprensión del sistema mientras construye su reputación. En el ecosistema de WordPress, la reputación se convierte directamente en clientes.

🎥 Video relacionado

Una guía de texto es un marco de referencia, pero a veces es más fácil ver algo una vez. Aquí tiene una hoja de ruta detallada para desarrolladores de WordPress con un desglose de herramientas y etapas de aprendizaje:

⁉️🤔 Preguntas frecuentes

¿Con qué lenguaje debería empezar, PHP o JavaScript?

PHP. WordPress está construido sobre PHP, y sin él no entenderá los hooks, las plantillas ni WP_Query. JavaScript es necesario para el editor de bloques y la interactividad del frontend, pero ese es el segundo paso. La ruta: PHP + HTML/CSS → fundamentos → primer plugin → JavaScript/React.

¿Necesito aprender MySQL?

No al principio. WordPress abstrae el trabajo con la base de datos mediante WP_Query y $wpdb. Pero entender la estructura de las tablas wp_posts, wp_postmeta y wp_options le ahorrará horas de depuración. Dedique un tutorial corto de phpMyAdmin o Adminer; eso es suficiente para los primeros seis meses.

¿Cuánto se tarda en pasar de cero al primer plugin?

Si ya conoce PHP a nivel básico, de 2 a 3 semanas con práctica diaria. Empezando desde cero en programación, de 2 a 3 meses. Su primer plugin será simple (por ejemplo, un shortcode que muestre la fecha actual con formato), pero es código real y funcional.

¿Tema o plugin: qué es mejor para la carrera?

Los desarrolladores de temas siempre tienen demanda porque cada sitio necesita un tema. Los desarrolladores de plugins ganan más mediante la distribución (el modelo freemium en WordPress.org). La ruta ideal: empiece con temas para conocer el ecosistema, luego escriba un plugin que resuelva una necesidad concreta. Los mejores especialistas pueden hacer ambas cosas.

¿Necesito GitHub?

Absolutamente. Incluso si escribe «para el cajón», Git lo salvará cuando rompa su código y no recuerde qué cambió. Además, un enlace a un perfil de GitHub con repositorios activos de temas y plugins de WP es el mejor argumento al buscar clientes. Empiece con git init en la carpeta de su tema hoy mismo.

Qué hacer ahora mismo: su primera semana

Una hoja de ruta no funciona si solo la lee. Aquí tiene un plan para los próximos siete días, concreto y alcanzable.

Instale WordPress Studio o Local. Cree un sitio de prueba. Abra la carpeta wp-content/themes, cree un tema hijo para twentytwentyfive y consiga que cargue en el panel de administración. Ese es el día uno, y posiblemente el más importante: ha superado la barrera de «no sé dónde hacer clic».

Días dos y tres: añada un hook a functions.php (por ejemplo, wp_enqueue_scripts para encolar su propio archivo CSS) y cambie el color de los encabezados mediante ese archivo. Un resultado pequeño, pero ya está interactuando con los hooks de WordPress.

Días cuatro y cinco: cree una carpeta separada en wp-content/plugins, escriba un plugin mínimo con un shortcode mediante add_shortcode(). Inserte el shortcode en cualquier entrada y vea el resultado. Eso es todo; ya es desarrollador de plugins.

Días seis y siete: regístrese en el Slack oficial de WordPress, suscríbase al canal #core y lea algunos tickets en el sistema Trac de WordPress. No para participar, sino para ver cómo se toman las decisiones en el proyecto con el que ahora trabaja.

La regla principal para la primera semana: programe cada día. 30 minutos de práctica valen más que tres horas leyendo documentación. WordPress es un ecosistema que se aprende con las manos.

🔗 Developer Resources, documentación oficial de WordPress