5.4 · Introducción al desarrollo WordPress

Nivel 5 · Mantenimiento, seguridad avanzada & desarrollo

5.4Introducción al desarrollo WordPress

Objetivo: comprender el mecanismo de los hooks y saber dónde colocar un pequeño fragmento de código sin tocar el núcleo de WordPress.
Tiempo estimado: 20 min · lectura autónoma · Si solo tienes 5 min: lee «Lo esencial en 30s» + el esquema.

Lo esencial en 30 segundos

  • Los hooks son el mecanismo de extensión de WordPress: permiten insertar código sin modificar el núcleo.
  • Acción = ejecutar algo en un momento; filtro = modificar un dato al paso.
  • El código personalizado va en el functions.php de un tema hijo, nunca en el tema padre ni en el núcleo, y se prueba en local.

Minicaso hilado — un pequeño ajuste a medida

Hassan quiere añadir una mención «pieza única» bajo el precio de las creaciones. Samir busca primero un plugin; ninguno encaja exactamente. Entonces escribe un pequeño filtro en el tema hijo, probado en local, que añade la mención únicamente en la categoría correspondiente. Documenta el fragmento para poder encontrarlo más adelante.

Continuación del caso 5.3 — tras la conformidad, un poco de código a medida.

1. El mecanismo de los hooks

WordPress está diseñado para extenderse sin ser modificado. El mecanismo central es el hook: un punto de anclaje donde se engancha el código. Las acciones permiten ejecutar algo en un momento preciso (tras guardar un artículo, al enviar un correo); los filtros permiten modificar un dato al paso (un título, un precio, un texto).

Temas y plugins utilizan masivamente estos hooks: es lo que permite hacerlos convivir. Comprender esta lógica basta para leer mucho código WordPress y para intervenir puntualmente, sin convertirse en desarrollador de inmediato.

2. Dónde colocar el código

Un tema contiene plantillas, estilos y un archivo functions.php donde se declaran funciones. Un plugin es un paquete autónomo que añade funcionalidades. Samir nunca toca el núcleo de WordPress: la próxima actualización lo borraría todo.

El código personalizado va en el functions.php de un tema hijo (o en un pequeño plugin dedicado), nunca en el padre. Se prueba en local o en staging, se comenta y se respalda. Un fragmento bien dirigido suele valer más que un gran plugin para una necesidad muy precisa.

Error frecuente de interpretación: «puedo pegar mi código en el functions.php del tema padre». No: la próxima actualización del tema borrará el archivo. El tema hijo (o un plugin propio) es el lugar seguro.
Extender WordPress con los hooks WordPress desencadena un evento, un hook llama a su código colocado en el tema hijo. EventoWordPress+Hookacción/filtro+Código enel tema hijo+Resultadomodificado Un hook engancha su código en el momento adecuado; el código vive en el tema hijo.
El principio del hook: un punto de anclaje, código en el tema hijo.
Versión en texto del esquema (SEO / lectores de pantalla / traducción): 1) WordPress desencadena un evento. 2) Un hook (acción o filtro) llama a su código. 3) El código está colocado en el tema hijo. 4) El resultado se muestra. Lección: extender sin modificar el núcleo.

🔎 Ejemplo concreto — Añadir una mención en una categoría (caso Samir)

Necesidad: «pieza única» bajo el precio, categoría creaciones.
1. Buscar un plugin → ninguno encaja.
2. Tema hijo activo.
3. Filtro probado en local sobre el precio mostrado.
4. Verificación: solo categoría creaciones.
5. Fragmento comentado + copia de seguridad.
→ Ninguna modificación del tema padre.

Resultado: un ajuste preciso y duradero.

Lección: buscar primero el plugin, programar después, siempre en el tema hijo.

Vocabulario de la sección

Hook
Punto de anclaje donde se engancha código para extender WordPress.

Ejemplo sencillo: un filtro sobre el precio mostrado.

Lo que no es: modificar el núcleo de WordPress.

Reflejo: extender por los hooks, no por el núcleo.

Acción
Hook que ejecuta código en un momento preciso.

Ejemplo sencillo: enviar una notificación tras la publicación.

Lo que no es: confundir acción y filtro.

Reflejo: acción = hacer en un momento.

