Module verwenden

Die Verwendung von Modulen ist innerhalb von Templates und auch innerhalb von PHP-Sourcen denkbar einfach.

Sowohl in Templates als auch in Modulen kann an jeder gewünschten Stelle jedes Modul aufgerufen werden. Der Aufruf wird dann automatisch mit dem Inhalt des aufgerufenden Moduls ersetzt.

Beispiel:

Sie möchten das Login Formular innerhalb Ihrer eigenen Anwendung anzeigen.

• Aufruf über das Einfügen vom Modulaufruf im Content Ihrer Modulausgabe oder innerhalb eines Templates
  Fügen Sie einfach an der gewünschten Position innerhalb Ihrer Modulausgabe den Aufruf
  [modul=dbx_login]op=login[/modul] ein
  .
• Aufruf der Modul-Funktion in Ihrem PHP-Source (rmf = run modul function)
  $my_content=dbx_rmf("dbx_login",login);
  return $my_content;
  .
• Integration des kompletten Moduls in Ihrem eigenen Modul
  $obj=dbx_get_modul_object("dbx_login");
  $my_content=$obj->login();
  return $my_content;

Alle 3 Vorgehensweisen rufen jeweils vom Modul dbx_login die Funktion login() in der PHP-Class dbx_login auf.
Die benötigten Sourcen vom Modul werden dabei automatisch includiert.

Das Ergebnis ist dabei jeweils das Eingabeformular für den Benutzer-Login.

Wichtige Information:

Da alle Content-Seite voll gecahed werden sind alle Modulaufrufe die innerhalb von Content-Seiten stehen automatisch statisch.
Das ist bei vielen Modulen, wie z.B dem Login-Formular oder auch für das Eintragen in den NewsLetter Verteiler problemlos, da die jeweilige Modulausgabe keine dynamischen Daten benötigt, oder diese via AJAX bearbeitet.

Wenn Sie innerhalb vom Content einen dynamischen Modulaufruf benötigen, z.B eine zufällige Auswahl von Top-News, dann ist der Modulaufruf geringfügig anders.

Der Aufruf:
[modul=dbx_news]op=random[/modul]
würde seine Ausgabe in den Cache mit übertragen und so immer die gleichen "zufälligen" News anzeigen.

Mit dem Aufruf:
[:modul=dbx_news]op=random[/modul]
wird nur der Aufruf, nicht dessen Rückgabe (Auswertung), in den Cache übertragen. Dadurch zeigt das System dann bei jedem Aufruf der entsprechenden Content-Seite tatsächlich immer verschiedene zufällig ausgewählte News an.




* Der Modulaufruf [modul=dbx_login]op=login[/modul] wird hier nicht ausgewertet da nach dem [ im Content ein - steht.
Durch den Ausgabefilter werden aber alle [- und alle {- jeweils durch [ b.z.w. { ersetzt.