Ya hace tiempo que te dedicas a manejar WordPress, y lo conoces como un hermanito pequeño. Has tenido con él tus momentos de alegrías, de decepciones, de enfados, y la relación con el CMS ya es más de "amor" que de "odio".
Ya has superado gran parte de la curva de aprendizaje que supone utilizar este fantástico gestor de contenidos, que da de comer a tanta gente cada día (entre ellos me incluyo yo).
Pero como siempre ocurre con cualquier profesión o hobby, todos hemos tenido ese momento de frustración cuando nos hemos encontrado con un fallo gordo en nuestra web, y no sabíamos de dónde venía, hacia dónde iba y por qué dicha situación nos amargaba el café calentito que nos habíamos tomado esa mañana de viento y lluvia dramática en nuestra ciudad.
Como dice la canción, don't worry, be happy. En este artículo te traigo un método que incluso muchos profesionales de WordPress no suelen usar, o que desconocen.
Este método (llamado Modo Debug) te dirá, tal chivato de clase apuntando quien habla en la pizarra mientras no está la profesora, qué plugins o qué acciones de la plantilla que estás utilizando causan error o cualquier tipo de problema (por pequeño que sea) en tu instalación de WordPress.
Con ello, ya podrás apuntarte un tanto más en tus conocimientos de WordPress, y descubrirás un mundo de soluciones a los errores que menos parecen poder solucionarse. ¡Adiós a los bugs en WordPress!
Para qué sirve el Modo Debug
Seguro que te suena el concepto o la palabra inglesa de bug (bicho).
En cualquier proyecto web, un bug es una acción o elemento que está causando un tipo determinado de problema, y que causa estragos a todos los niveles.
De ahí que, al igual que "deshacer" es lo contrario de hacer, "descongelar" es lo contrario de congelar, hacer "debug" es lo contrario de "bug", en este caso, eliminar los bichos.
Tú mismo estás haciendo debug cuando estás echando más de medio litro de spray anti-cucarachas en una que te encuentres correteando por la cocina (pero esta vez, el debug es literal).
En el caso de WordPress, el Modo Debug te ayuda a depurar cualquier tipo de error, relacionado con el rendimiento de tu web, la seguridad, y el funcionamiento general de la misma.
Cuándo usar el Modo Debug
Hay cientos de ejemplos de casos en donde el Modo Debug te puede sacar de un apuro.
Los más importantes a tener en mente son:
- Cuando aparece un error 500 en tu web.
- Cuando te encuentras con la famosa "página en blanco", que parece no reaccionar a ningún estímulo por parte del usuario y del administrador web.
- Si estás utilizando una plantilla que no conoces mucho, o del cual no terminas de fiarte (ejem, Themeforest), y crees que dicho tema es el que está causando conflictos con algún plugin de confianza.
- En general, si la web se ha "roto", y a primera vista no consigues averiguar qué plugin / plantilla está causando qué error.
Aclaraciones previas a su uso
Mucho cuidado en este apartado, ya que como bien dicen en las películas: un gran poder, conlleva una gran responsabilidad.
Esta herramienta o técnica de WordPress, tiene unas recomendaciones clave, que tienes siempre que tener en cuenta antes de utilizarla.
Las recomendaciones previas principales son:
- Nunca actives el Modo Debug en un sitio que esté en producción (que esté visible al público), ya que si lo haces, se empezarán a mostrar mensajes de depuración con información sensible, visibles a todo el mundo, entre donde se incluyen posibles personas que quieran atacar tu web, utilizando dicha información.
- Habilita el Modo Debug de una manera temporal y muy corta, solo cuando el sitio en producción esté verdaderamente "roto".
- Si el Modo Debug está activado en un sitio en producción (debido a la razón anterior), oculta los mensajes de depuración al público. (Para ello te servirá una línea de código que vemos más abajo).
- Siempre que sea posible, haz un clon del sitio web con problemas, en un entorno test oculto al público, y realiza ahí tus análisis.
Cómo activar el Modo Debug en WordPress
Una vez entendida la introducción y las aclaraciones previas, pasamos a la acción.
Aquí te dejo por escrito los códigos que tienes que insertar en el archivo de WordPress llamado wp-config.php.
Recuerda que dicho archivo contiene toda la configuración de la web (conexión con bases de datos, funciones con diferentes objetivos, etc) así que ten cuidado con lo que tocas ahí. (de ahí que lo ideal sea hacer este Modo Debug en un entorno test).
Activación general
La activación del Modo Debug es bastante sencilla. Pega la línea de código que te escribo a continuación en el archivo wp-config.php o que cambia la palabra false por true, si ya está escrita dicha frase en el archivo mencionado.
define('WP_DEBUG', true); // activa el Modo Debug en tu sitio web
Activación de log
El paso anterior va a hacer que empiecen a aparecer mensajes de depuración en tu web.
Esto es seguro si estás probando un plugin o plantilla que tú mismo estás creando en tu propio servidor a nivel local (pues nadie lo va a ver y a utilizar en tu contra).
Lo que permite hacer el log es escribir todos esos mensajes en un archivo situado en wp-content/debug.log.
Así es más fácil ver todos los errores detectados y que los vayas analizando y solucionando uno a uno.
Para conseguir que se cree este archivo log, escribe la siguiente línea de código justo debajo de la anterior.
define('WP_DEBUG_LOG', true); // escribe los errores en un archivo log en wp-content/debug.log
Deshabilitar mensajes de depuración públicos
En el paso anterior ya hemos conseguido que los mensajes de error aparezcan en un archivo que podemos consultar de una manera ordenada y limpia.
Pero claro, cuando necesitamos sí o sí activar el Modo Debug en un entorno de producción, no vamos a querer que nadie pueda leer los mensajes de error que se muestran por defecto en la web.
Con el siguiente código, conseguirás ocultar dichos mensajes, y de esta manera solo serán escritos en el archivo log.
Así obtendrás una capa extra de seguridad mientras esté activo el Modo Debug en tu web, y será mucho más difícil para los hackers (que siempre llevan capucha y máscara mientras están en casa atacando tu valiosa web) entrar en tu web por culpa de los mensajes de error.
Escribe este código justo debajo del anterior:
define('WP_DEBUG_DISPLAY', false); // oculta los mensajes de Modo Debug que aparecen en pantalla
Configuración óptima en Modo Debug
Este punto es obvio, pues tú mism@ te habrás dado cuenta de cuál es la configuración óptima para un Modo Debug profesional.
Activar la función en sí, y configurarla para que escriba los mensajes de error en un archivo log, y al mismo tiempo oculte dichos mensajes a otros ojos que no sean los tuyos.
Conclusiones
Como ves, este método añade un nivel extra a tu evolución en el mundo de WordPress.
Verás como te va a ayudar a encontrar problemas que aparentemente no se ven a simple vista en tu web.
Recuerda que si tu web está en producción, es recomendable no activar ahí el Modo Debug, y que si no tienes otro remedio, ocultes los mensajes de depuración mediante el código que te he mencionado.
Espero que te haya servido de mucha ayuda este artículo, porque es de ese tipo de contenido que parece que no, pero que son extremadamente útiles en situaciones de desesperación de muchos usuarios.
¡Un abrazo y nos vemos en el siguiente artículo!