Zdarzenia / Events
Krótkie objaśnienie Po co eventy? Po to by za pomocą zewnętrznych pluginów czy plików inicjalizacyjnych można było rozbudowywać konkretne funkcjonalności w systemie. Funkcja nasłuchująca zdarzenia jest implementowana w odpowiednim miejscu systemu. Z pluginu czy innego pliku wywoływana jest funkcja zdarzenia.
Funkcja
Użycie funkcji nasłuchującej
trigger(string $event, array $parameters);
event string - nazwa zdarzenia, które chcemy wykonać
parametry Array - parametry, które przekazujemy do zdarzenia
parametry Array - parametry, które przekazujemy do zdarzenia
Użycie funkcji zdarzenia
add_event(string $event, callable $callback, int $priority)
event string - nazwa zdarzenia, do którego się odwołujemy
callback function - funkcja, która będzie wykonywana
priority int - priorytet z jakim będzie wykonywana funkcja
callback function - funkcja, która będzie wykonywana
priority int - priorytet z jakim będzie wykonywana funkcja
Przykład zastosowania
$user = 'John';
add_event('add_surname', function($data) {
$data['name'] .= ' Smith';
});
trigger('add_surname', ['name' => &$user]); // w tym przypadku użycie referencji & by zarządzać zmienną
var_dump($user);
// Rezultat
string(10) "John Smith"
Lista zdarzeń
| Nazwa zdarzenia | Miejsce wywowłania | Parametry | Opis |
|---|---|---|---|
| admin_init | /app/src/App/Backend.php | Zdarzenie wywoływane w konstruktorze głównego kontrolera panelu administracyjnego - po dodaniu elementów menu, styli i skryptów. | |
| admin_dashboard | /app/admin/controller/index.php |
html Zawartość ekranu Dashboard (jako referencja)
|
Zdarzenie przeznaczone do rozbudowy ekranu dashboard przez zewnętrzne moduły |
| admin_before_render | /app/src/App/Backend.php |
current Aktualny moduł
|
Zdarzenie wywoływane przed wyrenderowaniem HTML |