Saltar al contenido principal

Resolución de problemas

Un recorrido para diagnosticar problemas del plugin, de lo más barato a lo más laborioso.

1. Descartar lo evidente​

  • Actualizaciones pendientes — WordPress, tema y plugins (el nuestro incluido) en su última versión.
  • Conflicto de plugin o tema — desactiva los demás plugins y cambia a un tema estándar de WordPress. Si el problema desaparece, reactívalos uno a uno hasta dar con el culpable.
  • Caché — LiteSpeed, WP Rocket, WP Super Cache, W3 Total Cache y similares guardan versiones antiguas de las páginas. Limpia la caché siempre que toques diseño o configuración.

2. Mirar la cola y el historial del plugin​

Antes de recurrir a herramientas externas, el plugin ya responde dos preguntas:

  • Joinotify → Historial muestra qué se envió, a quién y con qué estado.
  • Joinotify → Cola de procesamiento muestra lo pendiente y lo fallido. Los fallos temporales se reintentan; los errores de configuración — token inválido, ventana de 24 horas cerrada, plantilla inexistente — se quedan ahí, porque insistir no cambiaría el resultado.

Un mensaje que nunca sale y no aparece en la cola suele ser un flujo inactivo o un disparador que no se activó. Un mensaje que aparece en la cola y no sale es un problema de credenciales, de ventana o de WP-Cron — consulta Requisitos mínimos.

3. Depurar con Query Monitor​

Query Monitor es la forma más rápida de ver qué ocurre en una pantalla concreta. Úsalo mientras aún tengas acceso al panel.

Instálalo desde Plugins → Añadir nuevo, actívalo y abre la barra que aparece arriba del panel:

  • Errores PHP — avisos y errores fatales de la página actual.
  • Consultas a la base de datos — consultas lentas o fallidas.
  • Hooks y acciones — qué se está ejecutando, útil para encontrar conflictos.
  • Peticiones HTTP — llamadas a servicios externos, incluidas las de Joinotify. Ahí es donde aparece un fallo de conexión con la API.
Errores en peticiones AJAX

Los errores que ocurren en llamadas AJAX o REST no llegan a la pantalla. Abre la consola del navegador, o la pestaña Red, haz clic en la petición marcada en rojo y mira la respuesta.

4. Activar el modo de depuración de WordPress​

Úsalo cuando no tengas acceso al panel. Edita wp-config.php, en la sección For developers: WordPress debugging mode:

wp-config.php
define( 'WP_DEBUG', true );
define( 'WP_DEBUG_LOG', true );
define( 'WP_DEBUG_DISPLAY', false );

Los errores pasan a registrarse en wp-content/debug.log.

WP_DEBUG_DISPLAY en producción

Dejar WP_DEBUG_DISPLAY en true muestra los errores a los visitantes, junto con rutas de archivo del servidor. En un sitio en línea, mantenlo en false y lee el archivo de registro.

Para problemas con WooCommerce, la página WooCommerce → Estado → Registros también recoge errores fatales y entradas del propio plugin.

5. Problemas comunes​

Error 500 — error interno del servidor​

El servidor falló pero no dice dónde. Las causas más frecuentes son un error de PHP, un .htaccess inválido, un permiso de archivo, un límite de recursos del servidor o un conflicto entre plugins.

Cómo investigarlo: activa el modo de depuración (paso 4) y lee el debug.log. Si el error solo ocurre en una pantalla, Query Monitor señala la línea.

Página en blanco​

Un error fatal de PHP con la visualización de errores desactivada. Mismo camino: modo de depuración y lectura del registro.

El CSS o el JavaScript no carga​

Revisa la consola del navegador y, en Query Monitor, si hay peticiones de recursos fallando. Los plugins de optimización que combinan o aplazan scripts suelen ser la causa — prueba con la optimización desactivada.

El mensaje no llega al destinatario​

Comprueba, en este orden: el número es correcto e incluye el código de país; el flujo está activo; el disparador realmente se activó (mira el historial); la clave de API de Joinotify está guardada; y, en el transporte Cloud, si la ventana de 24 horas está abierta. Consulta Envío a través de Joinotify Cloud.

6. Contactar con el soporte​

Si nada de lo anterior lo resolvió, reporta el problema. Incluye:

  • Qué estabas haciendo cuando ocurrió el problema.
  • Capturas de pantalla del error.
  • Errores de Query Monitor o fragmentos del debug.log.
  • Versiones de WordPress, del tema, de Joinotify y de los plugins implicados.

Cuanto más completo sea el informe, menos idas y venidas. No damos soporte a plugins o temas de terceros.