16.03.2008

MODx-Feature:
Dokumente erweitern mit Template-Variablen

Themen: MODx, Template Variable | zuletzt bearbeitet: 31.07.2009

zur Übersicht 8 Kommentare von Bogdan

Eines der für mich interessantesten Features an MODx ist die Möglichkeit MODx-Dokumente mit so genannten Template-Variablen zu erweitern. Auf diese Weise kann man in einem Dokument nicht nur wie gewohnt Inhalt, Titel und eine Hand voll Meta-Angaben sichern, sondern beliebig viele weitere Informationen in unterschiedlichen Formaten. Die Anwendungsmöglichkeiten sind sehr vielfältig:

• Preise für Produkte
• Bilder oder Dateien, die mit dem Dokument verknüpft werden sollen
• Stichworte für Blog-Einträge
• weitere Dokument-Textinhalte neben dem Haupttext
• …

Template-Variablen bearbeiten

Werfen wir mal einen Blick auf ein Dokument mit Template-Variablen:

Die Template-Variablen werden den Standard-Dokumentinhalten hinzugefügt und können beim Editieren des entsprechenden Dokuments ebenfalls bearbeitet werden.

Template-Variablen erstellen

Relativ einfach ist auch das anlegen von Template-Variablen:

Template-spezifische Zuweisung

Template-Variablen heißen übrigens deswegen Template Variablen, weil diese jedem angelegten Template einzeln zugewiesen werden können. Somit kann man zum Beispiel einem Template Artikel die Template-Variablen Preis und Bild Kopfbereich und einem Template Blog-Eintrag die Template-Variablen Tags und ebenfalls Bild Kopfbereich zuweisen. Auf diese Weise lassen sich die Template-Variablen passend zum Inhalt eines Templates gruppieren.

Einsetzen von Template-Variablen

Das Einsetzen einer Template-Variable im HTML-Quelltext oder im Dokumentinhalt erfolgt über einen MODx-Tag: [*tv-name*]:

<h2>Blog-Einträge</h2>
<ul>
   <li>[*pagetitle*]</li>
   <li>[*introtext]</li>
   <li>[*tags*]</li>
</ul>

In diesem einfachen Beispiel werden Titel, Zusammenfassung und Tags für einen Blog-Eintrag dargestellt, wobei [*pagetitle*] und [*introtext*] dokument-spezifische Template-Variablen sind und nur [*tags*] hinzugefügt wurde.

Eingabetypen

Template-Variablen verfügen über eine ganze Liste von Eingabetypen, die sich je nach der Art der zu sichernden Daten frei wählen lassen:

Damit kann man die Darstellung und Eingabe der Daten im Manager bequem wählen und auch noch im Nachhinein ändern.

@-Verknüpfungen von Template-Variablen

Template-Variablen lassen sich mit @-Verknüpfungen versehen. Hat eine Template-Variable z.B. den Wert @DOCUMENT 10 gibt diese den Inhalt des Dokuments mit der ID 10 aus. Eine weitere interessante Möglichkeit ergibt sich mit der Verknüpfung @SELECT, die einen SQL-Zugriff auf die MODx-SQL-Datenbank erlaubt. So kann man mit @SELECT pagetitle FROM modx_site_content WHERE parent = 40 alle Titel der im Dokument mit der ID 40 enthaltenen Unterdokumente in einer Template-Variablen ausgeben lassen. Es stehen folgende @-Verknüpfungen zur Verfügung:

• @FILE
• @DIRECTORY
• @DOCUMENT
• @CHUNK

• @INHERIT
• @SELECT
• @EVAL

Endlose Möglichkeiten

Mit Template-Variablen lassen sich MODx-Dokumente so flexibel erweitern, dass sich damit nicht nur ein klassischer Website-Inhalt sondern auch eigene frei definierbare Datensätze abbilden lassen wie Produkte, Artikel, Adressen, usw. Dies bietet MODx-Benutzern die Möglichkeit Informationen auf einfache Weise zu sichern und wieder dynamisch auszugeben.

zur Übersicht zum Seitenanfang