Die Verwendung der Globalen Vorlagen soll anhand einer CSS-Datei illustriert werden, da dies auch ein gutes Beispiel ist, wo und wie eine Änderung des Delimiters notwendig ist.

Um die CSS-Datei als Globale Vorlage anzulegen, muss man zuerst zum Bereich Vorlagen und dort zum Unterpunkt Globale Vorlagen wechseln. Sobald man dort auf den Link Neu anlegen geklickt hat, kommt man zum Formular zum Anlegen einer Globalen Vorlage.

Machen Sie nun die folgenden Eingaben, um das Beispiel nachzuvollziehen (nicht aufgeführte Felder können Sie ignorieren):

Ihre Globale Vorlage sollte nun so aussehen:

Wenn Sie die Vorlage jetzt speichern und die Datei direkt im Browser aufrufen (passen Sie den Pfad zur global_template.php entsprechend ihrem Installationpfad an. Die global_template.php liegt immer im Root Ihrer Installation).

http://pfad/der/installation/global_template.php?name=beispiel.css

wird ihnen, abhängig vom der Konfiguration des Loggins (siehe Abschnitt 13.1.2.2, „Direkte Ausgabe“) ein Fehler angezeigt oder sie erhalten eine weiße, leere Seite.

Dieser Fehler wird dadurch verursacht, dass Smarty die geschweiften Klammern, die zur CSS-Syntax gehören, als Befehle interpretiert und auszuführen versucht.

Um diesen Fehler zu beheben/verhindern, setzt man bei Delimiter ändern einen Haken. Sobald man dies tut und die Datei wieder im Browser lädt, sollte der CSS-Code ganz ohne Modifikationen angezeigt werden, wie er eingegeben wurde.

Würde man nun die CSS-Datei in eine HTML-Seite einbetten, würde das Hintergrund-Bild allerdings nicht angezeigt werden, da wir zuvor noch den Pfad zur Datei einfügen müssen.

Entfernen Sie nun den Verweis zur container-bg.gif aus der Globalen Vorlage und lassen Sie den Cursor dort stehen, wo der Bildname war. Klicken Sie nun über der Textarea, in der der CSS-Code steht, auf Globale Dateien und wählen dort die oben angesprochene container-bg.gif Datei aus. Datei aus.

Anstelle des einfachen Dateinamens steht nun in der Vorlage ein Smarty-Befehl, der beim Aufbereiten der CSS-Datei den Platzhalter durch den effektiven Dateinamen zur Globalen Datei und damit dem Hintergrundbild ersetzt:

#container {
	position: relative;
	margin: 0 auto;
	width: 993px;
	background: #fff url(<%global_file name="container-bg.gif"%>) top right no-repeat;
	text-align: left;
}

Speichern Sie nun die Globale Vorlage und rufen Sie sie wieder wie zuvor im Browser direkt auf, sollten Sie statt den Smarty-Befehl nun den korrekten Pfad zur Globalen Datei sehen.

Würden Sie nun die CSS-Datei in eine HTML-Datei einbinden, würde das Bild korrekt erscheinen. Wie das Referenzieren der Globalen Vorlage in einer Vorlage funktioniert, erklärt Abschnitt 7.6.3.2, „Globale Vorlagen referenzieren“.

Globale Vorlagen können sowohl in anderen Globalen Vorlagen als auch in normalen Vorlagen referenziert werden. Die Referenzen werden in Form einer Smarty-Funktion eingesetzt, welche bei der Verarbeitung der Seite durch den realen Pfad zur Globalen Vorlage ersetzt wird. So wird aus

{global_template name="beispiel.css"}

beispielsweise der Pfad

/pfad/der/installation/global_template.php?name=beispiel.css

Die Globalen Vorlagen können damit zum Beispiel in @import-Anweisungen in CSS-Dateien oder als src- oder href-Attribut in verschiedenen HTML-Tags verwendet werden. Beispiel:

<link rel="stylesheet" href="{global_template name="beispiel.css"}"
	type="text/css" media="screen, projection" />

wird zu

<link rel="stylesheet" href="/pfad/der/installation/global_template.php?name=beispiel.css"
	type="text/css" media="screen, projection" />

Die Smarty-Funktion zur Einbindung der Globalen Vorlagen muss man nicht selber schreiben, sondern kann man sie von einer Hilfsfunktion einsetzen lassen, die jeweils über den Eingabefeldern für die Vorlagen-Inhalte lokalisiert sind. Über ein Pop-up lässt sich die gewünschte Globale Vorlage auswählen. Die Smarty-Funktion zur Einbindung der Globalen Vorlage generiert die adäquate Syntax und setzt diese an der Stelle des zuvor gesetzten Cursors ein.