WordPress

Wtyczka dla WordPressa i WooCommerce

Dostępna bezpłatnie

Zacznij za darmo Dokumentacja

Skąd wziąć

Zobacz w katalogu wtyczek

Katalog wtyczek WordPress.org

Wymagania WordPress 5.6+, PHP 7.2+

Nazwa paczki dockray

Cennik Za darmo

Do czego to służy

Oficjalna wtyczka DockRay łączy WordPressa z platformą monitoringu i automatycznie raportuje błędy PHP oraz nieobsłużone wyjątki. Problemy z WordPressa, motywu, wtyczek czy WooCommerce trafiają bezpośrednio do panelu DockRay.

Informacje o błędach

Zgłoszone zdarzenia mogą zawierać między innymi:

typ i treść błędu,
miejsce wystąpienia i stos wywołań,
informacje o środowisku i wersji aplikacji,
kontekst obsługiwanego żądania.

Zakres raportowanych błędów PHP można dostosować, aby ograniczyć zbieranie mniej istotnych zdarzeń.

Prosta konfiguracja

Integrację skonfigurujesz w sekcji Ustawienia → DockRay, podając token projektu i klucz prywatny. Dane dostępowe można również zdefiniować w pliku wp-config.php.

Prywatność i możliwości dla programistów

Domyślnie DockRay nie przesyła danych użytkowników. Opcjonalnie można włączyć dodatkowy kontekst, taki jak identyfikator użytkownika, adres e-mail, IP czy user agent.

Wtyczka pozwala również dodawać własne tagi i kontekst, modyfikować konfigurację klienta oraz ręcznie raportować wyjątki z poziomu kodu.

Instalacja

Instalacja z katalogu wtyczek WordPress

W panelu WordPress przejdź do Wtyczki → Dodaj nową.
Wyszukaj DockRay i kliknij Zainstaluj teraz.
Po zakończeniu instalacji kliknij Aktywuj.
Przejdź do Ustawienia → DockRay.
Wprowadź token projektu oraz klucz prywatny dostępne w panelu DockRay i zapisz ustawienia.
Użyj przycisku Wyślij zdarzenie testowe, aby sprawdzić, czy połączenie działa poprawnie.

Po poprawnej konfiguracji wtyczka automatycznie rozpocznie raportowanie obsługiwanych błędów i wyjątków do Twojego projektu w DockRay.

Konfiguracja przez wp-config.php

Jeśli nie chcesz przechowywać danych dostępowych w bazie WordPressa, token projektu i klucz prywatny możesz zdefiniować bezpośrednio w pliku wp-config.php:

define( 'DOCK_RAY_TOKEN', 'TWOJ_TOKEN_PROJEKTU' );
define( 'DOCK_RAY_PRIVATE_KEY', 'TWOJ_KLUCZ_PRYWATNY' );

Stałe dodaj przed komentarzem kończącym edycję pliku wp-config.php. Po ich zapisaniu wtyczka automatycznie rozpozna konfigurację, a jej źródło będzie widoczne w Ustawienia → DockRay.

Instalacja z archiwum ZIP

Pobierz aktualną wersję wtyczki DockRay z WordPress.org.
W panelu WordPress przejdź do Wtyczki → Dodaj nową → Wyślij wtyczkę na serwer.
Wybierz pobrane archiwum ZIP i rozpocznij instalację.
Aktywuj wtyczkę.
Przejdź do Ustawienia → DockRay i skonfiguruj połączenie z projektem.

Jak tego użyć

Wyjątki integracja raportuje sama. To jest do zgłoszeń, które chcesz wysłać świadomie.

php

<?php

if ( function_exists( 'dock_ray_safe' ) ) {
    dock_ray_safe( fn( $hub ) => $hub->captureMessage( 'Error message...' ) );
}

try {
    $order->finalize();
} catch ( Throwable $e ) {
    if ( function_exists( 'dock_ray_safe' ) ) {
        dock_ray_safe( fn( $hub ) => $hub->captureException( $e ) );
    }
}