Templates: Unterschied zwischen den Versionen
Aus DynPG-Wiki
K (→Ein erstes Beispiel) |
|||
| (16 dazwischenliegende Versionen von 3 Benutzern werden nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
[[Category:Integration in eine Webseite]] | [[Category:Integration in eine Webseite]] | ||
| + | {{Einführungsartikel}} | ||
| + | |||
== Einführung == | == Einführung == | ||
| − | Mit DynPG ist es möglich die Art und Weise wie Artikel und Listenansichten ausgegeben werden, zu beeinflussen. Ein Weg ist CSS, ein anderer (wesentlich flexiblerer) geht über die eingebaute ''' | + | Mit DynPG ist es möglich die Art und Weise wie Artikel und Listenansichten ausgegeben werden, zu beeinflussen. Ein Weg ist CSS, ein anderer (wesentlich flexiblerer) geht über die eingebaute '''Template-Engine'''. Ein Beispiel: Der Aufruf |
<code>[php,N] | <code>[php,N] | ||
$DynPG->Write_Article(); | $DynPG->Write_Article(); | ||
</code> | </code> | ||
| − | bewirkt, dass die Detailansicht eines Artikels angezeigt wird. Dabei wird (wenn nichts anderes explizit angegeben wurde) implizit ein Standard-Template verwendet, das definiert wie diese Ansicht auszusehen hat. Im DynPG-Unterverzeichnis | + | bewirkt, dass die Detailansicht eines Artikels angezeigt wird. Dabei wird (wenn nichts anderes explizit angegeben wurde) implizit ein Standard-Template verwendet, das definiert wie diese Ansicht auszusehen hat. Im DynPG-Unterverzeichnis <tt>/tpl/MyCMS/default/</tt> liegen die Templatedateien für die Standardansichten. |
| − | * groups.tpl | + | * '''groups.tpl:''' Gruppenlistenansicht |
| − | * articles.tpl | + | * '''articles.tpl:''' Artikellistenansicht |
| − | * detail.tpl | + | * '''detail.tpl:''' Artikel-Detailansicht |
| − | * home.tpl | + | * '''home.tpl:''' Home-Ansicht |
| − | * navigation.tpl | + | * '''navigation.tpl:''' Blätterfunktion der Listen-Ansichten |
| − | * search-form.tpl | + | * '''search-form.tpl:''' Formular für die Suche |
| − | In diesen Dateien haben Sie die Möglichkeit, oben genannte Ansichten nach Ihren Wünschen anzupassen. Die Darstellung geschieht grundsätzlich mit | + | In diesen Dateien haben Sie die Möglichkeit, oben genannte Ansichten nach Ihren Wünschen anzupassen. Die Darstellung geschieht grundsätzlich mit HTML. Zusätzlich gibt es eine ''Templatesprache''. Diese ist schlicht gehalten und beinhaltet einige wenige Elemente die nachfolgend näher betrachtet werden sollen. Statt die Standard-Templates zu manipulieren, können auch neue Templates erzeugt werden. Dazu muss im Unterverzeichnis <tt>/tpl/MyCMS/</tt> einfach ein neuer Ordner mit dem gewünschten Templatenamen angelegt werden. Je nachdem welche Ansichten nun geändert werden sollen, fügt man Dateien mit denselben Namen wie in oben genannter Liste ein. Diese können dann nach den eigenen Wünschen bearbeitet werden. Mit den Zeilen |
<code>[php,N] | <code>[php,N] | ||
| Zeile 22: | Zeile 24: | ||
$DynPG->Write_Article(); | $DynPG->Write_Article(); | ||
| − | |||
| − | |||
| + | $DynPG->setupTemplate("default"); | ||
| + | </code> | ||
| + | wird das Template <tt>meinTemplate</tt> gesetzt und damit der Artikel 13 ausgegeben.}} | ||
| − | + | {{Caution | |
| + | |Das Setzen eines Templates muss '''''vor''''' der Ausgabe des Artikels erfolgen! | ||
| − | + | {{Caution | |
| + | |Wenn das Template gesetzt wurde, dann wird es auch für alle nachfolgenden Ausgaben verwendet. Ist dies nicht erwünscht, muss explizit wieder das Standard-Template (<tt>default</tt>) gesetzt werden.}} | ||
| − | == Ein erstes | + | == Die Template-Sprache == |
| − | + | === Ein erstes Beispiel === | |
| + | Hier ein kleines einführendes Beispiel: | ||
| − | ''' | + | '''Template-Minimalbeispiel''' (eigene Artikel-Detailansicht in <tt>/tpl/MyCMS/minimal/detail.tpl</tt>) |
| − | < | + | <code>[html,N] |
<!-- Dies ist ein Kommentar (er wird nicht angezeigt) --> | <!-- Dies ist ein Kommentar (er wird nicht angezeigt) --> | ||
{$CONTENT} <!--Den Inhalt des Artikels ausgeben--> | {$CONTENT} <!--Den Inhalt des Artikels ausgeben--> | ||
| Zeile 42: | Zeile 48: | ||
<!--Alles was hier drinsteht, wird nach dem Aufruf von $DynPG->Write_Article(); eingefügt --> | <!--Alles was hier drinsteht, wird nach dem Aufruf von $DynPG->Write_Article(); eingefügt --> | ||
| − | </ | + | </code> |
| + | |||
| + | <tt>{$CONTENT}</tt> ist ein Platzhalter für den Inhalt des anzuzeigenden Artikels. An dieser Stelle wird dann also der eigentliche Artikeltext eingefügt (genau das erledigt die Templateengine). Eine Liste der Templatevariablen (Platzhalter) finden Sie in der [[Template-Referenz]]. | ||
| − | + | Im Ordner <tt>/tpl/MyCMS/minimal</tt> wurde ein eigenes Template angelegt. In diesen Ordner verschieben wir eine Datei <tt>detail.tpl</tt>, die obigen Inhalt aufweist. Damit haben wir uns eine eigene Artikel-Detailansicht definiert, die jetzt jederzeit in irgendeiner Seite verwendet werden kann, indem folgender Code eingefügt wird: | |
<code>[php,N] | <code>[php,N] | ||
$DynPG->setupTemplate("minimal"); | $DynPG->setupTemplate("minimal"); | ||
| Zeile 52: | Zeile 60: | ||
$DynPG->Write_Article(); | $DynPG->Write_Article(); | ||
</code> | </code> | ||
| − | |||
| − | + | Die Templatesprache hat neben den Templateplatzhaltern noch drei andere wichtige Sprachelemente. Dies sind die [[#Die bedingte Anweisung|bedingte Anweisung]], der [[#PHP-Code|PHP-Block]] und die Erstellung von [[#Listen|Listen]]. In die Template-Datei kann zudem auch beliebiger HTML-Code eingefügt werden, wodurch die Gestaltungsmöglichkeiten vielfältiger und wesentlich flexibler werden. | |
| − | + | ||
| − | + | === Die bedingte Anweisung === | |
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | + | ||
| − | == Die bedingte Anweisung == | + | |
Folgendes Beispiel zeigt, wie man bedingte Anweisungen in seine Templates integrieren kann: | Folgendes Beispiel zeigt, wie man bedingte Anweisungen in seine Templates integrieren kann: | ||
| − | ''' | + | '''Template-Beispiel''' (Artikel-Detailansicht mit bedingter Anweisung) |
| − | < | + | <code>[html,N] |
<!--Wenn Artikelname = "Kontakt" dann Inhalt + zusätzliche Infos ausgeben--> | <!--Wenn Artikelname = "Kontakt" dann Inhalt + zusätzliche Infos ausgeben--> | ||
| Zeile 368: | Zeile 86: | ||
{$# End #} | {$# End #} | ||
| − | </ | + | </code> |
| − | Hier wird der Text | + | Hier wird der Text <tt>"mein Lieblingsartikel!"</tt> nur dann ausgegeben, wenn der Artikel den Namen "Kontakt" trägt. Die Syntax für bedingte Anweisungen lautet allgemein: |
| − | < | + | <code>[html,N] |
{$#(Bedingung) #} | {$#(Bedingung) #} | ||
| Zeile 376: | Zeile 94: | ||
{$# End #} | {$# End #} | ||
| − | </ | + | </code> |
| − | + | {{Caution | |
| + | |Bei Zeichenkettenvergleichen (wie in obigem Bsp.) muss darauf geachtet werden, dass auch die Templatevariablen von Anführungszeichen umgeben werden, sonst hagelt es Fehlerausschriften.}} | ||
| − | + | {{Info | |
| + | |Die Bedingung wird als PHP-Code ausgewertet, daher können prinzipiell alle Operatoren verwendet werden, solange der Ergebnisausdruck einen Wahrheitswert liefert.}} | ||
| − | == PHP-Code == | + | Schauen wir uns ein Beispiel mit Negation an. |
| − | < | + | <code>[html,N] |
| + | <table> | ||
| + | <tr> | ||
| + | <td> {$TITLE} </td> | ||
| + | </tr> | ||
| + | {$# ({$SHOWDATE}) #} | ||
| + | <tr> | ||
| + | <td> Erstellt am: {$CREATEDATE} </td> | ||
| + | </tr> | ||
| + | {$# End #} | ||
| + | {$# (!{$SHOWDATE}) #} | ||
| + | <tr> | ||
| + | <td> Anzeige ohne Erstelldatum </td> | ||
| + | </tr> | ||
| + | {$# End #} | ||
| + | <tr> | ||
| + | <td> {$CONTENT} </td> | ||
| + | </tr> | ||
| + | </table> | ||
| + | </code> | ||
| + | |||
| + | Das obige Beispiel gibt den Artikel mit seinem Erstelldatum aus, falls das entsprechende Häkchen im Backend angeklickt wurde, ansonsten wird "Anzeige ohne Erstelldatum" ausgegeben. | ||
| + | |||
| + | === PHP-Code === | ||
| + | <code>[html,N] | ||
{$#PHP (PHP-CODE) #} | {$#PHP (PHP-CODE) #} | ||
| − | </ | + | </code> |
Mit dieser Syntax können Sie PHP-Code implementieren. Alles was in der Klammer steht, wird als PHP-Code interpretiert. Es kommt dem Tag | Mit dieser Syntax können Sie PHP-Code implementieren. Alles was in der Klammer steht, wird als PHP-Code interpretiert. Es kommt dem Tag | ||
| − | < | + | <code>[php,N] |
<?php ... ?> | <?php ... ?> | ||
| − | </ | + | </code> |
einer PHP-Seite gleich. Auch hier ein kleines Beispiel: | einer PHP-Seite gleich. Auch hier ein kleines Beispiel: | ||
| − | ''' | + | '''Template-Beispiel''' (Artikel-Detailansicht mit PHP-Code) |
| − | < | + | <code>[html,N] |
<!--Zeichenlänge des Titels anzeigen--> | <!--Zeichenlänge des Titels anzeigen--> | ||
| Zeile 402: | Zeile 146: | ||
{$CONTENT} <!--Inhalt ausgeben--> | {$CONTENT} <!--Inhalt ausgeben--> | ||
| − | </ | + | </code> |
| + | {{Caution | ||
| + | |Am Ende eines PHP-Statements '''''darf kein Semikolon (";")''''' stehen, wie sonst üblich.}} | ||
| + | |||
| + | === Listen === | ||
| + | In der Gruppenliste und Artikelliste werden in der Regel mehrere Gruppen und Artikel in einer Liste ausgegeben. Sie können dabei das Aussehen jedes einzelnen Elements der Liste beeinflussen. Die Template-Engine durchläuft zum Erstellen der Liste eine ''Schleife'', welche den folgenden Aufbau hat: | ||
| + | |||
| + | <code>[html,n] | ||
| + | // Code der vor Durchlaufen der Schleife eingefügt wird. | ||
| + | |||
| + | <!-- RepeatedListBegin name="listing" --> | ||
| + | |||
| + | // Code in der Schleife. Hier sind die Variablen der jeweilgen Gruppe (Titel, Beschreibung. URL etc.) verfügbar. | ||
| + | |||
| + | <!-- RepeatedListFinish --> | ||
| + | |||
| + | // Code der nach Durchlaufen der Schleife eingefügt wird. | ||
| + | |||
| + | </code> | ||
| + | |||
| + | Innerhalb dieser Schleife haben Sie Zugriff auf die Variablen, welche spezifisch für die jeweilige Gruppe oder den jeweiligen Artikel sind (z.B. Titel, Leadtext, Leadbild, URL zum Inhalt etc.). Die HTML Angaben für ein Element der Liste müssen also innerhalb der Schleife platziert werden. Um nun zum Beispiel eine Gruppenliste zu erstellen, können Sie die folgenden Angaben verwenden. | ||
| + | |||
| + | <code>[html,n] | ||
| + | <div class="gruppenliste"> | ||
| + | |||
| + | <!-- RepeatedListBegin name="listing" --> | ||
| + | |||
| + | <div class="gruppe"> | ||
| + | <h3>{$NAME}</h3> | ||
| + | <p>{$SHORTTEXT}</p> | ||
| + | <a href="{$LIST_REFER_TO}">Link</a> | ||
| + | </div> | ||
| + | |||
| + | <!-- RepeatedListFinish --> | ||
| + | </div> | ||
| + | </code> | ||
| + | |||
| + | == Weitere Informationen == | ||
| + | Weitere Informationen zu den Templatevariablen und den Umgang mit Templates finden Sie in den folgenden Artikeln: | ||
| − | [[ | + | * [[Tutorial - Templates]] |
| + | * [[Template-Referenz]] | ||
Aktuelle Version vom 27. September 2011, 15:51 Uhr
Dieser Artikel ist Teil einer Reihe von Einführungsartikeln zu DynPG
Webseiten erstellen mit DynPG | DynPG in eine Webseite einbinden | Die drei Ansichten von DynPG | Eine einfache Inhaltsübersicht | Dynamisches Navigationmenü ... | CSS | Templates
zurück zu Kategorie:Integration in eine Webseite
Inhaltsverzeichnis
Einführung
Mit DynPG ist es möglich die Art und Weise wie Artikel und Listenansichten ausgegeben werden, zu beeinflussen. Ein Weg ist CSS, ein anderer (wesentlich flexiblerer) geht über die eingebaute Template-Engine. Ein Beispiel: Der Aufruf
$DynPG->Write_Article();
bewirkt, dass die Detailansicht eines Artikels angezeigt wird. Dabei wird (wenn nichts anderes explizit angegeben wurde) implizit ein Standard-Template verwendet, das definiert wie diese Ansicht auszusehen hat. Im DynPG-Unterverzeichnis /tpl/MyCMS/default/ liegen die Templatedateien für die Standardansichten.
- groups.tpl: Gruppenlistenansicht
- articles.tpl: Artikellistenansicht
- detail.tpl: Artikel-Detailansicht
- home.tpl: Home-Ansicht
- navigation.tpl: Blätterfunktion der Listen-Ansichten
- search-form.tpl: Formular für die Suche
In diesen Dateien haben Sie die Möglichkeit, oben genannte Ansichten nach Ihren Wünschen anzupassen. Die Darstellung geschieht grundsätzlich mit HTML. Zusätzlich gibt es eine Templatesprache. Diese ist schlicht gehalten und beinhaltet einige wenige Elemente die nachfolgend näher betrachtet werden sollen. Statt die Standard-Templates zu manipulieren, können auch neue Templates erzeugt werden. Dazu muss im Unterverzeichnis /tpl/MyCMS/ einfach ein neuer Ordner mit dem gewünschten Templatenamen angelegt werden. Je nachdem welche Ansichten nun geändert werden sollen, fügt man Dateien mit denselben Namen wie in oben genannter Liste ein. Diese können dann nach den eigenen Wünschen bearbeitet werden. Mit den Zeilen
$DynPG->setupTemplate("meinTemplate"); $DynPG->SetParam_A_Article(13); $DynPG->Write_Article(); $DynPG->setupTemplate("default");
wird das Template meinTemplate gesetzt und damit der Artikel 13 ausgegeben.}}
{{Caution |Das Setzen eines Templates muss vor der Ausgabe des Artikels erfolgen!
 Achtung:
|
Wenn das Template gesetzt wurde, dann wird es auch für alle nachfolgenden Ausgaben verwendet. Ist dies nicht erwünscht, muss explizit wieder das Standard-Template (default) gesetzt werden. |
Die Template-Sprache
Ein erstes Beispiel
Hier ein kleines einführendes Beispiel:
Template-Minimalbeispiel (eigene Artikel-Detailansicht in /tpl/MyCMS/minimal/detail.tpl)
<!-- Dies ist ein Kommentar (er wird nicht angezeigt) --> {$CONTENT} <!--Den Inhalt des Artikels ausgeben--> Dies ist ein <b>selbstdefiniertes Template</b> <!--beliebiger HTML-Code--> <!--Alles was hier drinsteht, wird nach dem Aufruf von $DynPG->Write_Article(); eingefügt -->
{$CONTENT} ist ein Platzhalter für den Inhalt des anzuzeigenden Artikels. An dieser Stelle wird dann also der eigentliche Artikeltext eingefügt (genau das erledigt die Templateengine). Eine Liste der Templatevariablen (Platzhalter) finden Sie in der Template-Referenz.
Im Ordner /tpl/MyCMS/minimal wurde ein eigenes Template angelegt. In diesen Ordner verschieben wir eine Datei detail.tpl, die obigen Inhalt aufweist. Damit haben wir uns eine eigene Artikel-Detailansicht definiert, die jetzt jederzeit in irgendeiner Seite verwendet werden kann, indem folgender Code eingefügt wird:
$DynPG->setupTemplate("minimal"); $DynPG->SetParam_A_Article(13); $DynPG->Write_Article();
Die Templatesprache hat neben den Templateplatzhaltern noch drei andere wichtige Sprachelemente. Dies sind die bedingte Anweisung, der PHP-Block und die Erstellung von Listen. In die Template-Datei kann zudem auch beliebiger HTML-Code eingefügt werden, wodurch die Gestaltungsmöglichkeiten vielfältiger und wesentlich flexibler werden.
Die bedingte Anweisung
Folgendes Beispiel zeigt, wie man bedingte Anweisungen in seine Templates integrieren kann:
Template-Beispiel (Artikel-Detailansicht mit bedingter Anweisung)
<!--Wenn Artikelname = "Kontakt" dann Inhalt + zusätzliche Infos ausgeben--> {$# ('{$TITLE}'=='Kontakt') #} {$CONTENT} mein <b>Lieblingsartikel</b>! {$# End #} <!--andernfalls nur den Inhalt ausgeben--> {$# ('{$TITLE}'!='Kontakt') #} {$CONTENT} {$# End #}
Hier wird der Text "mein Lieblingsartikel!" nur dann ausgegeben, wenn der Artikel den Namen "Kontakt" trägt. Die Syntax für bedingte Anweisungen lautet allgemein:
{$#(Bedingung) #}
...
{$# End #}| Achtung:
|
Bei Zeichenkettenvergleichen (wie in obigem Bsp.) muss darauf geachtet werden, dass auch die Templatevariablen von Anführungszeichen umgeben werden, sonst hagelt es Fehlerausschriften. |
 Tipp:
|
Die Bedingung wird als PHP-Code ausgewertet, daher können prinzipiell alle Operatoren verwendet werden, solange der Ergebnisausdruck einen Wahrheitswert liefert. |
Schauen wir uns ein Beispiel mit Negation an.
<table> <tr> <td> {$TITLE} </td> </tr> {$# ({$SHOWDATE}) #} <tr> <td> Erstellt am: {$CREATEDATE} </td> </tr> {$# End #} {$# (!{$SHOWDATE}) #} <tr> <td> Anzeige ohne Erstelldatum </td> </tr> {$# End #} <tr> <td> {$CONTENT} </td> </tr> </table>
Das obige Beispiel gibt den Artikel mit seinem Erstelldatum aus, falls das entsprechende Häkchen im Backend angeklickt wurde, ansonsten wird "Anzeige ohne Erstelldatum" ausgegeben.
PHP-Code
{$#PHP (PHP-CODE) #}Mit dieser Syntax können Sie PHP-Code implementieren. Alles was in der Klammer steht, wird als PHP-Code interpretiert. Es kommt dem Tag
<?php ... ?>
einer PHP-Seite gleich. Auch hier ein kleines Beispiel:
Template-Beispiel (Artikel-Detailansicht mit PHP-Code)
<!--Zeichenlänge des Titels anzeigen--> Die Länge des Titels beträgt {$#PHP (strlen("{$TITLE}")) #} Zeichen {$CONTENT} <!--Inhalt ausgeben-->
| Achtung:
|
Am Ende eines PHP-Statements darf kein Semikolon (";") stehen, wie sonst üblich. |
Listen
In der Gruppenliste und Artikelliste werden in der Regel mehrere Gruppen und Artikel in einer Liste ausgegeben. Sie können dabei das Aussehen jedes einzelnen Elements der Liste beeinflussen. Die Template-Engine durchläuft zum Erstellen der Liste eine Schleife, welche den folgenden Aufbau hat:
// Code der vor Durchlaufen der Schleife eingefügt wird. <!-- RepeatedListBegin name="listing" --> // Code in der Schleife. Hier sind die Variablen der jeweilgen Gruppe (Titel, Beschreibung. URL etc.) verfügbar. <!-- RepeatedListFinish --> // Code der nach Durchlaufen der Schleife eingefügt wird.
Innerhalb dieser Schleife haben Sie Zugriff auf die Variablen, welche spezifisch für die jeweilige Gruppe oder den jeweiligen Artikel sind (z.B. Titel, Leadtext, Leadbild, URL zum Inhalt etc.). Die HTML Angaben für ein Element der Liste müssen also innerhalb der Schleife platziert werden. Um nun zum Beispiel eine Gruppenliste zu erstellen, können Sie die folgenden Angaben verwenden.
<div class="gruppenliste"> <!-- RepeatedListBegin name="listing" --> <div class="gruppe"> <h3>{$NAME}</h3> <p>{$SHORTTEXT}</p> <a href="{$LIST_REFER_TO}">Link</a> </div> <!-- RepeatedListFinish --> </div>
Weitere Informationen
Weitere Informationen zu den Templatevariablen und den Umgang mit Templates finden Sie in den folgenden Artikeln:
