Listentemplates
Listentemplates werden gebraucht, wenn mit Hilfe des
Listenaufrufs eine Liste aller Dateien eines bestimmten Verzeichnisses ausgegeben wird.
Diese Templates befinden sich üblicherweise im
/de/templates/list/ Verzeichnis, wobei
/de/ je nach Einsatz des bitCMS natürlich variieren kann. Eine Listen Template Datei gliedert sich in folgende 2 Teile.
Zeilenvorlage - ROW
<!--ROW-->
{edititem}
<img src="{thumb}" border="0" align="left">
<strong>{title}</strong> <em>{datec format="%e. %B %Y"}</em><br>
{description 80 "..."}<br>
<a href='{link}?navurl=/de/news.php'>Meldung lesen</a>
<!--ROW-->Innerhalb dieser Zeilenvorlage stehen Ihnen folgende Platzhalter zur ferfügung:
- {title} Titel des Listeneintrags, wird bei der jeweiligen Datei aus dem Metatag muTitle herausgelesen.
- {datec format=""} Erstellungsdatum der jeweiligen Datei. format definiert zusätzlich das Datumsformat (s. PHP Funktion strftime)
- {datem format=""} Änderungsdatum der jeweiligen Datei. format definiert zusätzlich das Datumsformat (s. PHP Funktion strftime)
- {datep format=""} Publizierungsdatum der jeweiligen Datei. format definiert zusätzlich das Datumsformat (s. PHP Funktion strftime)
- {description length "..."} Beschreibung des Listeneintrags, wird bei der jeweiligen Datei aus dem Metatag muDescription herausgelesen. Mit dem Integer Wert length kann man optional die Beschreibung nach length Zeichen abschneiden und dann "..." anhängen
- {link} Pfad zur jeweiligen Datei.
- {thumb} Pfad zum Vorschaubild, wird bei der jeweiligen Datei aus dem Metatag muThumb herausgelesen.
- {edititem} Dieser Platzhalter wird bei eingeloggtem Zustand durch einen Listeneintrag bearbeiten Button ersetzt.
Im obigen Beispiel sehen Sie nach dem
{link} Platzhalter den URI Parameter
navurl=/de/news.php. Dies hat zur Folge, dass, wenn Sie nun in dieser Liste auf den Link zur Datei draufklicken, der Navigationszustand angezeigt wird, wie wenn es sich bei der angezeigten Datei um die Datei
/de/news.php handeln würde. Dies ist zB sinnvoll bei Newslisten, wo alle Newsmeldungen angezeigt werden. Die einzelnen Meldungen sind aber in der Navigation nirgends direkt erfasst, folglich wüsste die Navigation nicht, was anzeigen, wenn Sie auf eine solche Newsmeldung klicken. Mit diesem Parameter schaffen Sie dem Abhilfe.
Blättervorlage - PAGING
Die Blättervorlage kommt dann zum Zug, wenn Sie dem
Listenaufruf für den Parameter
rowsperpage eine Zahl übergeben.
ab bitCMS 2.0:
<!--PAGING-->
<center>
<!--FIRSTPAGE--><a href="{firstpageurl}">Anfang</a> <!--FIRSTPAGE-->
<!--FIRSTPAGES-->Anfang<!--FIRSTPAGES-->
<!--PREVPAGE--><a href="{prevpageurl}">zurück</a> <!--PREVPAGE-->
<!--PREVPAGES-->zurück<!--PREVPAGES-->
<!--PAGE--><a href="{pageurl}">{num}</a><!--PAGE-->
<!--CURRENTPAGE-->{num}<!--CURRENTPAGE-->
<!--MORE-->[<a href="{moreurl}">...</a>]<!--MORE-->
<!--PAGINGSEPARATOR--> | <!--PAGINGSEPARATOR-->
<!--NEXTPAGE--> <a href="{nextpageurl}">vor</a><!--NEXTPAGE-->
<!--NEXTPAGES-->vor<!--NEXTPAGES-->
<!--LASTPAGE--> <a href="{lastpageurl}">Ende</a><!--LASTPAGE-->
<!--LASTPAGES-->Ende<!--LASTPAGES-->
</center>
<!--PAGING-->vorher:
<!--PAGING-->
<center>
<!--PREVPAGE--><a href="{prevpageurl}">zurück</a> <!--PREVPAGE-->
<!--PAGE--><a href="{pageurl}">{num}</a><!--PAGE-->
<!--CURRENTPAGE-->{num}<!--CURRENTPAGE-->
<!--PAGINGSEPARATOR--> | <!--PAGINGSEPARATOR-->
<!--NEXTPAGE--> <a href="{nextpageurl}">weiter</a><!--NEXTPAGE-->
</center>
<!--PAGING-->Innerhalb dieser
<!--PAGING-->...
<!--PAGING--> Vorlage gibt es 12 weitere Vorlagen:
- <!--FIRSTPAGE--> Vorlage für erste Seite. Innerhalb davon stehen Ihnen folgende Platzhalter zur Verfügung:
- {firstpageurl} Pfad für erste Seite
- <!--FIRSTPAGES--> Vorlage für erste Seite bei gewähltem Zustand.
- <!--PREVPAGE--> Vorlage für eine Seite zurück. Innerhalb davon stehen Ihnen folgende Platzhalter zur Verfügung:
- {prevpageurl} Pfad für eine Seite zurück beim Blättern
- <!--PREVPAGES--> Vorlage für eine Seite zurück bei gewähltem Zustand.
- <!--PAGE--> Vorlage für eine bestimmte Seite. Innerhalb davon stehen Ihnen folgende Platzhalter zur Verfügung:
- {pageurl} Pfad für eine Seite zurück beim Blättern
- <!--CURRENTPAGE--> Vorlage für aktuelle Seite. Innerhalb davon stehen Ihnen folgende Platzhalter zur Verfügung:
- {num} Pfad für eine Seite zurück beim Blättern
- <!--MORE--> Vorlage für weitere Seiten wenn die Anzahl Seiten > 8 ist.
- <!--PAGINGSEPARATOR--> Vorlage für den Separator zwischen den einzelnen Seiten
- <!--NEXTPAGE--> Vorlage für eine Seite vor. Innerhalb davon stehen Ihnen folgende Platzhalter zur Verfügung:
- {nextpageurl} Pfad für eine Seite vor beim Blättern
- <!--NEXTPAGES--> Vorlage für eine Seite vor bei gewähltem Zustand.
- <!--LASTPAGE--> Vorlage für letzte Seite. Innerhalb davon stehen Ihnen folgende Platzhalter zur Verfügung:
- {lastpageurl} Pfad für erste Seite
- <!--LASTPAGES--> Vorlage für letzte Seite bei gewähltem Zustand.
