Debug y QA en temas WordPress: detectar fallos antes de producción

Configura un flujo real de depuración y control de calidad para temas, combinando WP_DEBUG, revisión visual y checklist técnico.

En desarrollo de temas WordPress, los errores caros son los que descubres tarde: cuando el cliente ya está editando contenido o cuando Google ya rastrea una versión rota.

Por eso no basta con probar que algo se ve bien en tu navegador: necesitas un proceso reproducible de debug y QA antes de cada release.

La combinación mínima profesional es activar depuración en local, revisar logs, testear plantillas críticas y pasar una checklist de accesibilidad y rendimiento.

Esta lección te enseña a montar ese flujo para encontrar problemas de templates, warnings PHP, consultas lentas y regresiones visuales.

  • Depura en local o staging, nunca mostrando errores al usuario final.
  • Activa WP_DEBUG y WP_DEBUG_LOG para registrar avisos en archivo, y mantén WP_DEBUG_DISPLAY desactivado para no exponer rutas ni detalles del servidor.
  • Con SCRIPT_DEBUG en true forzarás versiones no minificadas de assets de WordPress, útil cuando investigas problemas de JavaScript o estilos en bloques.
  • Si tu tema usa hooks complejos, revisar debug.log en cada iteración evita que notices pequeños terminen siendo bugs funcionales en producción.
  • No pruebes solo la home: valida los puntos donde más se rompe un tema.

Configurar depuración de forma segura

Depura en local o staging, nunca mostrando errores al usuario final.

Activa WP_DEBUG y WP_DEBUG_LOG para registrar avisos en archivo, y mantén WP_DEBUG_DISPLAY desactivado para no exponer rutas ni detalles del servidor.

Con SCRIPT_DEBUG en true forzarás versiones no minificadas de assets de WordPress, útil cuando investigas problemas de JavaScript o estilos en bloques.

Si tu tema usa hooks complejos, revisar debug.log en cada iteración evita que notices pequeños terminen siendo bugs funcionales en producción.

QA por plantillas y casos de negocio

No pruebes solo la home: valida los puntos donde más se rompe un tema.

Checklist de release del tema

Un release sin checklist es repetir errores ya conocidos.

Antes de etiquetar versión, pasa una revisión rápida de logs, validación visual responsive, contraste y navegación por teclado.

Incluye una prueba de rendimiento mínima (home, single y archive) para vigilar regresiones de CSS y JS.

Documenta incidencias, causa y fix; así el equipo aprende y el tiempo de QA baja en siguientes iteraciones.

  • Sin warnings PHP críticos en debug.log.
  • Sin errores de consola JavaScript en vistas principales.
  • Navegación funcional con teclado en cabecera y menús.
  • Métricas de rendimiento dentro del umbral definido por el proyecto.
WordPress Themes Pro
09

Debug y QA en temas WordPress: detectar fallos antes de producción

Configura un flujo real de depuración y control de calidad para temas, combinando WP_DEBUG, revisión visual y checklist técnico.

Código del tema: WP_DEBUG_DISPLAY

📘 Teoría

Configurar depuración de forma segura

Depura en local o staging, nunca mostrando errores al usuario final.

1

Activa WP_DEBUG y WP_DEBUG_LOG para registrar avisos en archivo, y mantén WP_DEBUG_DISPLAY desactivado para no exponer rutas ni detalles del servidor.

2

Con SCRIPT_DEBUG en true forzarás versiones no minificadas de assets de WordPress, útil cuando investigas problemas de JavaScript o estilos en bloques.

3

Si tu tema usa hooks complejos, revisar debug.log en cada iteración evita que notices pequeños terminen siendo bugs funcionales en producción.

Bloque recomendado para wp-config.php en local
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
define('SCRIPT_DEBUG', true);
@ini_set('display_errors', 0);

QA por plantillas y casos de negocio

No pruebes solo la home: valida los puntos donde más se rompe un tema.

1

Jerarquía y render

Comprueba que cada URL usa la plantilla esperada.

  • single, page, archive, category, search y 404 con contenido real.
  • CPTs y taxonomías personalizadas si el proyecto las usa.
2

Editor y frontend

El bloque debe comportarse igual editando y publicando.

  • Comparar estilos en editor y vista pública.
  • Verificar variantes de bloques y patrones del tema.
3

Integraciones

Detecta conflictos antes de que lleguen a soporte.

  • Probar con plugins clave (SEO, caché, formularios, WooCommerce).
  • Revisar menús, widgets, comentarios y paginación.

Checklist de release del tema

Un release sin checklist es repetir errores ya conocidos.

Antes de etiquetar versión, pasa una revisión rápida de logs, validación visual responsive, contraste y navegación por teclado.

Incluye una prueba de rendimiento mínima (home, single y archive) para vigilar regresiones de CSS y JS.

Documenta incidencias, causa y fix; así el equipo aprende y el tiempo de QA baja en siguientes iteraciones.

  • Sin warnings PHP críticos en debug.log.
  • Sin errores de consola JavaScript en vistas principales.
  • Navegación funcional con teclado en cabecera y menús.
  • Métricas de rendimiento dentro del umbral definido por el proyecto.

🧪 Aprende probando

Ejemplo Ejemplo: plantilla de checklist para QA de tema Base operativa para estandarizar revisiones antes de publicar cambios.

🏁 Retos

Reto Reto: completar configuración de debug Añade la constante que guarda los errores en archivo para poder auditarlos.

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