Bearbeiten eines System-Ereignisses

In der Entwurfsansicht der Bearbeitung eines Ereignisses können Sie die entsprechenden Aktionen festlegen, die bei Eintritt dieses Ereignisses innerhalb des Systems vorgenommen werden sollen. So lassen sich z.B. zu einem Ereignis Protokollierungen oder andere Aktionen (E-Mail Benachrichtigung, etc.) einrichten.

Ereignisse gibt es auf Systemebene, auf Projektebene und auf Verzeichnisebene. Die Abarbeitung der Ereignisse erfolgt dabei immer zuerst auf Verzeichnisebene und dann auf Projektebene. System-Ereignisse betreffen grundsätzlich keine Projekt- bzw. Verzeichnisfunktion und werden abhängig vom der jeweiligen Ereignis abgefeuert.

Nachfolgend werden die Ereignisse auf Systemebene erläutert.

Bearbeiten eines Ereignisses - Entwurfsansicht

Bedienung

Innerhalb des Registers 'Entwurf' können Sie den PHP-Code angeben, der als Aktion zum entsprechenden Ereignis ausgeführt werden soll. Geben Sie diesen ohne die umschliessenden PHP-Tags (<?php ... ?>) an!
In der rechten Spalte werden standardmäßig bereits diverse Code-Fragmente angeboten.

'Eingabefeld':

In diesem Feld tragen Sie den PHP-Code ein, der als Aktion zum entsprechenden Ereignis ausgeführt werden soll.

'+-Zeichen zu Code-Beispielen':

Durch Klick auf das +-Zeichen zu einem vordefinierten Code-Fragment in der rechten Spalte wird der Script-Code des gewählten Snippets in das Inhaltsfenster geschrieben. Sollte bereits Quelltext im Inhaltsfenster vorhanden sein, wird der entsprechende Code am Ende angefügt.

Übersicht der möglichen Ereignisse

Für die entsprechenden Ereignisse kann vor bzw. nach Eintritt des jeweiligen Ereignisses eine Aktion definiert werden, womit Ihnen folgende Ereignisse zur Verfügung stehen:

onBeforeLogin
onAfterLogin
onAfterLoginFailed
onBeforeLogout
onAfterLogout
onAfterLockIp
onBeforeCreateUser
onAfterCreateUser
onBeforeEditUser
onAfterEditUser
onBeforeSetOnlineUser
onAfterSetOnlineUser
onBeforeSetOfflineUser
onAfterSetOfflineUser
onBeforeDeleteUser
onAfterDeleteUser
onAfterInstallUpdate

Abhängig vom jeweiligen Ereignis stehen Ihnen innerhalb der Aktionen im PHP-Code folgende Systemparameter zur Verfügung:

Für Systemereignisse
- $eventData['wEventName']
- Name des Ereignisses (z.B. onAfterEditUser)
- $eventData['wEventTime']
  Zeitstempel des Ereignisses (date('Y-m-d H:i:s'))
- $eventData['wEventUser']
  Benutzer, der das Ereignis angestossen hat (z.B. admin)

Der Verwendungszweck dieser Systemparameter leitet sich bereits aus der Benennung ab. An Stelle dieser Systemparameter können Sie natürlich auch PHP-Framework-Funktionen oder eigene PHP-Funktionen einsetzen.