Cómo obtener ayuda para depurar plugins de WordPress

Los desarrolladores de JoomUnited siempre trabajan para que tus plugins funcionen de la forma más óptima posible; por supuesto, en algunos casos puede producirse algún tipo de fallo, por ejemplo, una incompatibilidad generada por un plugin de terceros. ¿Y qué queremos cuando ocurren este tipo de fallos? Por supuesto, que se resuelvan rápidamente...    

En esta publicación, te enseñaremos cómo dar la información correcta al desarrollador para que pueda entender y resolver el error rápidamente. Esta publicación se dividirá en 3 pasos que vamos a seguir para dar la información correcta a un desarrollador cuando ocurre un problema:

• Activar el registro de depuración
• Instala el plugin de solución de problemas
• Comprobar errores de javascript

Activa el sistema de depuración y registro de WordPress

En primer lugar, debemos saber qué es WP_DEBUG ; como podemos ver en Wikipedia, « WP_DEBUG es una constante de PHP (una variable global permanente) que se puede utilizar para activar el modo "debug" en todo WordPress. Se supone que es false por defecto y normalmente se establece en true en el archivo wp-config.php en las copias de desarrollo de WordPress.»

Como podemos ver, WP_DEBUG es una constante que por defecto está desactivada , pero podemos activarla con fines de depuración temporal. 

Además de eso, hay otra constante PHP llamada WP_DEBUG_LOG que nos ayudará a crear automáticamente un archivo de texto con todos los errores de tus plugins y eso es lo que vamos a enviar a los desarrolladores.  

Vamos a enseñarte exactamente cómo podemos activarlo y cómo se verá si hay un error con tu plugin, WP Meta SEO se usará para este ejemplo, pero puedes seguir los mismos pasos para todos nuestros plugins. En este caso tenemos un problema con WP Meta SEO, podría ser cualquier problema, así que lo que vamos a hacer es abrir el archivo wp-config.php , se puede hacer con tu software de edición de texto preferido, con el Bloc de notas, Visual Studio Code, Brackets, por ejemplo, solo ve y abre wp-config.php.

El archivo se encuentra en la raíz de tu servidor, donde está instalado tu sitio de WordPress.

Ábrelo con el editor de texto y luego pulsa CTRL + F o haz clic en Editar > Buscar… podrás ver un cuadro donde puedes escribir la palabra que vas a buscar, en este caso, vamos a escribir "WP_DEBUG" y pulsar Enter hasta que encuentres:
"define( 'WP_DEBUG', false )"

Ahora que estamos en esa línea, elimina el “false” y escribe true, haz clic en Enter y en la siguiente línea copia define( 'WP_DEBUG_LOG', true ); y guarda el archivo, debería verse como la siguiente imagen.

Si se modifican estas dos líneas, aparecerá un archivo llamado “debug.php” en /wp-content/

Y listo… hemos terminado el primer paso, ese es uno de los archivos que nuestros desarrolladores necesitarán para acelerar el proceso de solución de tu problema. Todos los errores serán monitoreados y escritos en este mismo archivo de texto.

Instala el plugin de solución de problemas de WordPress

El plugin Health Check & Troubleshooting es un plugin que te permite ejecutar una comprobación de conflictos sin afectar a los visitantes habituales de tu sitio, es realmente fácil de usar e instalar, aún vamos a usar WP Meta SEO para este ejemplo. Sigue estos pasos para instalar y ejecutar una comprobación de conflictos con Health Check & Troubleshooting:  

• Inicia sesión en tu sitio de WordPress, estarás en el escritorio de tu sitio
• Haz clic en “Plugins”, en la sección izquierda de tu página
• Haz clic en «Añadir nuevo»
• Escribe “Health Check & Troubleshooting” en la barra de búsqueda, como se muestra a continuación

• Haz clic en “Instalar ahora”, la lista de plugins se cargará automáticamente, busca el correcto y haz clic en “Instalar ahora” y luego en “Activar”

• Haz clic en «Salud del sitio», en el menú de la izquierda hay una sección llamada «Herramientas» Haz clic en ella y luego en «Salud del sitio»

• Haz clic en la pestaña “Troubleshooting” , lee la información de advertencia y haz clic en “Entrar en modo de resolución de problemas” 

