Welcompose verfügt über etliche von vordefinierten Vorlagentypen, doch welcher Vorlagen-Typ wird für welche Ansicht benötigt?

Die Spalte "Vorlagen-Typ", listet die jeweiligen Vorlagentypen, wie sie standardmässig von Welcompose mitgebracht werden. Eine kurze Erklärung des Einsatzzwecks bietet die Spalte mit der Beschreibung. In der Spalte "Seitentyp" steht, zu welchem Seitentyp der Vorlagen-Typ gehört. Die letzte Spalte "URL-Action" listet den jeweiligen Wert für den Parameter action im URL zum Seitenaufruf, der diesen Vorlagen-Typ verlangt. Mit seiner Hilfe lässt sich herausfinden, welche Vorlage für einen bestimmten Seiten-URL geladen wird.

Bei einem URL wie

index.php?project_name=demo&action=ArchiveMonth&posting_year_added=2007&posting_month_added=06

ist der Wert für action ArchiveMonth, der, wie die Tabelle zeigt, die Verwendung einer Vorlage vom Typ blog_archive_month impliziert.

Bei der URL-Action Index, die mehreren Vorlagentypen zugeordnet ist, kann man nicht nur nach der URL-Action gehen, sondern muss gleichzeitig noch den jeweiligen Seitentyp einbeziehen, um den richtigen Vorlagen-Typ zu einem URL zu finden. Handelt es sich um eine Blog-Seite, die aufgerufen wird, wird eine Vorlage vom Typ blog_index benötigt. Handelt es sich um eine Simple Page, wird eine Vorlage vom Typ simple_page_index benötigt.

Wie in Abschnitt 7.2, „Funktionsweise des Vorlagensystems“ bereits erwähnt, benötigt Welcompose zwei Informationen, um die richtige Vorlage für die Anzeige einer Seite auszuwählen:

Mit Hilfe der Seiten-ID weiss Welcompose, in welchem Vorlagengruppe nach der Vorlage gesucht werden muss. Und der Vorlagen-Typ sagt Welcompose schlussendlich, welche Vorlage aus dem Vorlagengruppe genommen werden muss.

Wenn man also irgendwo innerhalb einer Vorlage (bei {include}) oder innerhalb von PHP-Code (bei den Smarty-Methoden fetch() und display()) eine Vorlage von Smarty anfordert, müssen diese zwei Informationen angegeben werden.

Dabei muss man ein spezielles Format einhalten. Einerseits muss ein sogenannter Resource Type (wcom:) angegeben werden, damit Smarty weiss, aus welcher Quelle die Vorlagen bezogen werden sollen. Andererseits müssen der Vorlagen-Typ und die Seiten-ID so zusammengesetzt werden, dass sich ein gültiger Vorlagen-Name ergibt. Daraus ergibt sich folgendes Format:

wcom:simple_page_index.7

Dabei ist wcom: der Resource Type und simple_page_index.7 der Vorlagen-Name, der sich aus dem Vorlagen-Typ simple_page_index und der Seiten-ID 7 zusammensetzt.

Am häufigsten werden Vorlagen wohl innerhalb von anderen Vorlagen angefordert. Ein einfaches Beispiel könnte etwa so aussehen:

{include file="wcom:custom_navigation.7"}

Auf diese Weise wird die Vorlage des Typs custom_navigation aus dem Vorlagengruppe ausgelesen, der mit der Seite mit der ID 7 verbunden ist. Allerdings wird kaum einmal direkt mit den Seiten-IDs gearbeitet, da die Vorlagen ja für möglichst viele Seiten einsetzbar sein sollen. Da bietet es sich an, die Seiten-ID durch eine Variable auf die jeweils aktuelle Seiten-ID setzen zu lassen. Alle Seiten respektive Ansichten innerhalb von Welcompose bieten zu diesem Zweck die Variable $page.id, welche immer die ID der jeweils aktuellen Seite enthält. Die universelle Variante von {include file="wcom:custom_navigation.7"} würde damit so aussehen:

{include file="wcom:custom_navigation.`$page.id`"}

(siehe auch Abschnitt 7.5.3.3, „Vorlagen in Vorlagen integrieren“)

Die meisten Vorlagen, die man für eine Webseite benutzt, haben grössere oder kleinere Teile gemeinsam, die also in jeder Vorlage identisch sind. Ein Beispiel sind Navigationen. Statt sie in jeder Vorlage separat zu implementieren, wäre es viel praktischer, wenn man diese Fragmente nur einmal implementieren müsste und in jeder Vorlage, wo sie vorkommen, automatisch einbinden lassen könnte.

Smarty ermöglicht dies mittels sogenannten Includes, bei denen mit der Funktion {include} andere Vorlagen in die aktuelle Vorlage automatisch integriert werden können.

Um eine (Teil-)Vorlage zu erstellen, die mit Hilfe von {include} in eine andere Vorlage integriert werden kann, sind mehrere Schritte nötig:

Soll ein weiteres Fragment ausgelagert werden, ist dies problemlos möglich. Es muss einfach ein anderer Name für den Vorlagen-Typ gewählt werden. Soll beispielsweise ein Seiten-Fuss in einer separaten Vorlage untergebracht werden, würde sich beispielsweise der Name custom_footer anbieten. Entsprechend müsste auch die Referenz in {include} angepasst werden.