Callbacks
Callback-Funktionen basieren auf dem Event Dispatcher-Pattern. Sie können mehrere Callback-Funktionen pro Ereignis registrieren, die dann bei dessen Eintreten ausgeführt werden. Mit Hilfe von Callbacks kann der Programmablauf der Contao Core-Engine angepasst werden.
Globale Callbacks
| Callback | Beschreibung |
|---|---|
| onload_callback | Wird bei der Initialisierung des DataContainer-Objekts ausgeführt. Ermöglicht z.B. das Prüfen von Zugriffsrechten oder die dynamische Änderung des Data Container Array zur Laufzeit. |
| onsubmit_callback | Wird beim Abschicken eines Backend-Formulars ausgeführt. Ermöglicht z.B. die Modifizierung der Formulardaten, bevor diese in die Datenbank geschrieben werden (wird in der Kalender-Erweiterung zur Intervalberechnung eingesetzt). |
| ondelete_callback | Wird ausgeführt bevor ein Datensatz aus der Datenbank entfernt wird. |
| oncut_callback | Wird ausgeführt nachdem ein Datensatz verschoben wurde. Hinzugefügt in Version 2.8.2. |
| oncopy_callback | Wird ausgeführt nachdem ein Datensatz dupliziert wurde. Hinzugefügt in Version 2.8.2. |
Auflistungscallbacks
| Callback | Beschreibung |
|---|---|
| paste_button_callback | Ermöglicht individuelle Einfüge-Schaltflächen und wird z.B. in der Seitenstruktur verwenden, um die Icons abhängig von den Benutzerrechten zu deaktivieren (erfordert eine zusätzliche Prüfung mittels load_callback). |
| child_record_callback | Legt fest, wie die Kindelemente im "Parent View" dargestellt werden. |
| group_callback | Ermöglicht individuelle Gruppennamen in der Listenansicht. |
| label_callback | Ermöglicht individuelle Bezeichnungen in der Listenansicht und wird z.B. im Benutzer-Modul verwendet, um die Status-Icons hinzuzufügen. |
Aktionscallbacks
| Callback | Beschreibung |
|---|---|
| button_callback | Ermöglicht individuelle Navigationssymbole und wird z.B. in der Seitenstruktur verwenden, um Icons abhängig von den Benutzerrechten zu deaktivieren (erfordert eine zusätzliche Prüfung mittels load_callback). |
Feldcallbacks
| Callback | Beschreibung |
|---|---|
| options_callback | Ermöglicht das Befüllen eines Drop-Down-Menüs oder einer Checkbox-Liste mittels einer individuellen Funktion. Kann z.B. für bedingte Fremdschlüssel-Relationen verwendet werden. |
| input_field_callback | Ermöglicht das Erstellen individueller Formularfelder und wird z.B. im Backend-Modul "Persönliche Daten" verwendet, um das "Daten bereinigen"-Feld zu erstellen. Achtung: Eingaben werden nicht automatisch gespeichert! |
| load_callback | Wird bei der Initialisierung eines Formularfeldes ausgeführt. Ermöglicht z.B. das Laden eines Standardwertes. |
| save_callback | Wird beim Abschicken eines Feldes ausgeführt. Ermöglicht z.B. das Hinzufügen einer individuellen Prüfung. |
Einen Kommentar hinzufügen
Kommentar von Andreas Schempp |
Ergänzung für "input_field_callback": Der Funktion wird als erster Parameter der DataContainer und als zweiter Parameter der xlabel (z.B. Filepicker) übergeben.