Instalación - WordPress
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
- WordPress 5.6 o posterior,
- PHP 7.2 o posterior,
- conexiones HTTPS salientes permitidas desde el servidor del sitio.
El plugin se publica en el directorio de WordPress.org como DockRay (slug dockray). No necesita Composer: las dependencias viajan dentro del paquete.
Instalación desde el directorio de plugins
- En la administración de WordPress ve a Plugins → Añadir nuevo.
- Busca DockRay y pulsa Instalar ahora.
- Cuando termine la instalación, pulsa Activar.
- Abre Ajustes → DockRay.
- Introduce el token del proyecto y la clave privada, y guarda.
- Pulsa Enviar evento de prueba. El resultado aparece sin recargar la página.
Activarlo sin credenciales es seguro: el plugin se carga, no envía nada y no cambia el comportamiento del sitio.
Instalación desde un archivo ZIP
- Descarga la versión actual desde WordPress.org.
- Ve a Plugins → Añadir nuevo → Subir plugin.
- Elige el archivo, instálalo y activa el plugin.
- Configura la conexión en Ajustes → DockRay.
Credenciales en wp-config.php
Si prefieres no guardar el secreto en la base de datos de WordPress, defínelo mediante constantes. El plugin las reconoce automáticamente y la pantalla de ajustes indica cuáles están activas.
define( 'DOCK_RAY_TOKEN', 'TU_TOKEN_DE_PROYECTO' );
define( 'DOCK_RAY_PRIVATE_KEY', 'TU_CLAVE_PRIVADA' );
Coloca las constantes por encima del comentario /* That's all, stop editing! */, que cierra la parte editable del archivo.
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 nombre del entorno, el alcance de los errores de PHP notificados y, si los necesitas, la medición del tiempo de respuesta y la recogida de errores de JavaScript.