Modularisierung

<?php
if (modul_check('module/[modulname]/[moduldatei_ohne_endung]','.def.php')) {
//
}

...{shopdir}/shop/module/
    ausgabefilter (User Security Verzeichnis)
    klick_statistik
    rechnungsgenerator
    warenwirtschaft_sap_upd*

...{shopdir}/shop/Admin/module/
    ausgabefilter (Admin Security Verzeichnis)
    klick_statistik
    rechnungsgenerator
    warenwirtschaft_sap_upd

<?php
/** Interface ID: 2, Name: bestell_obj_nach_erfolg_bestellung begin **/
// Beschreibung: Dieses Modulinterface stellt das Bestellungsobjekt
// nach einer erfolgreichen Bestellung zur Verfuegung
$interface_id     = 2;
$interface_object = $meineBestellung; // Das Interface-Objekt ist hier also eine Bestellung
$modul_interface  = new Module_interface($interface_id);
$interface_object = $modul_interface->call_modules($interface_object);
/** Interface ID: 2, Name: bestell_obj_nach_erfolg_bestellung end   **/

{shopdir}/shop/module/mein_neues_modul/
    interface_counter_functions.php

{shopdir}/shop/Admin/module/mein_neues_modul/
    initialize_module.php
    module_admin_img.gif
    show_interface_counter.php

<?php
$moduldef['interfaces'][1]['interface_id'] = '2';
$moduldef['interfaces'][1]['file_with_function'] = 'interface_counter_functions.php';
$moduldef['interfaces'][1]['function_name'] = 'update_interface_counter';
$moduldef['interfaces'][1]['filter_typ'] = 'one_way';

<?php
// Die Funktion update_interface_counter fuehrt Buch ueber die Aufrufe der Interfaces, fuer
// welche dieses Modul (Persistent Interface Counter) registriert ist. Wenn noch kein Count-
// Eintrag in der Tabelle persistent_interface_counter_counts vorhanden ist, wird eine neue
// Zeile erstellt, ansonsten wird der bestehende Counterstand inkrementiert.
// Argumente: Datenarray (Array), Elementbeschreibung:
//            'interface         = Daten des Interfaces, welches diese Funktion aufgerufen hat
//            'interface_object' = Das Objekt, um welches es beim Interface gerade geht
//          [ 'session_id'       = Session-ID des Kunden, so sie vorhanden ist(!) ]
// Rueckgabe: Keine
function update_interface_counter($data_array) {

      // Beispiel eines Zugriffs auf das Interface-Objekt
      debug($data_array['interface_object']);
      debug($data_array['interface']->name);
      debug($data_array['session_id']);
}

<?php
// -----------------------------------------------------------------------
// API Version der hier verwendeten PepperShop Modulschnittstelle:
$pps_module_api = '1.0';

// Informationen zu externen PepperShop Modulen:
// ===============================================
// Module bestehen mindestens aus zwei Verzeichnissen: {shopdir}/shop/module/modul_name
// und {shopdir}/shop/Admin/module/modul_name. Im Admin-Modulverzeichnis muss mindestens
// diese Datei (initialize_module.php) vorhanden sein.
// - Ein Modul kann aber ohne weiteres auch eigene Unterverzeichnisse besitzen, sowie auch
//   Submodule haben.
// - Damit Module Daten persistent speichern koennen, duerfen sie waehrend der Installation
//   eigene Tabellen erstellen und bestehende um eigene Attribute erweitern. Bei einer De-
//   installation werden diese Datenbankerweiterungen wieder entfernt.
// - User-Security Scripte befinden sich in {shopdir}/shop/module/modul_name,
//   die Admin-Security-Scripts befinden sich im Admin-Pendant.
// - Module koenne (zumindest im Moment) noch keine eigenen Interfaces haben.
// - Module koennen weitere Module als Voraussetzung angeben.

// Definition der Variablen:
// =========================
// Die weiter unten definierten Variablen dienen der Beschreibung des Moduls. Diese muss
// sehr ausfuehrlich sein, damit das automatisierte Installations- und Deinstallationsscript
// durchlaufen kann. Nomenklatur:
// x.) Bezeichnung    : Leitet eine weitere Definition ein. x ist eine Laufnummer
// ! Beschreibung     : Beschreibung umschreibt Hinweise zum Thema der Bezeichnung
// --> Einschraenkung : Mit --> werden ZWINGEND ZU BEFOLGENDE Einschraenkungen der Bezeichnung genannt

