WordPress

Plugin für WordPress und WooCommerce

Das offizielle DockRay-Plugin verbindet WordPress mit der Monitoring-Plattform und meldet automatisch PHP-Fehler sowie unbehandelte Ausnahmen. Probleme in WordPress, im Theme, in Plugins oder in WooCommerce werden direkt an das DockRay-Dashboard übermittelt.

Informationen zu Fehlern

Gemeldete Ereignisse können unter anderem folgende Informationen enthalten:

Typ und Beschreibung des Fehlers,
Ort des Auftretens und Stack Trace,
Informationen über die Umgebung und Anwendungsversion,
Kontext der verarbeiteten Anfrage.

Der Umfang der gemeldeten PHP-Fehler lässt sich anpassen, um die Erfassung weniger relevanter Ereignisse einzuschränken.

Einfache Konfiguration

Die Integration konfigurieren Sie unter Einstellungen → DockRay, indem Sie den Projekt-Token und den privaten Schlüssel eingeben. Die Zugangsdaten können alternativ auch in der Datei wp-config.php definiert werden.

Datenschutz und Funktionen für Entwickler

Standardmäßig übermittelt DockRay keine Benutzerdaten. Optional kann zusätzlicher Kontext aktiviert werden, beispielsweise Benutzer-ID, E-Mail-Adresse, IP-Adresse oder User-Agent.

Das Plugin ermöglicht außerdem das Hinzufügen eigener Tags und zusätzlicher Kontextinformationen, die Anpassung der Client-Konfiguration sowie die manuelle Meldung von Ausnahmen direkt aus dem Code.

Installation

Installation über das WordPress-Plugin-Verzeichnis

Gehen Sie im WordPress-Administrationsbereich zu Plugins → Neues Plugin hinzufügen.
Suchen Sie nach DockRay und klicken Sie auf Jetzt installieren.
Klicken Sie nach Abschluss der Installation auf Aktivieren.
Gehen Sie zu Einstellungen → DockRay.
Geben Sie den im DockRay-Dashboard verfügbaren Projekt-Token und den privaten Schlüssel ein und speichern Sie die Einstellungen.
Verwenden Sie die Schaltfläche Testereignis senden, um zu überprüfen, ob die Verbindung korrekt funktioniert.

Nach erfolgreicher Konfiguration beginnt das Plugin automatisch damit, unterstützte Fehler und Ausnahmen an Ihr Projekt in DockRay zu melden.

Konfiguration über wp-config.php

Wenn Sie die Zugangsdaten nicht in der WordPress-Datenbank speichern möchten, können Sie den Projekt-Token und den privaten Schlüssel direkt in der Datei wp-config.php definieren:

define( 'DOCK_RAY_TOKEN', 'IHR_PROJEKT_TOKEN' );
define( 'DOCK_RAY_PRIVATE_KEY', 'IHR_PRIVATER_SCHLUESSEL' );

Fügen Sie die Konstanten vor dem Kommentar ein, der das Ende des bearbeitbaren Bereichs der Datei wp-config.php kennzeichnet. Nach dem Speichern erkennt das Plugin die Konfiguration automatisch. Die verwendete Konfigurationsquelle wird unter Einstellungen → DockRay angezeigt.

Installation aus einem ZIP-Archiv

Laden Sie die aktuelle Version des DockRay-Plugins von WordPress.org herunter.
Gehen Sie im WordPress-Administrationsbereich zu Plugins → Neues Plugin hinzufügen → Plugin hochladen.
Wählen Sie das heruntergeladene ZIP-Archiv aus und starten Sie die Installation.
Aktivieren Sie das Plugin.
Gehen Sie zu Einstellungen → DockRay und konfigurieren Sie die Verbindung zu Ihrem Projekt.