El modo de solución de problemas desactiva automáticamente todos los plugins y cambia a un tema predeterminado. El modo de solución de problemas no afecta a los visitantes normales de tu sitio.  

• Reproduce el problema que estabas experimentando

En el entorno predeterminado sin plugins activos y con un tema predeterminado, si el problema ocurre, significa que nuestro plugin no está causando el comportamiento inesperado.

• Haz clic en «Plugins» > «Plugins instalados»

  El menú «Plugins» se expandirá ofreciéndote opciones adicionales. Haz clic en «Plugins instalados»

• Haz clic en “Habilitar durante la resolución de problemas” junto a WP Meta SEO

• Reproduce el problema que estabas experimentando con solo WP Meta SEO activo y un tema predeterminado, si el problema ocurre, el problema es causado por nuestro plugin.

En cierto modo, esto es una buena noticia porque ya has identificado una parte del problema. Ahora se requiere que el desarrollador inicie sesión en tu sitio web y solucione el problema antes de que publiquemos una nueva versión. Si no, repite los pasos para activar el siguiente plugin desactivado con el que puedas reproducir el error.

Comprobar y depurar errores de Javascript en los plugins de WordPress

Vamos a buscar errores de Javascript con la consola de Chrome o Firefox. Según tu navegador, su nombre es ligeramente diferente, pero siguiendo a Chrome y Firefox, la llamaremos la “Consola”. Para abrir la consola, solo tienes que seguir estos pasos:  

• Haz clic derecho en inspeccionar, en el frontend en cualquier parte del sitio

• Seleccionar consola, se abrirán las herramientas de desarrollador en el lado derecho de la página, haz clic en “Consola”

Comprueba si hay errores, con la consola abierta, reproduce el error que esperabas y echa un vistazo a la consola; los errores son textos en rojo que describen dónde se localiza el conflicto de JavaScript

Si has encontrado un error de JavaScript, por favor toma una captura de pantalla de la versión expandida del error para incluirla en tu ticket/publicación.

Enviar / Compartir tu informe de problemas

Ahora que tienes toda esta información, ayudarás al desarrollador a acelerar el proceso, simplemente ve con toda la información que has recopilado y añádela a tu ticket/publicación, recordemos, los elementos son:  

• debug.log
• Nota sobre los complementos que causan conflictos
• Una captura de la consola de JavaScript con el error

Si sigues estos pasos y nos envías la información correcta, el desarrollador podrá realizar una depuración más rápida y te lo agradecemos mucho de antemano :)    

Crea y comparte una nueva cuenta de usuario de WordPress con fines de soporte

Crear un nuevo usuario administrador es a veces una forma rápida de mostrar al equipo de soporte cuál es tu problema. Antes de comenzar con ese proceso, un breve recordatorio:

• No almacenamos las credenciales antiguas después de que se resuelva el problema (por razones de seguridad)
• Recomendamos eliminar esas cuentas de usuario administrador creadas con fines de soporte
• Toda la información compartida con nuestro equipo está protegida y permanecerá confidencial

Para crear un nuevo usuario, primero, inicias sesión en tu sitio de administración. Después de iniciar sesión correctamente, estarás en el escritorio de WordPress.

Luego, debes ir al menú izquierdo Menú > Usuarios.

Después de eso, ve a la parte superior de la pantalla, haz clic en el botón Añadir nuevo o ve al botón Añadir nuevo en el menú de la izquierda.

A continuación, el formulario Añadir nuevo usuario aparecerá en tu pantalla. Hay 2 campos obligatorios que debes rellenar: Nombre de usuario, Correo electrónico.

En el campo Contraseña, puedes usar un generador de contraseñas aleatorias o establecer la tuya propia. Y puedes marcar la opción Enviar notificación al usuario si quieres enviar al nuevo usuario un correo electrónico sobre su cuenta.

Después, eliges un Rol para el usuario en el cuadro desplegable. Este es un paso importante para establecer los permisos de los usuarios en tu sitio. "Administrador" es el nivel más alto y le da al usuario acceso a todas las funciones de tu sitio web. Puedes establecer otros roles si quieres limitar el acceso del usuario.

Finalmente, haz clic en el botón Añadir nuevo usuario en la parte inferior. ¡Ya está hecho, buena suerte!