// --------------------------------------------------------------------------------------
// ******************************* DEFINITION DES MODULS *******************************
// --------------------------------------------------------------------------------------

//  1.) Name des Moduls (entspricht dem Verzeichnisname des Moduls)
//      --> Der Name eines externen PepperShop Moduls darf hoechstens 40 Zeichen lang sein.
//      --> Der Name muss mindestens 3 Zeichen lang sein.
//      --> Er darf NUR aus alphanummerischen Zeichen und dem Underscore Zeichen (_) bestehen.
//      --> Dieser Name ist gleichzeitig auch der Name des Verzeichnisses des Moduls.
$moduldef['modulname'] = 'persistent_interface_counter';

// 2.) Bezeichnung des Moduls
//      ! Dies ist die Bezeichnung des Moduls und unterliegt somit weniger Restriktionen als der Modulname
//      --> Der Name darf hoechstens 40 Zeichen lang sein
//      --> Der Name muss mindestens 3 Zeichen lang sein.
$moduldef['modulbezeichnung'] = 'Persistenter Interface Counter';

// 3.) Versionschecknummern
//      ! Diese Nummern definieren die zu verwendende PepperShop Versionen. Die Versionisierung
//        ist wie folgt: Die erste und zweite Nummer (durch Punkt getrennt) ergeben ein Release.
//        Jedes unterstuetzte Release muss explizit angegeben werden. Die dritte (durch einen
//        Punkt getrennte Nummer (eigentlich ein String), definiert Versionen des Releases. Alle
//        Versionen eines Releases sind kompatibel, es sei denn man definiert auch die Versions-
//        Nummer, dann sind alle aelteren Versionen des angegebenen Releases inkompatibel.
//        Bsp. 1.4;1.5     = Das Modul ist kompatibel zu den Releases 1.4 und 1.5. Dies schliesst auch
//                           alle Versionen der beiden Releases mit ein: 1.4.003, 1.4.004, 1.5.1, ...
//        Bsp. 1.4.005;1.5 = Hier sind alle Versionen von 1.4 mit und nach 1.4.005 kompatibel und
//                           alle Versionen von 1.5.
//      ! Achtung: Man sollte keine zukuenftigen Releases angeben!
//      --> Einzelne Versionen via Strichpunkt getrennt eingeben.
$moduldef['versionschecknummern'] = '1.4.005;1.5;1.6;1.7;1.8;1.9;2.0;2.1;2.5;2.6;2.7;3.0;3.1;3.2;4.0;5.0';

//  4.) Kurzbeschreibung
//      ! Formatierungen sollen via HTML-Tags eingegeben werden.
$moduldef['kurzbeschreibung'] = '<b>ACHTUNG: DIES IST EIN TESTMODUL - NICHT IN PRODUKTIVEN SHOPS EINSETZEN!</b><br>
                                 Dieses Testmodul z&auml;hlt die Aufrufe der einzelnen Module, bei welchen
                                 es registriert ist. Es wird eine eigene Tabelle erzeugt und es gibt ein
                                 kleines Adminmen&uuml; um die Resultate ansehen zu k&ouml;nnen. Dies ist
                                 ein Testmodul, mit welchem man &uuml;ben kann, eigene externe PepperShop
                                 Module zu erstellen. Bitte nicht in produktiven Systemen installieren, da
                                 durch dieses Modul die Performance beim Bestellabschluss etwas vermindert wird.
                                ';

//  5.) Weiterfuehrender Link
//      ! Wenn dieser (optionale) Link angegeben ist, so kann der Shopadmin hier weitere Infos zum Modul holen.
//      --> Das Schema muss vor der URL angegeben werden (Schema = http:// oder https://, ...)
$moduldef['weitere_infos_link'] = 'http://www.peppershop.com/';

//  6.) Version dieses Moduls
$moduldef['modulversion'] = '1.0';

//  7.) Releasedatum dieser Modulversion
//      --> Format: TT.MM.JJJJ
$moduldef['releasedatum'] = '08.08.2012';

