Cómo depurar Wordpress

Ni siquiera un sitio web con el mejor ma­n­te­ni­mie­n­to y los mejores cuidados está a salvo de errores. Es­pe­cia­l­me­n­te cuando se han instalado di­fe­re­n­tes plugins pueden darse problemas de diferente calibre que requieren un análisis inmediato y preciso seguido de una solución. Aquí es donde entra en juego el modo de de­pu­ra­ción de WordPress (wp_debug) que te ayuda a localizar errores rá­pi­da­me­n­te. Te ex­pli­ca­mos cómo se utiliza.

Algunos errores deberían so­lu­cio­nar­se lo antes posible: desde pequeños defectos hasta páginas de WordPress en blanco o errores en la base de datos de WordPress. Con tal fin, WordPress debug hace que no tengas que revisar cada uno de los plugins de manera in­di­vi­dual. Esto no solo llevaría mucho tiempo, sino que a menudo sería un trabajo en vano. El modo de de­pu­ra­ción de WordPress es una útil he­rra­mie­n­ta para co­n­se­gui­r­lo más efi­ca­z­me­n­te. Una vez activado, se muestran los avisos de error en las páginas afectadas y puedes atacar el problema de raíz.

Al mismo tiempo, con este modo también puedes de­te­r­mi­nar qué páginas funcionan de manera óptima y, por lo tanto, no requieren de co­rre­c­cio­nes. En otras palabras, el WordPress debug es una he­rra­mie­n­ta de análisis im­po­r­ta­n­te que te muestra, por un lado, dónde hay problemas en tu página y, por otro, lado las áreas que destacan como óptimas. Todos los errores PHP y avisos se muestran en la parte superior de la página, incluso si (todavía) no afectan al re­n­di­mie­n­to de tu presencia web.

Una vez que has so­lu­cio­na­do el problema, si­m­ple­me­n­te vuelve a des­ac­ti­var el WordPress debug. Esto es im­po­r­ta­n­te porque, de lo contrario, tus visitas podrían acceder al texto de tu código PHP y quizá poner en riesgo la seguridad de la web. Además, si no lo des­ac­ti­vas, el modo debug de WordPress también podría reducir el re­n­di­mie­n­to de la web.

¿Qué es un archivo de de­pu­ra­ción de WordPress?

Además del modo debug normal, WordPress también ofrece una opción de registro. Con WordPress debug se muestran todos los errores in­me­dia­ta­me­n­te, pero no se crea ningún tipo de do­cu­me­n­ta­ción. Pre­ci­sa­me­n­te cuando aparecen problemas con fre­cue­n­cia o se quiere tratar el origen de los errores con un de­sa­rro­lla­dor externo, una do­cu­me­n­ta­ción minuciosa puede ser muy re­ve­la­do­ra y útil para resolver efi­ca­z­me­n­te problemas futuros. Para activar el archivo de de­pu­ra­ción de WordPress en tu servidor tienes que cambiar a true la constante WP_DEBUG_LOG. WordPress registra todos los avisos de error en el archivo wp-content/debug.log, donde podrás verlos después.

Hay di­fe­re­n­tes maneras de activar el debug en WordPress. La forma más directa es con el archivo wp-config.php, que se encuentra en el di­re­c­to­rio principal de tu sitio web. Conéctate con tu servidor a través de FTP para modificar el archivo. Para ello, sigue los si­guie­n­tes pasos:

1. Por seguridad, crea siempre una copia de seguridad de WordPress.
2. Abre el archivo wp-config.php en tu editor.
3. De­s­plá­za­te con el ratón hacia abajo hasta que en­cue­n­tres la línea de código “define('WP_DEBUG', false); ”
4. Cambia esta línea de código a “define('WP_DEBUG', true); ”.
5. En caso de que no exista esta línea de código, añádela. El lugar correcto para ello es encima del co­me­n­ta­rio “/* That’s all, stop editing! Happy blogging. */”.
6. Guarda todos los cambios en la parte superior de la pantalla.

Con este pro­ce­di­mie­n­to has activado el modo de de­pu­ra­ción de WordPress. Una vez que hayas fi­na­li­za­do tu análisis, desactiva el modo fá­ci­l­me­n­te re­vi­r­tie­n­do el paso. Para ello, abre el archivo nue­va­me­n­te, de­s­plá­za­te hasta la línea de código me­n­cio­na­da an­te­rio­r­me­n­te y cambia el valor true a false. Después de guardar el cambio, se desactiva el modo WordPress debug. Puedes repetir este pro­ce­di­mie­n­to tantas veces como quieras para buscar errores en tu sitio web.

Como ya hemos me­n­cio­na­do, es posible do­cu­me­n­tar el análisis de errores or­de­na­da­me­n­te usando el archivo wp-config.php. Si quieres hacerlo, añade debajo de la línea de código “define('WP_DEBUG', true); ” otra línea con el siguiente contenido: “define('WP_DEBUG_LOG', true); ”. Ahora los avisos de error se guardan en un archivo LOG y los puedes analizar tra­n­qui­la­me­n­te. Con las líneas adi­cio­na­les “define('WP_DEBUG_DISPLAY', true); ” o “define('WP_DEBUG_DISPLAY', false); ” que también puedes incluir debajo, es­ta­ble­ces si los avisos de de­pu­ra­ción se deben imprimir en HTML (true) o no (false). Estas dos líneas de código no son obli­ga­to­rias para el modo debug de WordPress.

También es posible realizar un debug mediante un plugin de WordPress. Uno muy conocido y gratuito es WP Debugging. El plugin activa el modo de de­pu­ra­ción de WordPress después de la in­s­ta­la­ción y guarda el análisis en un archivo de registro. Si des­ac­ti­vas el plugin, se detiene au­to­má­ti­ca­me­n­te el WordPress debug.

De manera al­te­r­na­ti­va o adicional, puedes usar el plugin Query Monitor. Este plugin también es gratuito y adecuado para un wp_debug de consultas de bases de datos, errores PHP y otros problemas con he­rra­mie­n­tas o plugins. El plugin es re­la­ti­va­me­n­te extenso y presenta una gran variedad de es­ta­dí­s­ti­cas e in­fo­r­ma­cio­nes.

El wp_debug es la he­rra­mie­n­ta ideal para ide­n­ti­fi­car errores en tu sitio web de forma efectiva. Su ac­ti­va­ción es re­la­ti­va­me­n­te fácil, e incluso si no eres ducho en la materia, co­m­pre­n­des rá­pi­da­me­n­te dónde podría haber problemas. Si no quieres ejecutar el debug en WordPress ma­nua­l­me­n­te, existen plugins re­co­me­n­da­bles y gratuitos que hacen el trabajo por ti y de manera sa­ti­s­fa­c­to­ria.