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.
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.
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.
Dateifunktionen
'Abbrechen':
Unterbricht die aktuelle Bearbeitung der Seite und verwirft die vorgenommenen Änderungen (seit dem letzten Zwischenspeichern) wieder.
'Speichern
und schliessen':
Speichert
die in der Datei vorgenommenen Änderungen endgültig in der
Originaldatei ab und erstellt vom vorigen Stand je nach Einstellung
eine Sicherung (Versionierung).
'Speichern':
Diese Zwischenspeichern-Funktion steht nur einem Administrator zur Verfügung und speichert
bei Klick Änderungen direkt in der Orginaldatei ab, ohne jedes Mal eine
Arbeitskopie abzulegen. Abgeschlossen wird die Dateibearbeitung immer
über den Button 'Speichern und schliessen'.
Die Funktion ist zu empfehlen, wenn Änderungen ständig in der Präsenz
verglichen werden sollen und nicht jedes Mal die Datei neu aufgerufen
und gespeichert werden soll.
'Pause':
Speichert den
derzeitigen Bearbeitungsstand der Datei in einer Arbeitskopie ab, die
bei späterer Bearbeitung weiterverwendet werden kann.
'Vorschau':
Öffnet ein neues Fenster und zeigt den derzeitigen Bearbeitungsstand der
Datei an.
'Versionen anzeigen':
Öffnet die
Versionsverwaltung der aktuell bearbeiteten Datei. Diese Funktion steht Ihnen nur bei entsprechender Lizenzierung zur Verfügung.