//  8.) Informationen zu den Entwicklern
//      ! Beispiel: José Fontanil <fontajos@peppershop.com>. Strings in <> werden als E-Mail angezeigt.
$moduldef['entwickler_infos'] = 'Jos&eacute; Fontanil <fontajos@peppershop.com>';

//  9.) Ist Submodul von
//      ! Hier kann man den Modulnamen (nicht die Modulbezeichnung!) des Hauptmoduls angeben, falls dieses
//        Modul hier ein Submodul des Hauptmoduls ist.
//      --> Der Name eines externen PepperShop Moduls darf hoechstens 40 Zeichen lang sein.
//      --> Der Name muss mindestens 3 Zeichen lang sein.
//      --> Er darf nur aus alphanummerischen Zeichen und dem Underscore Zeichen (_) bestehen.
//      --> Dieser Name ist gleichzeitig auch der Name des Verzeichnisses des HAUPTmoduls.
$moduldef['submodule_of'] = '';

// 10.) Fingerprint
//      ! Im Moment noch nicht benutzt - spaeter wird hier ein MD5 Digest hinterlegbar sein, welcher dem
//        Shopadministrator erlaubt die Integritaet eines Moduls zu ueberpruefen.
//      --> MD5 Digest (32 Chars Laenge, Hexadezimales Alphabet)
$moduldef['fingerprint'] = '22b66409b0554640691d3d27541edfbb';

// 11.) Unterstuetzte Locales (Sprachen und optional Laender) - dient (vorerst) nur zur Anzeige fuer den Shopadmin
//      --> Format: ISO-639-1 fuer alleinstehende Sprachen (Bsp. de;en;fr;sp;...)
//      --> Format: ISO-639-2 fuer Sprachen inkl. Laender (Bsp. de_CH;de_DE;en_GB;en_US)
//      --> Wenn das Modul weder Sprach-, noch Laenderabhaengig ist kann all angegeben werden.
//      --> Die einzelnen Angaben koennen Strichpunkt separiert eingegeben werden. ISO-639-1 und -2 koennen gemixt werden.
$moduldef['locales'] = 'all';

// 12.) Interfaces, bei welchen sich das Modul registrieren soll
//      ! Dies ist ein etwas komplexerer Eingabetyp - es ist ein mehrdimensionaler Array - mehr nicht.
//      ! Pro Interface, bei welchem sich das Modul registrieren will, sind vier Angaben noetig:
//        (1) Interface_ID, (2) Datei, worin sich die auszufuehrende Funktion befindet,
//        (3) Name der auszufuehrenden Funktion, (4) Filtertyp
//      --> Format: array('i_id'=>'w','file'=>'x','func'=>'y','filter'=>'z')
//          --> w = Interface_ID, Format: positive Integerzahl (max. Digits == 11)
//          --> x = Dateiname, Format: Dateiname.Extension (kein Pfad)
//          --> y = Funktionsname, Format: Name der Funktion ohne Klammern mit Argumenten
//          --> z = Filtertyp, Format: one_way oder filter
// Registrierung beim ersten Interface:
$moduldef['interfaces'][0]['interface_id'] = '1';
$moduldef['interfaces'][0]['file_with_function'] = 'interface_counter_functions.php';
$moduldef['interfaces'][0]['function_name'] = 'update_interface_counter';
$moduldef['interfaces'][0]['filter_typ'] = 'one_way';
// Registrierung beim zweiten Interface:
$moduldef['interfaces'][1]['interface_id'] = '2';
$moduldef['interfaces'][1]['file_with_function'] = 'interface_counter_functions.php';
$moduldef['interfaces'][1]['function_name'] = 'update_interface_counter';
$moduldef['interfaces'][1]['filter_typ'] = 'one_way';

