Überprüfung und typische Probleme - Joomla

Das Testereignis

Klicke in System - DockRay → Optionen auf Testereignis senden. Das Plugin sendet ein Ereignis und zeigt das Ergebnis ohne Seitenwechsel; der Statusbereich bewahrt Ergebnis und Zeitpunkt des letzten Versuchs. Das Ereignis sollte im Panel unter Fehler des Projekts erscheinen, auf das der Token zeigt.

Prüfung an einem echten Fehler

Der Test bestätigt die Verbindung, nicht das automatische Erfassen. Löse in einer Testinstallation einen Fehler aus, für den Joomla eine Fehlerseite rendert - darum kümmert sich das Ereignis onError - und prüfe im Panel Umgebung, Zeit und Anfragekontext.

Typische Probleme

Das Plugin ist installiert, meldet aber nichts

Prüfe, ob es unter System → Plugins aktiviert ist - eine Installation aktiviert die Erweiterung nicht. Prüfe danach die Zugangsdaten: ohne Token und Schlüssel bleibt das Plugin absichtlich untätig.

Die Verbindungsfelder sind aus dem Optionsbildschirm verschwunden

Die Konfigurationsquelle steht auf Nur configuration.php. In diesem Modus sind die Verbindungsfelder absichtlich verborgen, und die Werte kommen allein aus Konstanten. Stelle auf Auto oder Nur dieser Bildschirm zurück, wenn du sie im Backend eintragen willst.

Der gespeicherte Token weicht von dem eingetragenen ab

In der configuration.php ist DOCKRAY_TOKEN oder DOCKRAY_PRIVATE_KEY definiert, während die Konfigurationsquelle auf Auto steht - dann gewinnt die Konstante. Der Statusbereich listet die aktiven Konstanten auf.

JavaScript-Fehler kommen nicht an

Der Kollektor ist standardmäßig aus - aktiviere JavaScript-Fehler sammeln in den Plugin-Parametern. Denke außerdem an das Limit von 16 kB pro Meldung: ein sehr langer Stack aus einem minifizierten Bundle kann es überschreiten.

Transaktionen fehlen

Transaktionen entstehen nur bei einer Stichprobenrate über 0 und schließen auf onAfterRespond. Eine vorher abgebrochene Anfrage - etwa eine Weiterleitung mit exit in einer anderen Erweiterung - hinterlässt keine Transaktion.

Joomla-Cache nach einem Plugin-Update

Leere nach dem Update der Erweiterung den Cache unter System → Cache leeren. Ein altes, zwischengespeichertes Seitenlayout enthält den Browser-Fehlerkollektor möglicherweise noch nicht.

Das Panel antwortet 200, aber es gibt kein Ereignis

Eine Antwort 200 {"success": false} bedeutet, dass das Konto sein monatliches Fehlerkontingent aufgebraucht hat. Die Integration behandelt das nicht als Störung - zu Recht. Das Kontingent siehst du im Konto-Dashboard; bis zum Monatsende wird es aus der erfassten Nutzung berechnet, Fehler zu löschen setzt es also nicht zurück.

Es funktioniert weiterhin nicht

Arbeite die Checkliste zur Fehlerbehebung durch, und wenn das nicht hilft, schreib uns. Nenne den Projektnamen, die Version der Integration und ungefähr die Uhrzeit des Tests: das verkürzt den Weg zur Antwort.