Instalación - PrestaShop

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

• PrestaShop 1.7.8 o posterior, 8.x o 9.x,
• PHP 8.2 o posterior,
• conexiones HTTPS salientes permitidas desde el servidor de la tienda.

El módulo no está en el marketplace de Addons: publicamos dockray-prestashop.zip nosotros mismos y se descarga desde la página de la integración de PrestaShop. PrestaShop no ejecuta Composer durante la instalación, así que el SDK viaja dentro del archivo.

Instalación desde el back office

1. Descarga el paquete dockray-prestashop.zip actual.
2. Entra en el back office de la tienda.
3. Ve a Módulos → Gestor de módulos y elige Subir un módulo.
4. Selecciona el archivo y espera a que termine la instalación.
5. Abre Configurar en el módulo DockRay.
6. Introduce el token del proyecto y la clave privada, y guarda.
7. Pulsa Enviar evento de prueba.

Instalarlo sin credenciales es seguro: el módulo se carga, no envía nada y no cambia el comportamiento de la tienda.

Instalación desde la línea de comandos

unzip dockray-prestashop.zip -d modules/
php bin/console prestashop:module install dockray
php bin/console cache:clear

Tras una instalación por consola las credenciales se rellenan igualmente en la pantalla de configuración del módulo, o mediante constantes de PHP, de lo que trata el artículo de configuración.

Vacía la caché después de instalar

PrestaShop guarda la lista de hooks enganchados en el contenedor de servicios. Si el módulo se instala bien pero no notifica nada, el primer paso es php bin/console cache:clear o vaciar la caché en Parámetros avanzados → Rendimiento.

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, el alcance de los datos del cliente y, opcionalmente, la recogida de errores de JavaScript de la tienda.