// 13.) Eigene Tabellen, welche angelegt werden sollen
//      ! Hier werden die eigens fuer dieses Modul zu erstellenden Tabellen angegeben
//      ! Wenn keine Tabellen erstellt werden muessen, einfach leerer Array definieren
//      --> Achtung: Eine Tabelle muss mindestens EIN Attribut besitzen, sonst wird sie nicht angelegt.
//      --> Format: array('table_name'=>'x','table_beschreibung'=>'y','attribute'=>z)
//          --> x = Name der Tabelle: MySQL Restriktionen (max. 64 Zeichen, keine Sonderzeichen, ...)
//          --> y = Beschreibung der Tabelle: Alphanummerische Zeichen, Kurzbeschrieb des Zwecks
//          --> z = Die Attribute der Tabelle, Format:
//                  array('name'=>a,'typ'=>b,'laenge'=>c,'zusatz'=>d,'null'=>e,'default'=>f,'extra'=>g,
//                        'primary'=>h,'index'=>i,'unique'=>j,'volltext'=>k,'beschreibung'=>l)
//                  --> a = Name des Attributs: (Alphanummerische Zeichen, siehe reservierte Woerter von MySQL)
//                  --> b = Typ: Datentyp dieses Tabellenattributs (z.B. int, varchar, text, ...)
//                  --> c = Laenge: Positive Integerzahl oder leer lassen (manchmal auch als maxlength interpretiert)
//                  --> d = Zusatz: '' | 'BINARY' | 'UNSIGNED' | 'UNSIGNED ZEROFILL'
//                  --> e = Null Setting: 'NULL | 'NOT NULL'
//                  --> f = Default: Defaultwert bei Neuerstellung in einer Zeile (max. Zeichenlaenge = 255)
//                  --> g = Extra: '' | 'auto_increment'
//                  --> h = Primary: '0' = ist NICHT Primary Key | '1' = IST Primary Key
//                  --> i = Index: '0' = Nein | '1' = Ja
//                  --> j = Unique: '0' = Nein | '1' = Ja
//                  --> k = Volltext Index: '0' = Nein | '1' = Ja (nicht bei allen Typen moeglich)
//                  --> l = Beschreibung: Wird nur hier und im Modulprozess verwendet (max. Chars = 255)
// Beschreibung der ersten eigenen Tabelle:
$moduldef['eigene_tabellen'][0]['table_name'] = 'counts';
$moduldef['eigene_tabellen'][0]['table_beschreibung'] = 'Enthaelt die Counter aller Interfaces';
// Attribut 1 der Tabelle:
$moduldef['eigene_tabellen'][0]['attribute'][0]['name'] = 'count_id';
$moduldef['eigene_tabellen'][0]['attribute'][0]['typ'] = 'int';
$moduldef['eigene_tabellen'][0]['attribute'][0]['laenge'] = '11';
$moduldef['eigene_tabellen'][0]['attribute'][0]['zusatz'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][0]['null'] = 'NOT NULL';
$moduldef['eigene_tabellen'][0]['attribute'][0]['default'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][0]['extra'] = 'auto_increment';
$moduldef['eigene_tabellen'][0]['attribute'][0]['primary'] = '1';
$moduldef['eigene_tabellen'][0]['attribute'][0]['index'] = '1';
$moduldef['eigene_tabellen'][0]['attribute'][0]['unique'] = '1';
$moduldef['eigene_tabellen'][0]['attribute'][0]['volltext'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][0]['beschreibung'] = 'Primary Key';
// Attribut 2 der Tabelle:
$moduldef['eigene_tabellen'][0]['attribute'][1]['name'] = 'interface_name';
$moduldef['eigene_tabellen'][0]['attribute'][1]['typ'] = 'varchar';
$moduldef['eigene_tabellen'][0]['attribute'][1]['laenge'] = '255';
$moduldef['eigene_tabellen'][0]['attribute'][1]['zusatz'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][1]['null'] = 'NOT NULL';
$moduldef['eigene_tabellen'][0]['attribute'][1]['default'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][1]['extra'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][1]['primary'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][1]['index'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][1]['unique'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][1]['volltext'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][1]['beschreibung'] = 'Namen des Interfaces';
// Attribut 3 der Tabelle:
$moduldef['eigene_tabellen'][0]['attribute'][2]['name'] = 'fk_interface_id';
$moduldef['eigene_tabellen'][0]['attribute'][2]['typ'] = 'int';
$moduldef['eigene_tabellen'][0]['attribute'][2]['laenge'] = '11';
$moduldef['eigene_tabellen'][0]['attribute'][2]['zusatz'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][2]['null'] = 'NOT NULL';
$moduldef['eigene_tabellen'][0]['attribute'][2]['default'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][2]['extra'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][2]['primary'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][2]['index'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][2]['unique'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][2]['volltext'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][2]['beschreibung'] = 'Interface_ID des Interfaces';
// Attribut 4 der Tabelle:
$moduldef['eigene_tabellen'][0]['attribute'][3]['name'] = 'counts';
$moduldef['eigene_tabellen'][0]['attribute'][3]['typ'] = 'int';
$moduldef['eigene_tabellen'][0]['attribute'][3]['laenge'] = '11';
$moduldef['eigene_tabellen'][0]['attribute'][3]['zusatz'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][3]['null'] = 'NOT NULL';
$moduldef['eigene_tabellen'][0]['attribute'][3]['default'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][3]['extra'] = '';
$moduldef['eigene_tabellen'][0]['attribute'][3]['primary'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][3]['index'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][3]['unique'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][3]['volltext'] = '0';
$moduldef['eigene_tabellen'][0]['attribute'][3]['beschreibung'] = 'Anzahl counts, wie oft dieses Interface schon aufgerufen wurde.';

