Activar el modo de depuración requiere editar un archivo en tu instalación de WordPress. Es un proceso sencillo, pero debe hacerse con cuidado para evitar dañar el sitio. A continuación encontrarás instrucciones paso a paso sobre cómo hacerlo correctamente.
Una vez activado, podrás registrar errores, ocultarlos a los visitantes y controlar cómo WordPress maneja la información de depuración. Esto es especialmente importante en sitios en producción, donde quieres que los errores se registren pero no se muestren públicamente.
Localizando el archivo wp-config.php
El primer paso para habilitar el modo de depuración es localizar el archivo wp-config.php. Este archivo se encuentra en la carpeta raíz de tu instalación de WordPress, en el mismo lugar donde se encuentran wp-content, wp-includes y wp-admin. Para acceder a él puedes usar un programa FTP, el administrador de archivos del panel de control de tu hosting, o acceso directo si trabajas en un servidor de desarrollo.
Se recomienda hacer una copia de seguridad de este archivo antes de realizar cambios. Un solo carácter faltante puede romper tu sitio, por lo que tener una copia asegura que puedas restaurarlo de inmediato. Una vez encontrado, ábrelo en un editor de texto y prepárate para ajustar su configuración.
Activando WP_DEBUG
Dentro del archivo wp-config.php, desplázate hasta encontrar una línea como esta: define( 'WP_DEBUG', false );. Esta línea controla si el modo de depuración está activo o no. Por defecto, WordPress desactiva la depuración por razones de seguridad y rendimiento. Para activarlo, solo necesitas cambiar el valor de false a true.
La línea correcta debería quedar así: define( 'WP_DEBUG', true );. Después de guardar el archivo, WordPress comenzará a mostrar de inmediato advertencias, avisos y mensajes de error de PHP en todo tu sitio web. Esto te permitirá identificar plugins, temas o código personalizado problemático.
Usando WP_DEBUG_LOG para registrar errores
Aunque mostrar errores en pantalla puede ser útil en desarrollo, no siempre es práctico. Para un monitoreo a largo plazo, puedes activar WP_DEBUG_LOG. Para hacerlo, agrega la siguiente línea justo debajo de la constante WP_DEBUG: define( 'WP_DEBUG_LOG', true );. Esto almacenará todos los errores en un archivo debug.log dentro del directorio wp-content.
Contar con un archivo de registro es especialmente útil cuando necesitas rastrear errores que ocurren en momentos específicos o cuando no puedes reproducirlos directamente en pantalla. También te permite compartir el archivo con desarrolladores o equipos de soporte sin darles acceso directo a tu sitio.
Ocultando errores a los visitantes
Si tu sitio de WordPress está en producción, probablemente no quieras que los visitantes vean mensajes de error en bruto. En ese caso, puedes añadir otra configuración para desactivar la visualización en el frontend: define( 'WP_DEBUG_DISPLAY', false );. Esto asegura que, aunque los errores se sigan registrando, no se mostrarán a los usuarios en el sitio.
Además, puedes añadir @ini_set( 'display_errors', 0 ); para reforzar este comportamiento. Esta combinación mantiene tu sitio profesional y seguro mientras la información necesaria sigue registrándose en el log de depuración para administradores y desarrolladores.
Depuración avanzada con SCRIPT_DEBUG
Para los desarrolladores que trabajan con JavaScript y CSS, WordPress ofrece una constante adicional: define( 'SCRIPT_DEBUG', true );. Por defecto, WordPress carga versiones minimizadas de scripts y estilos. Habilitar la depuración de scripts obliga a WordPress a cargar las versiones completas y no minimizadas, que son más fáciles de inspeccionar y depurar.
Esta configuración es valiosa si trabajas en el desarrollo de temas o plugins y necesitas seguir cómo se comportan los scripts y estilos. No suele ser necesaria para usuarios comunes, pero puede marcar una gran diferencia para los desarrolladores que resuelven problemas en el frontend.
En resumen, habilitar el modo de depuración de WordPress es una manera sencilla pero poderosa de diagnosticar y mantener tu sitio web. Al editar el archivo wp-config.php, puedes mostrar errores, almacenarlos en registros y mantener tu sitio con apariencia profesional incluso cuando ocurren problemas. Usado correctamente, el modo de depuración es una de las herramientas más importantes para mantener WordPress seguro, estable y amigable para desarrolladores.
