Verificación y problemas habituales - Joomla
El evento de prueba
En System - DockRay → Opciones pulsa Enviar evento de prueba. El plugin envía un evento y muestra el resultado sin salir de la pantalla; el área de estado conserva el resultado y la fecha del último intento. El evento debería aparecer en el panel, en la sección Errores del proyecto al que apunta el token.
Verificación con un error real
La prueba confirma la conexión, no la captura automática. En una instalación de pruebas provoca un error que haga a Joomla renderizar una página de error - de eso se ocupa el evento onError - y revisa en el panel el entorno, la hora y el contexto de la petición.
Problemas habituales
El plugin está instalado pero no notifica nada
Comprueba que esté activado en Sistema → Plugins: instalar una extensión no la activa. Después revisa las credenciales: sin token ni clave el plugin permanece inactivo por diseño.
Los campos de conexión han desaparecido de las opciones
El origen de la configuración está en Solo configuration.php. En ese modo los campos de conexión se ocultan a propósito y los valores vienen solo de constantes. Vuelve a Auto o a Solo esta pantalla si quieres escribirlos en el back end.
El token guardado no es el que he escrito
En configuration.php está definido DOCKRAY_TOKEN o DOCKRAY_PRIVATE_KEY mientras el origen de la configuración está en Auto: entonces gana la constante. El área de estado enumera las constantes activas.
Los errores de JavaScript no llegan
El recolector está desactivado por defecto: activa Recoger errores de JavaScript en los parámetros del plugin. Ten en cuenta también el límite de 16 kB por informe: una pila muy larga de un bundle minificado puede superarlo.
Faltan transacciones
Las transacciones solo se generan con un muestreo mayor que 0 y se cierran en onAfterRespond. Una petición cortada antes de ese evento - por ejemplo una redirección con exit en otra extensión - no deja transacción.
Caché de Joomla tras actualizar el plugin
Después de actualizar la extensión vacía la caché en Sistema → Limpiar caché. Un diseño de página antiguo en caché puede seguir sin incluir el recolector de errores del navegador.
El panel responde 200 pero no aparece el evento
Una respuesta 200 {"success": false} significa que la cuenta ha agotado su cupo mensual de errores. La integración no lo trata como una avería, y hace bien. El cupo se ve en el panel de la cuenta; hasta fin de mes se calcula a partir del consumo registrado, así que borrar errores no lo reinicia.
Sigue sin funcionar
Repasa la lista de comprobación de falta de datos y, si no ayuda, escríbenos. Indica el nombre del proyecto, la versión de la integración y la hora aproximada de la prueba: acorta el camino a la respuesta.