// 14.) Zu erweiternde, schon bestehende Tabellen
//      ! Hier werden die Tabellen beschrieben, welche schon existieren und durch weitere Attribute
//        erweitert werden sollen.
//      ! Wenn keine Tabellen erweitert werden sollen, einfach leerer Array definieren
//      --> Format: Dasselbe Format wie bei $moduldef['eigene_tabellen']. Die Beschreibung
//                  einer schon bestehenden Tabelle wird ignoriert, der Name muss aber stimmen.
$moduldef['erweiterte_tabellen'] = array();

// 15.) Submodule
//      ! Wenn dieses Modul aus mehreren weiteren Modulen besteht, so koennen diese hier angegeben werden.
//      ! Wenn keine Submodule existieren, einfach einen leeren String angeben.  (Strichpunkt getrennte Liste)
//      --> Format: 'submodul_name_1;submodul_name2;...;submodul_namex'
$moduldef['submodule'] = '';

// 16.) Vorausgesetzte Module
//      ! Hier werden Module angegeben, welche korrekt installiert vorhanden sein muessen, damit dieses
//        Modul ueberhaupt erst installiert wird. (Strichpunkt getrennte Liste)
//      ! Wenn keine solchen Module gibt, einfach einen leeren String uebergeben
//      --> Format: 'required_modul_name_1;required_modul_name2;...;required_modul_namex'
$moduldef['required_modules'] = '';

// 17.) Security ID
//      ! Mit der Security_ID kann man dem Modul den Zugang zu verschiedenen Interfaces sperren.
//        Auf diese Weise kann ein kompromittiertes Modul nur begrenzt Schaden anrichten.
//      ! Die niedrigste Stufe der Security_ID ist = 1, die höchste Stufe = 32768. Je höher die
//        angegebene Security_ID ist, desto höher ist auch die Zahl der erlaubten Interfaces
//      ! Welches Interface, welche minimale Security_ID erfordert um benutzt werden zu koennen,
//        ist in der Tabelle module_interfaces mit den Interfaceeintraegen ersichtlich.
//      --> Format: 'required_modul_name_1;required_modul_name2;...;required_modul_namex'
$moduldef['security_id'] = '2';

// 18.) Valid Hosts
//      ! Erweiterte Security wird es in der naechsten API-Version noch mit der valid_hosts Angabe geben.
//        Die Datenbank ist dafuer schon vorbereitet. (all = Alle Hosts, im Moment die Standardeinstellung)
//        Ausgewertet wird die Angabe aber noch nicht.
//      --> Format: all = Alle hosts | localhost = nur dieser Rechner | mehrere Rechner via ; getrennt angeben
$moduldef['valid_hosts'] = 'all';

// 19.) Name des Administrationsmenus
//      ! Im Administrationstool hat das Verwaltungsmenu dieses Moduls einen Namen, hier kann man
//        einen Namen definieren, wenn man keinen angibt, wird einfach die Modulbezeichnung verwendet
//      --> Format: Maximale Laenge 40 Zeichen, moeglichst keine Sonderzeichen verwenden
$moduldef['admin_menu_name'] = 'Interface Counter verwalten';