Filtro
Hook que modifica un dato al paso y lo devuelve.

Ejemplo sencillo: añadir una mención al precio.

Lo que no es: mostrar directamente sin devolver el valor.

Reflejo: filtro = modificar y devolver.

functions.php
Archivo del tema donde se declaran funciones y hooks.

Ejemplo sencillo: el archivo del tema hijo.

Lo que no es: editar el del tema padre.

Reflejo: funciones propias en el tema hijo.

Plugin propio
Pequeño plugin dedicado a una funcionalidad, independiente del tema.

Ejemplo sencillo: un fragmento empaquetado para durar.

Lo que no es: ponerlo todo en el tema con riesgo de perderlo al cambiarlo.

Reflejo: el código de negocio puede vivir en un plugin.

En la práctica — Leer y colocar un hook

  1. Localice en la documentación un hook adecuado para una pequeña necesidad.
  2. Active un tema hijo y abra su functions.php.
  3. Añada un filtro o una acción simple, probada en local.
  4. Verifique el resultado, comente el fragmento y guárdelo.
Un primer hook comprendido y colocado en el lugar correcto, sin riesgo para el tema padre.

Guion listo para decir — explicar el desarrollo a medida (25 s)

«Para una necesidad muy precisa, puedo añadir un pequeño fragmento de código en un tema hijo, sin tocar el núcleo de WordPress. Se prueba por separado y se conserva durante las actualizaciones. Para todo lo demás, priorizamos un plugin contrastado.»

Mostrar prudencia: primero el plugin, después el código.

Modelo copiar-pegar — ficha de fragmento

NECESIDAD: _______________
PLUGIN EXISTENTE PROBADO: sí / no
HOOK UTILIZADO: acción / filtro
ARCHIVO: functions.php del tema hijo
PROBADO EN LOCAL / STAGING: sí / no
COMENTARIO EN EL CÓDIGO: sí / no
COPIA DE SEGURIDAD DEL FRAGMENTO: sí / no

Pequeño ajuste

Un filtro específico en el tema hijo.

Función de negocio

Un pequeño plugin propio, independiente del tema.

Aprendizaje

Probar hooks en local en un sitio de demostración.

Equipo

Versionar el código y documentar cada fragmento.

✓ Buenas prácticas

  • Buscar un plugin antes de programar.
  • Pasar siempre por el tema hijo.
  • Probar en local o en staging.

✗ Errores frecuentes

  • Modificar el núcleo de WordPress.
  • Pegar código en el tema padre.
  • Dejar un fragmento sin probar en producción.

Puntos clave

  • Los hooks extienden WordPress sin modificar el núcleo.
  • Acción = ejecutar; filtro = modificar un dato.
  • El código va en el functions.php del tema hijo.
  • Se prueba en local y se documenta.

Reto 48 h — aplícalo mañana

Encuentre un hook sencillo en la documentación, añádalo en un tema hijo y verifique el resultado en local. Comente el fragmento. 30 minutos.

Lista de salida de la sección
  • Distingo acciones y filtros.
  • Coloco mi código en un tema hijo.
  • Pruebo y documento un fragmento.
Autoevaluación 1-5: ¿comprendo el principio de un hook?¿mi código está en el lugar correcto?

Preguntas frecuentes

¿Hay que aprender PHP para desarrollar en WordPress?

Sí, PHP es el lenguaje de WordPress, junto con HTML, CSS y JavaScript según las necesidades. Sin embargo, se puede empezar con pequeños hooks sin ser experto y luego profundizar si el desarrollo le atrae.

¿Plugin existente o código a medida?

Busque siempre primero un plugin contrastado: menos mantenimiento y probado por numerosos sitios. El código a medida se justifica cuando ningún plugin responde o para una necesidad muy precisa, con un fragmento específico en lugar de un gran plugin.

¿Dónde probar mi código sin riesgo?

En local o en un sitio de staging, con un tema hijo. Nunca directamente en producción en el sitio del cliente. Haga copia de seguridad antes y conserve un registro del fragmento.

Comprueba tu comprensión

¿Qué es un hook en WordPress?

Recursos adicionales (opcional, para ir más allá)

Examen del nivel 5Preguntas inéditas y más difíciles para validar tus conocimientos