Installation - PrestaShop
Erstelle zuerst ein Projekt im DockRay-Panel. In seinen Einstellungen findest du den Projekt-Token - die öffentliche Kennung, die in die Ingest-URL eingeht - und im Tab API-Schlüssel erzeugst du einen privaten Schlüssel. Der Schlüssel wird nur einmal angezeigt, beim Erzeugen: DockRay speichert lediglich seinen Hash. Wenn noch kein Projekt existiert, beginne mit Erste Schritte.
Voraussetzungen
- PrestaShop 1.7.8 oder neuer, 8.x oder 9.x,
- PHP 8.2 oder neuer,
- ausgehende HTTPS-Verbindungen vom Shop-Server erlaubt.
Das Modul liegt nicht im Addons-Marktplatz - wir veröffentlichen dockray-prestashop.zip selbst, und du lädst es von der PrestaShop-Integrationsseite herunter. PrestaShop führt bei der Installation kein Composer aus, das SDK liegt daher im Archiv.
Installation über das Backoffice
- Lade das aktuelle Paket
dockray-prestashop.zipherunter. - Melde dich im Backoffice des Shops an.
- Gehe zu Module → Modulmanager und wähle Modul hochladen.
- Wähle das Archiv und warte, bis die Installation abgeschlossen ist.
- Öffne Konfigurieren beim Modul DockRay.
- Trage Projekt-Token und privaten Schlüssel ein und speichere.
- Klicke auf Testereignis senden.
Eine Installation ohne Zugangsdaten ist unbedenklich: das Modul lädt, sendet nichts und verändert das Verhalten des Shops nicht.
Installation über die Kommandozeile
unzip dockray-prestashop.zip -d modules/
php bin/console prestashop:module install dockray
php bin/console cache:clear
Nach einer Konsolen-Installation werden die Zugangsdaten dennoch im Konfigurationsbildschirm des Moduls eingetragen - oder über PHP-Konstanten, die der Konfigurationsartikel behandelt.
Cache nach der Installation leeren
PrestaShop hält die Liste der eingehängten Hooks im Service-Container. Installiert sich das Modul korrekt, meldet aber nichts, ist der erste Schritt php bin/console cache:clear oder das Leeren des Caches unter Erweiterte Parameter → Leistung.
Nach der Installation
Prüfe, ob Token und Schlüssel aus demselben Projekt stammen, und gehe zur Konfiguration: dort legst du Umgebung, Zeitmessung, den Umfang der Kundendaten und - optional - das Sammeln von JavaScript-Fehlern im Shop fest.