// 20.) URL zur Datei, wo das Admin-Verwaltungsmenu liegt
//      ! Diese URL ist entweder absolut oder (besser) relativ zum {shopdir}/shop/Admin/module/modul_name Verzeichnis
//        Die hier angegebene Datei wird 'verlinkt' und mit dem in 'admin_menu_name' Namen versehen.
//        Info: Achtung: Jeder Link in dieser Datei muss folgende GET-Parameter mitgeben:
//        - darstellen=".$HTTP_GET_VARS['darstellen']
//        - installed_selection=".$HTTP_GET_VARS['installed_selection']
//        - backlink=".$HTTP_GET_VARS['backlink']
//      --> Format: URL
$moduldef['admin_menu_link'] = 'show_interface_counter.php';

// 21.) URL zum Icon des Adminmenus
//      ! Diese URL ist relativ zum {shopdir}/shop/Admin/ Verzeichnis (sonst gibt es einen include-Fehler
//        Die hier angegebene Datei wird 'verlinkt' und mit dem in 'admin_menu_name' Namen versehen.
//      --> Format: URL
//      --> Format Icon: 48px x 48px, GIF oder PNG oder JPG.

$moduldef['admin_menu_img'] = 'modul_admin_img.gif';

// 22.) Pruefung, ob das Modul vorhanden ist
//      ! Hier wird zumeist mit einem modul_check Aufruf geprueft, ob dieses Modul verfuegbar ist. Das dritte Argument
//        sollte auf false (Boolean) gesetzt werden, so dass kein Include des Moduls gemacht wird.
//      --> Format: Boolean (true | false)
$moduldef['is_available'] = modul_check('Admin/module/persistent_interface_counter/show_interface_counter.php','',false,false);

// --------------------------------------------------------------------------------------
// ***************************** ENDE DEFINITION DES MODULS *****************************
// --------------------------------------------------------------------------------------

<?php
// Folgende Methode wird bei einer Deinstallation eines externen PepperShop
// Moduls automatisch aufgerufen, wenn die Deinstallation gestartet wurde.
// ACHTUNG: Die Rueckgabe wird vom Modulsystem ausgewertet. Bei false wird
// der Deinstallationsprozess unterbrochen!
// Argumente: &$module (Referenz auf ein Module Objekt)
// Rueckgabe: true | false (Boolean)
function deinstall_peppershop_module(&$module) {
    // Rueckgabewert initialisieren
    $result = true;

    // Hier koennen z.B. noch Aufraeumarbeiten durchgefuehrt werden...

    return $result;
}// End function deinstall_peppershop_module

CREATE TABLE module_mainmodule
(
    modul_id INT(11) NOT NULL AUTO_INCREMENT,
    name CHAR(255) NOT NULL DEFAULT 'undefined',  # /* Entspricht auch dem Ordner des Moduls */
    bezeichnung VARCHAR(255) NOT NULL DEFAULT 'undefined',
    beschreibung TEXT NOT NULL,
    version CHAR(32) NOT NULL DEFAULT 'undefined',
    version_check INT(11) NOT NULL DEFAULT 0, # /* Int. um aelter als ... zu bestimmen*/
    submodule_of VARCHAR(255) NOT NULL DEFAULT '',
    entwickler VARCHAR(255) NOT NULL DEFAULT 'undefined', # /* Name | Firma | E-Mail | Page | ... */
    weitere_infos_link varchar(255) NOT NULL default '',
    release_date VARCHAR(255) NOT NULL DEFAULT '01.01.1970', # /* Veroeffentlichungsdatum des Moduls */
    security_id INT(11) NOT NULL DEFAULT 0, # /* Security Level des Moduls */
    fingerprint CHAR(255) NOT NULL DEFAULT 'undefined', # /* md5-Hash der Dateien | Link zum hash */
    valid_host_systems VARCHAR(255) NOT NULL DEFAULT 'all', # /* Fuer welche Systemvers. zugelassen. Delimiter ;*/
    admin_menu_name VARCHAR(255) NOT NULL DEFAULT 'undefined',
    admin_menu_link VARCHAR(255) NOT NULL DEFAULT 'undefined',
    admin_menu_icon_link VARCHAR(255) NOT NULL DEFAULT 'undefined',
    install_status VARCHAR(255) NOT NULL DEFAULT 'undefined',
    PRIMARY KEY (modul_id),
    UNIQUE UC_modul_id (modul_id),
    INDEX IDX_modul_id_1 (modul_id),
    UNIQUE UC_name (name),
    INDEX IDX_name_1 (name)
);

