include (einbinden)Attribut NameTypErforderlichStandardwertBeschreibungfilestringJan/aName der Template-Datei, die eingebunden werden soll.assignstringNeinn/aVariable, welcher der eingebundene Inhalt zugewiesen werden soll.[var ...][var typ]Neinn/aVariablen welche dem Template lokal übergeben werden sollen.
Include Tags werden verwendet, um andere Templates in das aktuelle Template einzubinden.
Alle Variablen des aktuellen Templates sind auch im eingebundenen Template verfügbar.
Das include-Tag muss ein 'file' Attribut mit dem Pfad zum einzubindenden
Template enthalten.
Optional kann mit dem assign Attribut definiert werden,
in welcher Variable die Ausgabe des mit include eingebundenen
Templates abgelegt werden soll statt sie auszugeben.
function include (einbinden)
{include file="header.tpl"}
{* hier kommt der body des Templates *}
{include file="footer.tpl"}
Sie können dem einzubindenden Template Variablen
als Attribute übergeben. Alle explizit übergebenen
Variablen sind nur im Anwendungsbereich (scope) dieses Template
verfügbar. Attribut-Variablen überschreiben
aktuelle Template-Variablen, falls sie den gleichen Namen haben.
include-Funktion und Variablen Übergabe
{include file="header.tpl" title="Hauptmenu" table_bgcolor="#c0c0c0"}
{* hier kommt der body des Templates *}
{include file="footer.tpl" logo="http://my.domain.com/logo.gif"}
Benutzen sie die Syntax von template resources,
um Templates ausserhalb des '$template_dir' einzubinden:
Beispiele für Template-Ressourcen bei der 'include'-Funktion
{* absoluter Dateipfad *}
{include file="/usr/local/include/templates/header.tpl"}
{* absoluter Dateipfad (gleich) *}
{include file="file:/usr/local/include/templates/header.tpl"}
{* absoluter Dateipfad unter Windows ("file:"-Prefix MUSS übergeben werden) *}
{include file="file:C:/www/pub/templates/header.tpl"}
{* einbinden aus Template-Ressource namens 'db' *}
{include file="db:header.tpl"}