Online-Dokumentation (Beta) zu CMS Core/Grid 17.x

 
INFO:Version 17.x

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
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.

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.