CREATE TABLE module_submodule
(
    submodul_id INT(11) NOT NULL AUTO_INCREMENT,
    fk_modul_id INT(11) NOT NULL DEFAULT 0, # /* Fremdschluessel aus Tabelle module_module */
    name CHAR(255) NOT NULL DEFAULT 'undefined', # /* Kopie - vereinfacht SQL-Abfragen */
    zweck TEXT NOT NULL, # /* Beschreibung: Wieso dieses Modul benoetigt wird */
    PRIMARY KEY (submodul_id),
    UNIQUE UC_submodul_id (submodul_id),
    INDEX IDX_submodul_id_1 (submodul_id)
);

CREATE TABLE module_requiredmodule
(
    required_modul_id INT(11) NOT NULL AUTO_INCREMENT,
    fk_modul_id_braucht INT(11) NOT NULL DEFAULT 0, # /* referenziert das Modul, welches ein weiteres benoetigt */
    fk_modul_id_hat INT(11) NOT NULL DEFAULT 0, # /* referenziert das benoetigte Modul */
    name CHAR(255) NOT NULL DEFAULT 'undefined', # /* Kopie: Name des benoetigten Moduls - vereinfacht SQL-Abfragen */
    zweck TEXT NOT NULL, # /* Beschreibung: Wieso dieses Modul benoetigt wird */
    PRIMARY KEY (required_modul_id),
    UNIQUE UC_required_modul_id (required_modul_id),
    INDEX IDX_required_modul_id_1 (required_modul_id)
);

CREATE TABLE module_interfaces
(
    interface_id INT(11) NOT NULL AUTO_INCREMENT,
    interface_name CHAR(255) NOT NULL DEFAULT 'undefined',
    typ ENUM('intern','extern','modul') NOT NULL DEFAULT 'intern', # /* Typ des Interfaces */
    beschreibung TEXT NOT NULL,
    security_id INT(11) NOT NULL DEFAULT 0, # /* Security Level des Interfaces */
    PRIMARY KEY (interface_id),
    UNIQUE UC_interface_id (interface_id),
    INDEX IDX_interface_id_1 (interface_id)
);

CREATE TABLE module_interfaces_module
(
    interface_modul_id INT(11) NOT NULL AUTO_INCREMENT,
    fk_interface_id INT(11) NOT NULL DEFAULT 0, # /* Fremdschluessel: Tabelle module_interfaces */
    fk_modul_id INT(11) NOT NULL DEFAULT 0, # /* Fremdschluessel: Tabelle module_mainmodule */
    position INT(11) NOT NULL DEFAULT 0,
    function_name VARCHAR(255) NOT NULL DEFAULT '',
    file_name VARCHAR(255) NOT NULL DEFAULT '',
    filtertyp ENUM('one_way','filter') NOT NULL DEFAULT 'filter', # /* Wie das Interface benutzt wird */
    PRIMARY KEY (interface_modul_id),
    UNIQUE UC_interface_modul_id (interface_modul_id),
    INDEX IDX_interface_modul_id_1 (interface_modul_id)
);

CREATE TABLE module_locale
(
    fk_module_id INT(11) NOT NULL,
    fk_locale_id INT(11) NOT NULL,
    PRIMARY KEY (fk_module_id, fk_locale_id),
    INDEX (fk_module_id, fk_locale_id)
);

# /* Insert der Modulinterfaces */

INSERT INTO module_interfaces (interface_id, interface_name, typ, beschreibung, security_id)
    VALUES (1, 'artikelobj_vor_artikel_ausgabe', 'intern',
    'Liefert ein Artikelobjekt vor dem Anzeigen im Content-Frame.', 1
);

INSERT INTO module_interfaces (interface_id, interface_name, typ, beschreibung, security_id)
    VALUES (2, 'bestellungsobj_nach_erfolgreicher_bestellung', 'intern',
    'Liefert ein Bestellungsobjekt nach dem Abschliessen einer erfolgreich verarbeiteten Bestellung.', 2
);

