Instalación - Joomla

Antes de empezar, crea un proyecto en el panel de DockRay. En sus ajustes encontrarás el token del proyecto - el identificador público que forma parte de la URL de ingesta - y en la pestaña Claves de API generarás una clave privada. La clave se muestra una sola vez, al generarla: DockRay guarda únicamente su hash. Si todavía no tienes un proyecto, empieza por Primeros pasos.

Requisitos

• Joomla 4, 5 o 6,
• PHP 8.2 o posterior,
• conexiones HTTPS salientes permitidas desde el servidor.

DockRay para Joomla es un plugin de sistema (plg_system_dockray). Joomla no ejecuta Composer durante la instalación, así que el SDK viaja dentro del paquete.

Instalar el paquete

1. Descarga dockray-joomla.zip desde la página de la integración de Joomla.
2. En la administración de Joomla ve a Sistema → Instalar → Extensiones.
3. Elige Subir archivo de paquete y selecciona el archivo.
4. Espera la confirmación de la instalación.

El manifiesto del plugin lleva la dirección de nuestro propio servidor de actualizaciones, así que las versiones posteriores aparecen en Sistema → Actualizar → Extensiones como cualquier otra actualización. Joomla comprueba el hash SHA-256 del paquete descargado y se niega a instalarlo si no coincide.

Activar el plugin

1. Ve a Sistema → Plugins.
2. Busca System - DockRay y actívalo.

Activarlo sin credenciales es seguro: sin token ni clave privada el plugin permanece inactivo.

Configurar la conexión

1. Abre System - DockRay → Opciones.
2. Introduce el token del proyecto y la clave privada.
3. Guarda la configuración.
4. Pulsa Enviar evento de prueba para comprobar la conexión sin salir de la pantalla.

Después de la instalación

Comprueba que el token y la clave pertenecen al mismo proyecto y pasa a la configuración: ahí defines el entorno, la medición de peticiones, los datos del usuario conectado y, opcionalmente, la recogida de errores de JavaScript del sitio.