Mientras tu sitio de WordPress funciona, es probable que enfrentes algunos problemas de vez en cuando. Aunque eventualmente puedas resolver estos problemas, el retraso en solucionarlos puede causar la insatisfacción o pérdida de visitantes en tu sitio. Entonces, ¿cómo puedes resolver estos problemas lo más rápido posible y garantizar que tu sitio permanezca en condiciones óptimas?

De hecho, WordPress te ofrece una función de ayuda que te permite identificar las causas de estos problemas: la función de depuración de errores (Debug Mode).

Activar esta característica en tu sitio te muestra el mensaje de error de forma detallada y te explica su causa. Esto facilita la localización del error y, por lo tanto, el hallazgo de una solución más rápidamente.

En este artículo te explicaremos cómo activar el modo de depuración de errores (Debug Mode) en tu sitio de WordPress, así como cómo aprovecharlo al máximo.

¿Qué es la característica Debug Mode en WordPress? La función de depuración de errores (Debug Mode) está deshabilitada por defecto en los sitios de WordPress. Una vez que actives este modo, podrás ver e identificar inmediatamente los errores que enfrenta tu sitio. También podrás registrar todas las notificaciones sobre los problemas que aparecen en un archivo especial llamado registro de depuración Debug.log.

Una vez que esta función muestre todos los errores en tu sitio, podrás resolverlos por ti mismo si tienes las habilidades de programación necesarias. O puedes mostrarlos al desarrollador de tu sitio para ayudarlo a encontrar la fuente del problema y obtener más detalles al respecto.

Contenido del artículo

Activar la función Debug Mode en WordPress 1. Localizar el archivo wp-config.php 2.

Editar el archivo wp-config.php 3.

Agregar código de depuración de errores (debug) 4. Ver el registro de errores posteriormente Puntos adicionales importantes sobre el modo Debug Mode 1. La característica de visualización del registro de errores WP_DEBUG_DISPLAY 2.

La característica SCRIPT_DEBUG 3. Cambiar la ruta del archivo de registro de errores 4. Asegúrate de deshabilitar la característica Debug Mode cuando termines 5.

Activar el modo de depuración de errores usando un complemento Activar la función Debug Mode en WordPress Sigue los siguientes pasos para activar el modo de depuración de errores en tu sitio de WordPress: 1.

Localizar el archivo wp-config.php El archivo WP-config contiene todos los ajustes y propiedades de tu sitio de WordPress, y debes tener permisos de acceso para poder activar este modo.

Puedes acceder a este archivo iniciando sesión en el panel de control de alojamiento (cPanel) y luego seleccionando Administrador de archivos (File Manager).

Luego, navega a la carpeta raíz de tu instalación de WordPress para encontrar el archivo wp-config.php directamente en ella. También puedes acceder al archivo a través del protocolo de transferencia de archivos (FTP) descargando un programa que te permita conectarte al servidor a través de FTP, como FileZilla. Después de descargar el programa e iniciar sesión, encontrarás el archivo wp-config.php directamente en la carpeta (Public_html).

2. Editar el archivo wp-config.php Después de acceder al archivo wp-config.php

utilizando uno de los métodos anteriores, debes editar el código de este archivo importante que contiene la configuración de tu sitio.

Abre el archivo en modo de edición

Haz clic derecho sobre él y selecciona Edit. Para poder activar la función Debug Mode, debes encontrar la siguiente línea de código dentro del archivo.

('WP_DEBUG',false); 3. Agregar código de depuración de errores (debug) Una vez que hayas localizado el comando anterior, elimínalo y reemplázalo con el siguiente código de programación: // Enable WP_DEBUG mode define( 'WP_DEBUG', true );

// Enable Debug logging to the /wp-content/debug.log file define( 'WP_DEBUG_LOG', true ); // Disable display of errors and warnings define( 'WP_DEBUG_DISPLAY', false ); @ini_set( 'display_errors', 0 ); El primer comando en el código anterior activa la función Debug Mode

