Template Class

Template Objekt erstellen

Um Templates zu benutzen, muss zuerst ein Template-Objekt erstellt werden:

$tpl = new template('case');

Dabei ist "case" das erste Template welches aus "templates/case.tpl" eingebunden wird.

Variablen zu diesem Objekt hinzufügen

Es gibt in der Regel 2 Typen von Variablen; Sprachstrings und normale Variablen. Normale Variablen werden in den Templates mit {$Variablenname} erzeugt. Sprachstrings werden wie folgt erzeugt: {lang=com.sbb.xxx.xxx}; näheres zum Aufbau wird in der Language Klasse erklärt.

---

Eine Variable oder ein Array von Variablen wird wie folgt hinzugefügt:

• Eine Variable:

$tpl->Assign('Variablenname', 'Variablenwert');

• Mehrere Variablen:

$tpl->Assign(array('String' => 'Wert der ersten Variable',
'Test' => true,
'Zahl' => 42));

---

Ein Sprachstring oder ein Array von Sprachstrings wird wie folgt hinzugefügt:

• Eine Variable:

$tpl->AssignLanguage('com.sbb.xxx.xxx', 'String in einer Sprache');

• Mehrere Variablen:

$tpl->AssignLanguage(array('com.sbb.welcome.title' => 'Hallo',
'com.sbb.welcome.message' => 'du',
'com.sbb.welcome.message' => 'da'));

Diese Aufgabe übernimmt allerdings die Language Klasse, welche ebenfalls die richtige Sprachdatei heraussucht.

---

Das Template ausgeben

Um das Template zu Parsen und anschließend auszugeben muss die Klassenfunktion Display($return = false, $Debug = false) aufgerufen werden, diese wird folgender maßen benutzt:

$tpl->Display();

Wird der erste Parameter auf true gesetzt, so gibt die Funktion das Template nicht aus sondern als String zurück. Wenn der 2. Parameter auf true gesetzt wird, werden Fehler beim Parsen nicht ignoriert und angezeigt.