El modo Debug en WordPress es una herramienta esencial para desarrolladores y administradores de sitios web, ya que permite detectar y solucionar errores en temas, plugins y código personalizado. Al activar este modo, WordPress muestra avisos, advertencias y errores que pueden ayudar a mejorar la estabilidad y el rendimiento del sitio.
En esta guía, aprenderás qué es el modo Debug, por qué es importante y cómo activarlo correctamente.
¿Qué es el modo Debug en WordPress?
El modo Debug en WordPress es una configuración especial que permite mostrar errores de PHP y problemas en el código del sitio web. Se activa mediante constantes en el archivo wp-config.php, el archivo principal de configuración de WordPress.
Cuando Debug está habilitado, WordPress muestra errores en pantalla o los guarda en un archivo de registro (log), lo que facilita la identificación y solución de problemas.
¿Por qué activar el modo Debug en WordPress?
Activar Debug es especialmente útil en los siguientes casos:
- Depuración de errores en temas y plugins.
- Solución de problemas de compatibilidad después de una actualización de WordPress.
- Optimización del rendimiento al identificar código obsoleto o ineficiente.
- Desarrollo de nuevas funcionalidades sin afectar el sitio en producción.
¿Cómo activar el modo Debug en WordPress?
Acceder al archivo wp-config.php
Para activar Debug, debes editar el archivo wp-config.php, que se encuentra en el directorio principal de tu instalación de WordPress.
Puedes acceder a este archivo de las siguientes maneras:
- Usando un cliente FTP como FileZilla.
- A través del Administrador de archivos en el panel de tu hosting (cPanel, Plesk, etc.).
- Usando la terminal si tienes acceso SSH al servidor.
Editar el archivo wp-config.php
Ubica la siguiente línea en el archivo wp-config.php:
define('WP_DEBUG', false);Cambia el valor false a true para activar el modo Debug:
define('WP_DEBUG', true);Activar el registro de errores
Si quieres que los errores se guarden en un archivo de log en lugar de mostrarse en pantalla, agrega estas líneas debajo de WP_DEBUG:
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
@ini_set('display_errors', 0);Esto hará que los errores se almacenen en el archivo /wp-content/debug.log, permitiendo revisarlos sin afectar la experiencia del usuario.
Paso 4: Desactivar los avisos de errores para usuarios
Para evitar que los visitantes del sitio vean errores en pantalla, agrega esta línea:
define('DISABLE_WP_CRON', true);Esta configuración es útil en entornos de producción donde los errores pueden exponer información sensible.
Paso 5: Guardar los cambios y probar
- Guarda el archivo
wp-config.php. - Recarga tu sitio web y revisa si aparecen mensajes de error.
- Para ver el registro de errores, accede a
/wp-content/debug.log.
¿Cómo desactivar el modo Debug en WordPress?
Una vez solucionados los problemas, es recomendable desactivar Debug para evitar riesgos de seguridad y mejorar el rendimiento del sitio. Para hacerlo, simplemente cambia true por false en las líneas que activaste:
define('WP_DEBUG', false);
define('WP_DEBUG_LOG', false);
define('WP_DEBUG_DISPLAY', false);Luego, elimina el archivo debug.log en /wp-content/ si ya no lo necesitas.
Conclusión
Activar el modo Debug en WordPress es una herramienta clave para detectar y solucionar errores de manera eficiente. Siguiendo esta guía, podrás habilitar y configurar Debug de forma segura, asegurando que los problemas sean identificados sin afectar la experiencia del usuario. Recuerda desactivarlo una vez finalizada la depuración para mantener un sitio seguro y optimizado.