Listen

(bitCMS v.1.0)

muCreateList( dir, tplfile [, sortby] [, mode] [, rowsperpage] [, output] [, metafilters])

Die Funktion muCreateList() erzeugt aus einem angegeben Verzeichnis eine Liste mit allen darin enthaltenen php Dateien. Folgende Parameter sind möglich:

dir (string) - Verzeichnis, dessen Dateien aufgelistet werden sollen.
tplfile (string) - Pfad zur Templatedatei für die Zeilenvorlage der Liste. Üblicherweise werden die Listentemplates im Verzeichnis /de/templates/list/ abgelegt.
sortby (string) - gibt an, wonach die Liste sortiert weden soll, ist standardmässig auf datec (Erstellungsdatum der Datei) gesetzt. Folgende Werte sind möglich:

name - Liste wird nach Dateinamen sortiert
title - Liste wird nach den Titeln (Metatag muTitle der jeweiligen Datei) sortiert
description - Liste wird nach den Beschreibungen (Metatag muDescription der jeweiligen Datei) sortiert
datec - Liste wird nach Erstellungsdatum der Dateien sortiert
datem - Liste wird nach Änderungsdatum der Dateien sortiert
datep - Liste wird nach Publizierungsdatum der Dateien sortiert

mode (string) - gibt an, ob aufsteignd (ASC) oder absteigend (DESC) sortiert werden soll, ist standardmässig auf DESC
rowsperpage (int, boolean) - damit lässt sich steuern, wieviele Listeneinträge pro Seite angezeigt werden sollen, ist standardmässig auf false gesetzt, es werde somit alle Listeneinträge auf einmal angezeigt - ohne Paging.
output (boolean) - bei true wird die Liste mittels echo ausgegeben, bei false gibt die Funktion die Liste als String zurück.
metafilters (string) - mit metafilters können ab Version 2.3.6 Listeneinträge (Dateien) gefiltert werden. Ist metafilters zB so gesetzt muNewscat=intern werden nur Dateien gelistet, die in den bitCMS Metatags einen Tag mit dem Namen muNewscat haben, der den Wert intern hat. Es können mehrere durch Komma getrennte Filter angegeben werden, zB muNewscat=intern, muNewscat=global. Mehrere Filter werden mit OR (oder) verknüpft. Es muss also ein Filter zutreffen, damit die entspr. Datei gelistet wird.
Auf der andern Seite können im jeweiligen bitCMS Metatag ebenfalls mehrere Filterwerte angegeben werden (kommagetrennt, s. Beispiel unten).

Die Funktion gibt als Resultat einen HTML String aus, der die generierte Liste enthält.

Sehen Sie auch: Listentemplates

Code Beispiel

Folgenden PHP Code ist an der Stelle auf einer Seite einzufügen, an welcher eine Liste den Inhalt (darin enthaltene PHP Dateien) eines bestimmten Verzeichnisses ausgegeben werden soll:
<? muCreateList("/de/news/", "/de/templates/list/news.tpl", "datec", "DESC", 10); ?>
Dieser Listenaufruf zeigt nun 10 Einträge (Dateien im Verzeichnis /de/news/) und zwar absteignd nach dem Erstellungsdatum sortiert (neuste Newsmeldung zuerst).

ab Version 2.3.6:

Das folgende Beispiel zeigt einen Listenaufruf mit Filter Funktion.
<? muCreateList("/de/news/", "/de/templates/list/news.tpl", "datec", "DESC", 10, true, "muNewscat=intern"); ?>Bei diesem Beispiel werden nun nur Dateien gelistet, die den entspr. bitCMS Metatag enthalten:
<meta name="muNewscat" content="intern" description="Newskategorie (intern, global)" />Wie oben in der Synatxbeschreibung bereits angetönt, können im Metatag der Date auch mehrere Filterwerte, durch Komma getrennt, angegeben werden.
<meta name="muNewscat" content="intern, global" description="Newskategorie (intern, global)" />Eine solche Datei würde sowohl bei einem Listenaufruf wie oben im Beispiel als auch bei folgendem gelistet werden:
<? muCreateList("/de/news/", "/de/templates/list/news.tpl", "datec", "DESC", 10, true, "muNewscat=global"); ?>