Modulstruktur

Das alaf-Framework ist modular aufgebaut. Somit können Fremdmodule oder Eigenentwicklungen leicht hinzugefügt werden, um zusätzliche Funktionen in ihrem Projekt zu realisieren.

Die zu einem Modul gehörenden Dateien sollten in folgender Weise strukturiert sein, damit das Framework korrekt mit dem Modul arbeitet.

Nachstehend aufgeführt die empfohlene Ordnerstruktur innerhalb des Moduls. Diese Angaben sind teilweise optional, d.h. sie werden nicht für jedes Modul vollständig benötigt:

Modulordner

Der Modulordner sollte einen eindeutigen Namen haben. Dieser Name wird vom Framework in der Modulverwaltung verwendet, um die notwendigen Einstellungen zu ermöglichen.

Der Modulordner sollte enthalten:

index.php

Der Modulordner kann enthalten:

impressum.php

Ordner: admin

Der admin - Ordner enthält grundsätzlich die "Sprungverteiler"-Datei admin.php. Diese Datei wird benötigt, um die Funktionen im Administrationsbereich (Backend) zu routen.

In der Datei configuration.xml wird die Modulkonfiguration im XML-Format hinterlegt. Diese Datei wird vom alaf-Framework gelesen, um den Aufbau des Administrationsbereich (Backend) zu gestalten.

Ordner: core

Im core - Ordner werden die Dateien abgelegt, die von den Grundfunktionen des alaf-Frameworks aufgerufen werden sollen. Dieses sind z.B.:

Datei

Type

Funktion

admin.menu.php

Hook-Datei

Beschreibt die Anordnung und das Aussehen des Modulbezogenen Menüeintrags im Administrationsbereich (Backend)

get.config.php

Hook-Datei

Hook-Datei zur Bekanntgabe der modulspezifischen Konfigurationsdaten.

Beispiel: get.config.php

cleanup.files.php

include

Falls vorhanden, enthält diese Datei 2 array-Variablen ($deldirs[] und $delfiles[] ), die während der Setup-Funktion die zu löschenden Betriebssystem-Verzeichnisse und -Dateien enthält. Diese Funktion wird meistens bei Versionswechsel genutzt!

permissions.php

Hook-Datei

Hook-Datei zur Bekanntgabe der modulspezifischen Rollen und Berechtigungen.

tabledata.php

include

Falls vorhanden, enthält diese Datei Datenbankanweisungen zur Manipulation der Datenbank. Somit können z.B. Standard-Tabelleneinträge erzeugt / geändert werden. Die Ergebnisse werden in der array-Variable $ret_querys[] an die Setup-Funktion zurückgegeben.

tabledef.xml

XML

Konfigurationsdatei zur Beschreibung der benötigten Datenbanktabellen / Tabellenänderungen.

Diese Datei wird während der Setup-Funktion gelesen und interpretiert.

Ordner: includes

Hier liegen die benötigten Include-Dateien für das Modul. Einde detailierte Auflistung folgt ggf.

Ordner: lang

Enthält die Sprachendateien für die modulbezogenen Bezeichnungen.

Ordner: templates

Hier sollten die Vorlagedateien (HTML-Templates) abgelegt werden

Last updated