Eventkalender
(bitCMS v.2.0, Modul Kalender)
muShowEvents( calendar, tplfile [, mode] [, from] [, to ] [, focus] [, rowsperpage] [, output] )
Die Funktion muShowEventst() erzeugt aus einem angegeben Kalender eine Liste mit allen darin eingetragenen Events. Folgende Parameter sind möglich:
- calendar (string) - Kalender, dessen Events gelistet werden sollen. Wenn "" oder false werden die Events aller Kalender ausgegeben.
- tplfile (string) - Pfad zur Templatedatei für die Zeilenvorlage der Event Liste. Üblicherweise werden die Listentemplates im Verzeichnis /de/templates/cal/ abgelegt.
- mode (string) - gibt an, ob die Events aufsteignd (ASC) oder absteigend (DESC) nach ihrem Startdatum sortiert werden soll, ist standardmässig auf DESC.
- from (string) - gibt das Startdatum (in der Form jjjj-mm-tt, zB also 2006-04-18) des Bereichs an, dessen enthaltene Events gelistet werden sollen. Standardmässig auf jetziges Datum - 3 Jahre gesetzt.
- to (string) - gibt das Enddatum (in der Form jjjj-mm-tt, zB also 2006-04-18) des Bereichs an, dessen enthaltene Events gelistet werden sollen. Standardmässig auf jetziges Datum + 3 Jahre gesetzt.
- focus (string) - definiert das Datum, dessen nächstfolgender Event langen Listen mit Paging zu Beginn standardmässig angezeigt werden soll. Kann folgende Werte haben:
- today - aktueller Tag
- 2006-06-23 - spezifisches Datum
- <leer> - ("" oder false !) neuster Event wird zuerst angezeigt
- months - es werden die Events des aktuellen Monats angezeigt mit Paging zum letzten und nächsten Monat (s. Eventlisten Templates )
- weeks - es werden die Events der aktuellen Woche angezeigt mit Paging zur letzten und nächsten Woche (s. Eventlisten Templates )
- days - es werden die Events des aktuellen Tages angezeigt mit Paging zum letzten und nächsten Tag (s. Eventlisten Templates )
- 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.
Die Funktion gibt als Resultat je nach
output die Eventliste mittles
echo aus oder gibt den entsprechenden HTML String zurück.
Sehen Sie auch:
Eventlisten Templates Code Beispiel
Folgenden PHP Code ist an der Stelle auf einer Seite einzufügen, an welcher eine Eventliste ausgegeben werden soll:
<? muShowEvents("kalender", "/de/templates/cal/calendar.tpl", "DESC", "2004-05-23", "2008-12-31", "today", 10); ?>
Dieser Eventlistenaufruf zeigt nun die 10 Events um das aktuelle Datum und zwar absteigend nach dem Event Startdatum sortiert. Unterhalb davon werde zusätzlich die entsprechenden Paging Links ausgegeben.
