0 Comentarios
Gestionar una web en WordPress puede ser una experiencia genial... hasta que algo se rompe y no sabes ni por dónde empezar. Ahí es donde entra en juego el modo debug. Si alguna vez te has encontrado con una pantalla blanca de la muerte, un plugin que rompe el diseño o errores que parecen venir de otro planeta, este artículo es para ti.
Vamos a explicarte paso a paso cómo usar el modo debug de WordPress correctamente, para que sepas qué está fallando y cómo solucionarlo. Y tranqui, lo haremos sin complicaciones técnicas innecesarias.
El modo debug (o modo de depuración) es una función interna de WordPress que permite mostrar errores, avisos y advertencias que normalmente estarían ocultos. Es como encender una linterna en una habitación oscura: no arregla el desorden, pero te muestra dónde está.
Sirve para:
Saber si un plugin está generando errores.
Detectar conflictos entre temas.
Revisar avisos de funciones obsoletas o mal usadas.
Ver detalles técnicos que ayudan a los desarrolladores (y también a curiosos como tú y como nosotros).
Eso sí, no está pensado para dejarlo siempre activado. Ya hablaremos de eso más abajo.
No hace falta tener la web hecha un desastre para usarlo. De hecho, cuanto antes lo actives cuando detectas algo raro, mejor. Estas son algunas situaciones típicas:
Acabas de instalar un plugin y algo ha dejado de funcionar.
Ves un error 500 en pantalla y no sabes por qué.
Tu tema personalizado da fallos intermitentes.
Estás desarrollando una funcionalidad y quieres ver qué devuelve exactamente.
Es una herramienta clave para desarrolladores, sí, pero también para usuarios intermedios que quieren tener un poco más de control.
Este es el método clásico, el que siempre funciona:
Entra en el panel de tu hosting o vía FTP y localiza el archivo wp-config.php, en la raíz de tu instalación de WordPress.
Abre el archivo con un editor de texto (puede ser el del propio hosting).
Busca la línea que dice define( 'WP_DEBUG', false );
Cámbiala por esto:
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );
Con esto activas la depuración, guardas los errores en un archivo de log y evitas que se muestren en pantalla a los usuarios (muy importante si la web está en producción).
El archivo de errores se guardará en wp-content/debug.log.
Si lo del FTP te da urticaria, no pasa nada. Hay plugins que te lo ponen en bandeja:
WP Debugging: te permite activar y desactivar opciones de depuración desde el panel.
Query Monitor: además de mostrar errores, te da información muy útil sobre consultas a la base de datos, hooks y más.
Eso sí, si la web está tan rota que no puedes ni acceder al panel de WordPress, tocar el wp-config.php sigue siendo el método más fiable.
La primera vez que veas uno de estos mensajes, es posible que te suene a idioma alienígena. Pero con un poco de práctica, vas a entenderlos cada vez mejor.
Un ejemplo típico:
PHP Warning: Undefined variable $foo in /home/usuario/public_html/wp-content/themes/mitema/functions.php on line 42
¿Qué te está diciendo?
Tipo de error: Warning (advertencia)
Problema: variable no definida ($foo)
Archivo: functions.php dentro del tema activo
Línea del archivo: 42
Con esta info puedes ir al archivo indicado, buscar la línea en cuestión y ver dónde está el fallo. No hace falta ser programador experto, pero sí tener algo de curiosidad.
Esto es vital. Si dejas el modo debug activo en una web en funcionamiento:
Podrías mostrar errores técnicos a los visitantes.
Estás exponiendo rutas internas y detalles sensibles.
Puedes llenar el disco del servidor si el log de errores se descontrola.
Por eso, cuando termines de revisar los errores, vuelve a poner WP_DEBUG en false.
Activar el WP_DEBUG_LOG y desactivar la visualización en pantalla (WP_DEBUG_DISPLAY) es una combinación perfecta:
Los errores se guardan en wp-content/debug.log.
Puedes revisarlos sin que los usuarios vean nada raro.
Te permite trabajar con más tranquilidad y seguridad.
Vale, el modo debug está muy bien, pero hay vida más allá. Estas son algunas herramientas que pueden complementar y mejorar la experiencia:
Query Monitor: imprescindible para desarrolladores. Muestra queries SQL, errores PHP, hooks activos y mucho más.
Log Deprecated Notices: avisa de funciones obsoletas usadas en temas o plugins.
Debug Bar: añade un panel con información técnica en la barra de administración.
Con estas herramientas puedes ir un paso más allá del simple error y entender cómo se comporta tu web por dentro.
Nos ha pasado a todos, no te preocupes:
Olvidar desactivar la depuración y encontrarse con la web llena de mensajes raros.
No entender un error y tocar archivos al azar (spoiler: puede ser peor).
Confundir errores graves con simples avisos.
No revisar el log y pensar que todo está bien.
La clave está en tomarse el tiempo para leer y entender cada mensaje, probar soluciones con calma y, si hace falta, pedir ayuda (que para eso estamos nosotros).
Aprender a usar el modo debug no es solo para desarrolladores. Es una forma de tener más control sobre tu web, detectar problemas antes de que se agraven y aprender cómo funciona WordPress por dentro.
Y si ves que se te hace bola o simplemente prefieres que alguien lo haga por ti, puedes contar con nuestro servicio de mantenimiento web en WordPress. Nos encargamos de mantener tu web a punto, corregir errores y prevenir problemas antes de que aparezcan.
Ah, y si quieres conocer más sobre nosotros, aquí tienes la web de Webtec, donde compartimos recursos, guías y soluciones para que tu proyecto funcione como se merece.
¿Qué te ha parecido este artículo?