Installation - Joomla

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

• Joomla 4, 5 oder 6,
• PHP 8.2 oder neuer,
• ausgehende HTTPS-Verbindungen vom Server erlaubt.

DockRay für Joomla ist ein Systemplugin (plg_system_dockray). Joomla führt bei der Installation kein Composer aus, das SDK liegt daher im Paket.

Paket installieren

1. Lade dockray-joomla.zip von der Joomla-Integrationsseite herunter.
2. Gehe in der Joomla-Administration zu System → Installieren → Erweiterungen.
3. Wähle Paketdatei hochladen und wähle das Archiv.
4. Warte auf die Installationsbestätigung.

Das Plugin-Manifest enthält die Adresse unseres eigenen Update-Servers, spätere Versionen erscheinen also unter System → Aktualisieren → Erweiterungen wie jedes andere Erweiterungsupdate. Joomla prüft dabei den SHA-256-Hash des heruntergeladenen Pakets und verweigert die Installation bei Abweichung.

Plugin aktivieren

1. Gehe zu System → Plugins.
2. Suche System - DockRay und aktiviere das Plugin.

Eine Aktivierung ohne Zugangsdaten ist unbedenklich: ohne Token und privaten Schlüssel bleibt das Plugin untätig.

Verbindung einrichten

1. Öffne System - DockRay → Optionen.
2. Trage Projekt-Token und privaten Schlüssel ein.
3. Speichere die Konfiguration.
4. Klicke auf Testereignis senden, um die Verbindung ohne Seitenwechsel zu prüfen.

Nach der Installation

Prüfe, ob Token und Schlüssel aus demselben Projekt stammen, und gehe zur Konfiguration: dort legst du Umgebung, Zeitmessung, Daten des angemeldeten Benutzers und - optional - das Sammeln von JavaScript-Fehlern der Website fest.