Integracja

Joomla

Wtyczka systemowa dla Joomla 4 i 5

Dostępna bezpłatnie Joomla 4 lub 5, PHP 8.2+ PLG_SYSTEM_DOCKRAY

Skąd wziąć

Zobacz w katalogu rozszerzeń

Joomla Extensions Directory

Zacznij za darmo Dokumentacja

Instalacja

Z katalogu rozszerzeń (Joomla Extensions Directory):

  1. System → Instaluj → Rozszerzenia → zakładka „Instaluj z adresu URL”
  2. wklej adres paczki z JED → Sprawdź i zainstaluj

Z pobranego pliku:

  1. System → Instaluj → Rozszerzenia → „Prześlij plik pakietu”
  2. wskaż plg_system_dockray.zip

Instalacja NIE włącza wtyczki - to osobny krok:

  3. System → Wtyczki → wyszukaj „DockRay” → ustaw status na Włączona
  4. Opcje → wklej token projektu i klucz prywatny → Send a test event

Systemowa wtyczka DockRay przechwytuje wyjątki powstające podczas obsługi żądań przez Joomla, w tym awarie komponentów, modułów, szablonów i kodu własnego. Opcjonalnie może również zbierać błędy JavaScriptu z publicznej części serwisu. Wtyczkę instaluje się za pomocą wbudowanego instalatora rozszerzeń, następnie należy ją jawnie włączyć i uzupełnić token projektu oraz klucz prywatny. Poświadczenia mogą zostać nadpisane w pliku configuration.php, jeżeli polityka wdrożeniowa wymaga przechowywania sekretów poza bazą danych.

Jak tego użyć

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

php

<?php
// Wtyczka systemowa łapie wyjątki żądania sama. To jest do zgłoszeń
// wysyłanych świadomie z komponentu albo z własnej wtyczki.

use Dock\Ray\Joomla\Hub;

Hub::get()->captureMessage('Synchronizacja katalogu nie zwróciła pozycji');

try {
    $model->save($data);
} catch (Throwable $e) {
    Hub::get()->captureException($e);

    throw $e;
}