en tu sitio asignando la constante de programación WP_DEBUG

el valor true El segundo comando activa la función de escribir todos los errores, notificaciones y advertencias en el archivo de registro del sitio debug.log

asignando la constante de programación WP_DEBUG_LOG

el valor true Los últimos dos comandos desactivan las características de visualización de errores en la página principal del sitio para que no aparezcan ante los visitantes, protegiendo la seguridad de tu sitio y evitando que se muestren datos sensibles que puedan ser explotados por hackers.

Nota: Las propiedades (WP_DEBUG, WP_DEBUG_LOG y WP_DEBUG_DISPLAY) son constantes de programación comunes en PHP que se activan asignándoles el valor true y se desactivan asignándoles el valor lógico false. Ten cuidado de escribir los valores lógicos sin comillas "" para que no se traten como cadenas de texto. 4.

Ver el registro de errores posteriormente Después de aplicar los comandos anteriores y asegurarte de que el modo de depuración de errores está activado correctamente en tu sitio, puedes encontrar el archivo de registro que guarda todos los mensajes de error y problemas encontrados en tu sitio y conocer las razones de su aparición. Como mencionamos anteriormente, este es el archivo wp-content/debug.log (puede estar en otra ruta si has cambiado la ruta de guardado predeterminada). Archivo de registro de errores Debug.log en WordPress

Cuando activas el modo Debug Mode y asignas el valor true a WP_DEBUG_LOG como se mostró anteriormente, todos los errores y problemas que ocurran en el sitio se guardarán en el archivo debug.log. Este archivo se encuentra en el directorio wp-content de forma predeterminada, pero también puedes guardarlo en otra ruta personalizada de tu elección en el servidor.

Puntos adicionales importantes sobre el modo Debug Mode Después de conocer el modo de depuración de errores en tu sitio de WordPress y sus características básicas, es importante que conozcas algunas propiedades y puntos adicionales importantes relacionados con este modo. 1.

La característica de visualización del registro de errores WP_DEBUG_DISPLAY El propósito principal de esta característica es habilitar la función de mostrar problemas y mensajes de error directamente en las páginas HTML, es decir, aparecerán en las páginas principales del sitio y ante todos los visitantes.

Por lo tanto, debes tener cuidado al activar esta característica en un sitio en vivo (Live). Si lo haces, podrías exponerte a ti y a tu sitio al riesgo de filtración de información sensible que podría ser explotada por hackers. Por lo tanto, si deseas activar esta característica, primero asegúrate de que el sitio no esté en vivo, luego actívala escribiendo el siguiente comando en el archivo wp-config-php: ('WP_DEBUG_DISPLAY', true ); 2.

La característica SCRIPT_DEBUG Esta característica es útil si estás probando algunos cambios en archivos de JavaScript js o archivos css en el sitio. Cuando activas esta característica junto con la función de depuración de errores (Debug Mode), WordPress usa las versiones de desarrollo (Dev) de estos archivos en lugar de las versiones comprimidas (Minified) que normalmente se cargan, lo que facilita la detección y corrección de errores en ellos. Esta característica está deshabilitada de forma predeterminada.

Para activarla manualmente, puedes agregar el siguiente comando al archivo wp–config–php: ('SCRIPT_DEBUG', true ); 3.

Cambiar la ruta del archivo de registro de errores

Como vimos en los comandos anteriores, al activar la función Debug Mode, seguidamente activamos la característica de registro WP_DEBUG_LOG para guardar todos los mensajes de error y problemas en el archivo debug.log. Puedes usar el siguiente código para cambiar la ruta del archivo donde se guardan los informes de error para protegerlo de hackers: ('WP_DEBUG_LOG', '/path/outside/of/webserver/root/debug.log'); 4.

