vtInclude
(Basic, Pro, Master ab 1.3)
Gibt den Inhalt einer externen Textdatei aus.
Verwendung
{{vtInclude: %Pfad}}
{{vtInclude: %Pfadliste }}- %Pfad
Pfad zur Templatedatei. Wenn die Pfadangabe mit einem Schrägstrich beginnt, wird sie relativ zum Virthos-Verzeichnis interpretiert, ansonsten relativ zu dem Verzeichnis, in dem sich das aktuelle Template befindet.
- %Pfadliste
(verfügbar ab Version 3.8) Kommagetrennte Liste von Dateipfaden. Die erste tatsächlich existierende Templatedatei wird verwendet.
Hinweise
Mit vtInclude lassen sich HTML-Blöcke, die in mehreren Templates benötigt
werden (zum Beispiel Header und Footer, Navigationselemente o. ä.), in
eigenständige Dateien auslagern. Dadurch werden die Templates übersichtlicher
und lassen sich leichter pflegen.
Eine mittels vtInclude eingebundene Datei darf VirthosTalk-Platzhalter oder
-Anweisungen und auch weitere vtInclude-Platzhalter enthalten.
Bis v4.0.9 wurden relative Pfade innerhalb einer eingebundenen Datei von dem
Paketverzeichnis aus aufgelöst, in dem sich das Template der ursprünglich
aufgerufenen Seite befindet. Ab v4.1.0 werden relative Pfade immer von dem
Paketverzeichnis aus aufgelöst, zu dem die eingebundene Datei gehört (sofern
die Datei zu einem Template-Paket gehört). Dies betrifft relative Verweise auf
Ressourcen (Bilder, Stylesheets etc.), aber auch relative Pfade in weiteren
vtInclude-Anweisungen.
Beispiele
<html>
<head>
<title>{{Seitentitel}}</title>
{{vtInclude: includes/metadata.html }}
</head>
...
<!--{{vtSet: Text = "{vtInclude:mails/confirmation.txt}" }}-->
<!--{{vtDo: -act="mail", -subject="Bestätigung", -message="{vtGet:Text}" }}-->