Integration

Joomla

Wtyczka systemowa dla Joomla 4 i 5

Free on every plan, including the free one Joomla 4 lub 5, PHP 8.2+ PLG_SYSTEM_DOCKRAY

Where to get it

View in the extensions directory

Joomla Extensions Directory

Start for free Documentation

Installation

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.

How to use it

The integration reports exceptions on its own. This is for the reports you send deliberately.

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;
}