Für verschiedene Systemereignisse können entsprechende Dateien vom Modul zur Verfügung gestellt werden, um die Systemintegration zu optimieren. Die sogenannten „hook“-Dateien werden immer vom System aus aufgerufen, nie vom Modul selber. Diese Dateien müssen sich im Unterordner core/ des Moduls befinden. Nachstehend die Auflistung der Ereignisse und der dafür verwendeten Dateien.
Ereignis |
Datei |
Bemerkungen |
Rückgabewert in |
---|---|---|---|
Administrator Info |
admin.newentries.php |
Listet die evtl. Neuigkeiten für den Administrator im Adminpaneel auf |
$hook_result[] = array(…) |
admin.menu | Menüpunkte für das Adminmenü | ||
captcha | Liste zur Captcha Konfiguration | ||
User Neuanlage |
User.add.php |
|
- |
User Ändern |
User.edit.php |
|
- |
User löschen |
User.delete.php |
|
- |
Useraccount |
User.navbar.php |
Generiert die Tabs im eigenen Useraccount |
$item[] = array(….) |
User ansehen |
User.visitmenu.php |
Generiert die Tabs für einen User |
$item[] = array(….) |
Userpunkte abfragen |
User.userpoints.php |
|
$hook_result += $Wert |
User Login |
User.login.php |
Wird beim Anmelden eines Users ausgeführt |
- |
User Logout |
User.logout.php |
Wird beim Abmelden eines Users ausgeführt |
|
user.reactivate | wenn, ein Benutzer reaktiviert wurde | ||
user.passlost | wenn ein Benutzer ein neues Passwort angefordert hat | ||
user.edithome | wenn ein Benutzer sein Profil geändert hat (Tab Einstellungen > Optionen) | ||
user.newentries | Neue Nachrichten für den aktuellen Benutzer | ||
user.navbar | Die Menüpunkte bzw. Tabs im Userprofil des aktuellen Benutzers | ||
user.navbar.inner | Die Menüpunkte bzw. Tabs im Tab Einstellungen des Userprofils | ||
|
Mod_rewrite.php |
suchen und Ersetzliste für SEO |
|
Ausgabe Modul-Content | prepare.content.php | darüber kann der Content der Module (nicht der Blöcke!!) vor der Ausgabe verändert werden. | $hook_parameters = $content |
Ausgabe der ganzen Seite | prepare.page.php | darüber kann der komplette HTML Inhalt der Seite nochmals verändert werden | $hook_parameters = $content |
Suchfunktion | search.content.php | globale Suchfunktion | $hook_result[$modulename] = array(); |
prepare.header | nutzt die Header-Klasse um den HTML-Header zu ergänzen | ||
Gruppenfunktionen | groups.add | wenn, eine Benutzergruppe erstellt wurde | |
groups.delete | wenn, eine Benutzergruppe gelöscht wurde | ||
groups.edit | wenn, eine Benutzergruppe geändert wurde | ||
groups.moveto | wenn, Benutzer in eine Benutzergruppe zugeteilt wurden | ||
Sonstiges | backend | Daten für die backend.php bzw. den rss-Feed | |
search.content | Suchergebnisse und Modulliste im Suchmodul | ||
statistics.content | Daten für das Statistik Modul | ||
top | Daten für das Top Modul |
Beispiele für einige Hook-Dateien befinden sich im Anhang.