# /* INSERT Statements des Testmoduls Persistent Interface Counter */

INSERT INTO module_mainmodule (modul_id, name, subfolder, version, version_check, entwickler,
    release_date, beschreibung, security_id, fingerprint, valid_host_systems, admin_menu_name,
    admin_menu_link, admin_menu_icon_link)
    VALUES (1, 'Interface Counter', 'persistent_interface_counter', '0.1', 1,
    'José Fontanil <fontajos@peppershop.com>, PepperShop Projekt http://www.peppershop.com',
    '2003-09-09', 'Dieses Modul zählt die Aufrufe der einzelnen Interfaces.', 0, 'undefined',
    'all', 'Interface Counter', 'show_interface_counter.php', 'modul_admin_img.gif'
);

INSERT INTO module_interfaces (interface_id, interface_name, typ, beschreibung, security_id)
    VALUES (1, 'artikelobj_vor_artikel_ausgabe', 'intern',
    'Liefert ein Artikelobjekt vor dem Anzeigen im Content-Frame.', 0
);

INSERT INTO module_v_interfaces_module (interface_modul_id, fk_interface_id, fk_modul_id, position,
    function_name, file_name, filtertyp)
    VALUES (1, 1, 1, 0, 'update_interface_counter', 'update_interface_counter.php', 'one_way'
);

INSERT INTO module_tabellen (modul_tabelle_id, name, beschreibung)
    VALUES (1, 'persistent_interface_counter_counts', 'Enthält die Interface Counterstände.'
);

INSERT INTO module_tabellen_attribute (modul_tabellen_attribut_id, fk_modul_tabelle_id, name,
    typ_name, typ_laenge_set, typ_attribut, typ_null, typ_default, typ_extra, typ_primary,
    typ_index, typ_unique, typ_volltext, beschreibung)
    VALUES (1, 1, 'count_id', 'int', '11', '', 'NOT NULL', '', 'auto_increment', '1', '1', '1', '0', 'Primary Key'
);
INSERT INTO module_tabellen_attribute (modul_tabellen_attribut_id, fk_modul_tabelle_id, name,
    typ_name, typ_laenge_set, typ_attribut, typ_null, typ_default, typ_extra, typ_primary,
    typ_index, typ_unique, typ_volltext, beschreibung)
    VALUES (2, 1, 'interface_name', 'varchar', '255', '', 'NOT NULL', '', '', '0', '0', '0', '0', 'Namen des Interfaces'
);
INSERT INTO module_tabellen_attribute (modul_tabellen_attribut_id, fk_modul_tabelle_id, name,
    typ_name, typ_laenge_set, typ_attribut, typ_null, typ_default, typ_extra, typ_primary,
    typ_index, typ_unique, typ_volltext, beschreibung)
    VALUES (3, 1, 'fk_interface_id', 'int', '11', '', 'NOT NULL', '', '', '0', '0', '0', '0', 'Interface-ID des Interfaces'
);
INSERT INTO module_tabellen_attribute (modul_tabellen_attribut_id, fk_modul_tabelle_id, name,
    typ_name, typ_laenge_set, typ_attribut, typ_null, typ_default, typ_extra, typ_primary,
    typ_index, typ_unique, typ_volltext, beschreibung)
    VALUES (4, 1, 'counts', 'int', '11', '', 'NOT NULL', '0', '', '0', '0', '0', '0', 'Anzahl counts, wie oft dieses Interface schon
            aufgerufen wurde'
);

# /* Anlegen der von Persistent Interface Counter benoetigten Tabelle (sollte sonst bei der Installation des Moduls gemacht werden */

CREATE TABLE persistent_interface_counter_counts
(
    count_id INT(11) NOT NULL AUTO_INCREMENT,
    fk_interface_id INT(11) NOT NULL DEFAULT 0,
    interface_name VARCHAR(255) NOT NULL DEFAULT '',
    counts INT(11) NOT NULL DEFAULT 0,
    PRIMARY KEY (count_id),
    UNIQUE UC_count_id (count_id),
    INDEX IDX_count_id_1 (count_id),
    INDEX IDX_fk_interface_id_2 (fk_interface_id)
);