Links

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:
Modulstruktur am Beispiel des Blog-Moduls

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 modified 4yr ago