Instalacja - Joomla

Zanim zaczniesz, utwórz projekt w panelu DockRay. W jego ustawieniach znajdziesz token projektu - publiczny identyfikator, który wchodzi do adresu endpointu - a w zakładce Klucze API wygenerujesz klucz prywatny. Klucz jest pokazywany tylko raz, w momencie generowania: w bazie DockRay leży wyłącznie jego skrót. Jeżeli nie masz jeszcze projektu, zacznij od zakładania konta i pierwszego projektu.

Wymagania

• Joomla 4, 5 albo 6,
• PHP 8.2 lub nowszy,
• możliwość wykonywania połączeń wychodzących HTTPS z serwera.

DockRay dla Joomli to wtyczka systemowa (plg_system_dockray). Joomla nie uruchamia Composera przy instalacji, więc SDK jest dołączone do paczki.

Instalacja paczki

1. Pobierz paczkę dockray-joomla.zip ze strony integracji Joomla.
2. W zapleczu Joomli przejdź do System → Instaluj → Rozszerzenia.
3. Wybierz Prześlij plik pakietu i wskaż archiwum.
4. Poczekaj na potwierdzenie instalacji.

Manifest wtyczki niesie adres własnego serwera aktualizacji, więc kolejne wydania zobaczysz w System → Aktualizuj → Rozszerzenia tak samo jak aktualizacje pozostałych rozszerzeń. Joomla sprawdza przy tym skrót SHA-256 pobranej paczki i odmawia instalacji przy niezgodności.

Włączenie wtyczki

1. Przejdź do System → Wtyczki.
2. Znajdź System - DockRay i włącz wtyczkę.

Włączenie bez poświadczeń jest bezpieczne: bez tokenu i klucza prywatnego wtyczka pozostaje bezczynna.

Konfiguracja połączenia

1. Otwórz System - DockRay → Opcje.
2. Wpisz token projektu i klucz prywatny.
3. Zapisz konfigurację.
4. Kliknij Wyślij zdarzenie testowe, żeby sprawdzić połączenie bez opuszczania ekranu.

Po instalacji

Sprawdź, czy token i klucz pochodzą z tego samego projektu, i przejdź do konfiguracji: tam ustawisz środowisko, pomiar czasu żądań, dane zalogowanego użytkownika oraz - opcjonalnie - zbieranie błędów JavaScriptu ze strony.