Asegúrate de deshabilitar la característica Debug Mode cuando termines La característica Debug Mode es sin duda muy útil, ya que te ayuda a identificar y corregir errores y problemas en tu sitio. Sin embargo, debes tener cuidado de que esta característica puede mostrar partes del código PHP a los visitantes del sitio si no la configuras correctamente.

Por lo tanto, siempre debes recordar desactivarla después de terminar de trabajar en la corrección de errores y antes de que el sitio vuelva a estar en vivo. 5.

Activar el modo de depuración de errores usando un complemento

Si no deseas activar la función Debug Mode manualmente mediante código de programación, o no tienes permisos para acceder al archivo wp-config.php (a través del panel de control de alojamiento cpanel o FTP), no te preocupes. Aún puedes activarla desde el panel de control de WordPress usando complementos (Plugins). WordPress ofrece varios complementos para controlar el modo de depuración de errores, como el complemento (WP Debugging) que realiza esta tarea automáticamente. Para instalar el complemento WP Debugging en tu sitio, inicia sesión en el panel de control de WordPress, luego ve a la sección Complementos (plugins) en la parte inferior del panel de control y selecciona Agregar nuevo (Add new). Aparecerá una ventana de instalación de complementos. Escribe el nombre del complemento (WP Debugging) en el cuadro de búsqueda y después de encontrar el complemento deseado, haz clic en el botón Instalar ahora (install now) como se muestra en la siguiente imagen. Después de completar la instalación, activa el complemento en tu sitio.

Puedes obtener más información sobre la instalación de complementos en WordPress. Este complemento funciona inmediatamente después de su activación, ya que establece automáticamente el valor true para las siguientes constantes de programación: WP_DEBUG : Esta opción está habilitada de forma predeterminada para activar el modo de depuración de errores en el sitio.

WP_DEBUG_LOG : Para registrar mensajes de error en el archivo debug.log. SCRIPT_DEBUG : Para obligar a WordPress a usar las versiones de desarrollo de archivos Javascript y CSS en lugar de las versiones comprimidas. SAVEQUERIES Para registrar consultas de base de datos y ayudarte a rastrearlas y corregir los errores en ellas.

Al desactivar el complemento, todas estas variables se restablecerán automáticamente al valor predeterminado false para desactivarlas. También puedes controlar más configuraciones del complemento navegando a la pestaña Herramientas (Tools) en el panel de control de WordPress y luego seleccionando WP Debugging para que aparezca la página de configuración del complemento como se muestra en la siguiente imagen. Desde esta ventana puedes habilitar algunas características adicionales marcando las casillas de verificación disponibles, que son:

Set WP_DEBUG to true: Esta opción está habilitada de forma predeterminada al instalar el complemento para activar el modo de depuración de errores. Set WP_DEBUG_DISPLAY to false, default is true:

Puedes habilitar esta opción para evitar que se muestren los mensajes ante los visitantes del sitio. Set WP_DISABLE_FATAL_ERROR_HANDLER to true : Puedes activar esta opción para habilitar la función de manejo

de errores fatales en el sitio. Después de habilitar las opciones que desees, haz clic en el botón Guardar cambios (Save changes) para guardar los cambios realizados en tu sitio.

Nota: Te recomendamos que desactives este complemento tan pronto como termines de corregir los problemas del sitio para desactivar el modo de depuración de errores que podría ser explotado por hackers para acceder a datos importantes y sensibles de tu sitio. Con esto hemos conocido el modo de depuración de errores (Debug Mode) que te ayuda a identificar y corregir errores en tu sitio de WordPress. Explicamos dos formas de activarlo en el sitio, ya sea manualmente escribiendo el código de programación necesario en el archivo wp-config.php, o mediante un complemento de WordPress (WP Debugging).

Finalmente, te recordamos nuevamente la necesidad de tener cuidado al tratar con este modo en sitios en vivo, ya que esto puede afectar el rendimiento del sitio en primer lugar y exponerte al riesgo de fuga de información sensible en segundo lugar. Por lo tanto, es necesario que lo desactives después de terminar de corregir los errores de tu sitio.