ActiveUpdate-Homepage :: Dokumentation :: Dateien :: Template-Dateien

Was steckt dahinter?

Das grundlegende ActiveUpdate-Konzept ist ganz einfach: über die CGI-Argumente führt man eine Abfrage aus, die Ergebnisse werden mit den Template-Dateien "zusammengemischt", und daraus entsteht dann ein Layout mit Inhalt.

Im Einzelnen läuft das so ab: wenn ActiveUpdate einen Datensatz gefunden hat, der ausgegeben werden soll, dann lässt es den durch die Output-Funktion laufen. Diese Funktion öffnet die angegebene Template-Datei (siehe Abschnitt zu den CGI-Argumenten unter "Interface") und lädt sie in den Speicher.

Datenfelder...

Danach geht es so weiter, dass ActiveUpdate nach Datenfeldnamen in der Datei sucht und diese dann durch den aktuellen Wert des Datenfeldes im auszugebenden Datensatz ersetzt. Damit es nicht zu zufälligen Ersetzungen kommt, muss dem Datenfeldnamen in der Datei ein "ACUP4" vorangestellt werden.

Also, ein Beispiel: wenn ein Datenfeld (BTW, die Datenfeldnamen stehen in der ersten nicht auskommentierten Zeile der index.dat und in der ddf.dat) zum Beispiel "Spielname" heißt, dieses Datenfeld im aktuellen Datensatz den Wert "Command & Conquer" hat und die Template-Datei folgendermaßen aussieht:

<b>ACUP4Spielname</b>

,dann kommt hinterher das dabei raus:

<b>Command & Conquer</b>

Ist doch eigentlich alles total easy, oder? ;-)

BTW, wenn Sie das alles nicht verstanden haben, weil Sie nicht genau wissen, was Datenfelder und Datenfeldnamen überhaupt sind, dann sollten Sie sich den Dokumentations-Artikel "Was ist eine Datenbank?" durchlesen - danach sieht alles ganz anders aus :)

Zusammenfassung: ActiveUpdate sucht in der aktuellen Datei nach "ACUP4"+Datenfeldname und ersetzt das durch den Wert von Datenfeld.

PlugIns...

Um die Ausgabefunktionen etwas flexibler zu gestalten, haben wir PlugIns eingeführt. Doch mehr dazu in anderen Abschnitten der Dokumentation.

Wichtig hier ist jedenfalls nur, wie man die Ausgaben von PlugIns einbindet:

ACUP4PLUGIN-ARGUMENTE-ACUP4STOPPLUGIN

Wichtig ist hierbei, dass "PLUGIN" im obigen Beispiel durch den Namen des PlugIns ersetzt werden muss. Wenn das PlugIn also z.B. "NEWS" heißt und man als Argument "ShowNewsPage" übergeben will, sollte das so aussehen:

ACUP4NEWS-ShowNewsPage-ACUP4STOPNEWS

SSI...

ActiveUpdate kann SSI parsen. Dabei ist es nur wichtig, darauf zu achten, dass am Anfang der SSI keinerlei Leerzeichen gesetzt werden. Weiterhin muss in der einstellungen.dat der richtige Pfad als Grundverzeichnis gesetzt werden, von dem beim Parsen ausgegangen wird.

Spezialstrings...

Es gibt einige besondere Zeichenfolgen, die werden vom Parser durch etwas ersetzt, obwohl sie mit Datenfeldern, SSI oder PlugIns nichts zu tun haben. Viele dieser Zeichenfolgen hängen mit Einstellungen in der einstellungen.dat zusammen. Wir gehen hier von den Standardeinstellungen aus. Hier die tabellarische Übersicht: