vtTemplate

(Basic, Pro, Master ab 3.0.1)

Löscht alle bisherigen Ausgabeanweisungen und gibt den Inhalt einer externen Textdatei aus.

Verwendung

{{vtTemplate: %Pfad}}

{{vtTemplate: %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

Der vtTemplate-Platzhalter arbeitet exakt so wie der vtInclude-Platzhalter, nur dass vor dem Einbinden der externen Datei alle vorherigen Ausgabeanweisungen gelöscht werden. Dies ist hilfreich bei Anwendungen, bei denen nicht einzelne Codeblöcke, sondern vollständige Seiten eingebunden werden sollen, um strikter zwischen der Zusammenstellung und der visuellen Aufbereitung der Inhalte zu trennen. Auf diese Weise können Sie zum Beispiel dem Endkunden die Möglichkeit geben, das Erscheinungsbild anzupassen, ohne dabei versehentlich die Funktionalität zu verändern.

Beachten Sie, dass Ausgabeanweisungen, die auf den vtTemplate-Platzhalter folgen, nicht unterdrückt werden. Deshalb sollte dieser Platzhalter in der Regel am Ende eines Templates stehen.

Beispiel

<!-- Inhalt der Datei templates/meyer/tpl/standard.html -->

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
    "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
    <title>{{vtGet:Title}}</title>
    {{vtGet:AdditionalHeaders}}
</head>
<body>

    {{vtInclude:Header}}

    <div id="content">
        {{vtGet:PageContent}}
    </div>

    {{vtInclude:Footer}}

</body>
</html>

<!-- Inhalt der Datei templates/meyer/beispiel.html -->

<!--{{vtSet: Title = "{Title:short}" }}-->

<!--{{vtCapture: AdditionalHeaders}}-->
    <meta name="robots" content="noindex,nofollow">
    <link rel="canonical" href="{{vtSelf}}?{{vtId}}">
<!--{{vtEndCapture}}-->

<!--{{vtCapture: PageContent}}-->
    <h1>{{Title:short}}</h1>
    {{Content:html,extended}}
<!--{{vtEndCapture}}-->

<!--{{vtCalc: file_exists( 'config/tpl/standard.html' ) ? 1 : 0 }}-->
<!--{{vtIf: {vtResult} .gt. 0 }}-->
    {{vtTemplate: /config/tpl/standard.html }}
<!--{{vtElse}}-->
    {{vtTemplate: tpl/standard.html }}
<!--{{vtEndIf}}-->

Siehe auch