Kalender (Veranstaltungen/Termine)

Das Kalender-Modul wird zusätzlich zu einer bestehenden Contentpapst-Installation als CP::Forms-Modul installiert. Dazu wird das Modul unter "Module > CP::Forms > Modulvorlagen" als Modulvorlage für die Erstellung eines neuen Modules bereitgestellt. Über "Modul aus Vorlage erstellen" legen Sie dann ein neues Modul auf der Basis des Kalender-Modules an. Sobald das Modul erstellt wurde, kann dieses über den Administrationsbereich unter "Module > CP::Forms" aufgerufen werden.

Das auf CP::Forms-basierende Kalender-Modul ermöglicht die gemeinsame Darstellung von Veranstaltungen und Terminen beliebiger CP::Forms-Module in Listen- und natürlich auch in Kalender-Form. Dabei werden innerhalb des Kalender-Modules keine Inhalte eingetragen, sondern das Modul dient lediglich der Verknüpfung der in anderen anderen Modulen eingetragenen Inhalte. Damit diese Verknüpfung zu den Modulen hergestellt werden kann, müssen für jedes Modul, dessen Einträge innerhalb des Kalenders oder der Listen angezeigt werden soll, die folgenden Daten angegeben werden: Ordnername des CP::Forms-Modules Der Ordner-Name des Modules, welches in den Kalender eingebunden werden soll (z.B. "forms_events"). Eine Liste der möglichen Ordner-Namen wird dabei zur Auswahl bereitgestellt, so dass das gewünschte Modul per Klick übernommen werden kann.   Feld für Startdatum Der interne Name des Feldes, welches in diesem Modul das Startdatum enthält. Dieses Feld muss vom Typ "Datum" oder "Datum/Zeit" sein.   Feld für Enddatum (optional) Der interne Name des Feldes, welches in diesem Modul das Enddatum enthält. Dieses Feld muss vom Typ "Datum" oder "Datum/Zeit" sein.   Vorlage für die Anzeige Der komplette Pfad zur Vorlage, welche für die Anzeige in der Auflistung genutzt werden soll. Es können in dieser Vorlage alle {cp:tags} der normalen Listenansicht des jeweiligen Modules genutzt werden.   URL für die Detailseite (derzeit optional)

Sobald diese Daten für ein Modul angegeben wurden, werden automatisch die Einträge des Modules in den Kalender und die Auflistungen mit einbezogen. Weitere Angaben sind hierzu im Administrationsbereich nicht notwendig.

Für das Kalender-Modul gibt es insgesamt 2 Container, die in den Einträgen "Container: Tagesauflistung der Einträge generieren" und "Container: Kalender auf der Webseite anzeigen" detailliert beschrieben werden. Über die Container können eine Listen- und eine Kalenderansicht an beliebigen Stellen der Webseite integriert werden. Die {cp:tags} können dabei sowohl in einer beliebigen Vorlage, als auch in einem Artikel integriert werden. Auch eine mehrfache Einbindung des Kalenders ist machbar. Eine mögliche Form der Einbindung des Kalenders soll im Folgenden kurz geschildert werden:

In dem mehrspaltigen Layout einer Webseite soll in der rechten Spalte ein Kalender integriert werden. Dazu ist wie im Eintrag "Container: Kalender auf der Webseite anzeigen" beschrieben ein {cp:tag} in der für das Layout genutzten Vorlage an der gewünschten Position zu platzieren. In der Regel ist dies die Vorlage "main.htm" im aktuellen Vorlagen-Set.

Sobald dieser Container platziert wurde und über den Admin-Bereich andere CP::Forms-Module eingebunden wurden, wird dann bereits ein Kalender angezeigt und es kann zwischen den Monaten über eine Navigation gewechselt werden.

Damit durch einen Klick auf einen der Tage dann auch die passenden Einträge dieses Tages angezeigt werden, muss zuerst noch ein neuer Artikel in Contentpapst angelegt werden, welcher mit dem Container für die Listenansicht (wie unter "Container: Tagesauflistung der Einträge generieren" beschrieben) gefüllt wird. Die ID des neuen Artikels muss dem ersten Container dann noch über den Parameter "list_id" mitgeteilt werden.

Der Container für den Kalender könnte also z.B. folgendermaßen aufgebaut sein:


Und in dem dazugehörigen Artikel mit der ID "17" ist dann folgender Container enthalten:


Damit ist bereits ein voll funktionsfähiger Kalender vorhanden, der nun durch die Modifizierung der einzelnen Parameter den eigenen Wünschen gemäß angepasst werden kann.

In den hier gezeigten {cp:tags} ist jeweils statt dem internen Ordnernamen eines Modules "[MODULNAME]" enthalten. Da das Kalender-Modul auch mehrfach, d.h. mit verschiedenen Namen betrieben werden kann, müssen Sie hier "[MODULNAME]" noch durch den von Ihnen verwendeten Namen ersetzen.

Dieser Container vom Typ "show_list_day" dient der Anzeige der Einträge eines bestimmten Tages. Dazu werden dem Container als einzige Parameter Tag ("day"), Monat ("month") und Jahr ("year") der Anzeige übergeben. Alles weitere (wie z.B. die Wahl der jeweils richtigen Vorlagen für die Darstellung der Einträge) wird intern durch den Container vorgenommen.



Folgende Parameter sind für diesen Container zulässig / erforderlich:

Parameter für diesen Container
day		Tag der Anzeige.	erforderlich
month		Monat der Anzeige.	erforderlich
type		Für diesen Container muss als Wert "show_list_day" verwendet werden.	erforderlich
year		Jahr der Anzeige.	erforderlich

Dieser Container vom Typ "show_month" dient zur Anzeige des Kalenders in einer Monatsansicht samt einer Navigation zum Wechsel zwischen den Monaten. Über eine Vielzahl von Parametern kann dabei die Gestaltung des Kalenders angepasst werden (z.B. können Text- und Hintergrundfarben, Rahmen usw. angegeben werden).


Die oben enthaltenen Parameter sind dabei zwingend erforderlich. Alle anderen Parameter sind optional und werden - falls nicht gesetzt - durch Standardwerte überschrieben.

Parameter für diesen Container
border_type		Typ des Rahmens der Tabelle (Standardwert: "solid").	optional
border_width		Dicke des Rahmens der Tabelle (Standardwert: "1px").	optional
cell_padding		Textabstand in Pixel (Standardwert: "2").	optional
cell_spacing		Zellenabstand in Pixel (Standardwert: "1").	optional
color_background		Farbangabe für den Hintergrund der Tabelle (Standardwert: "transparent").	optional
color_border		Farbangabe für den Rahmen der Tabelle (Standardwert: "transparent").	optional
color_empty		Farbangabe für leere Felder (Standardwert: "transparent").	optional
color_font		Farbangabe für die Schrift (Standardwert: "transparent").	optional
color_font_title		Farbangabe für die Schrift im Titel (Standardwert: "#000000").	optional
color_head		Farbangabe für die Kopfzeile (Standardwert: "#000000").	optional
color_new_days		Farbangabe für noch folgende Tage (Standardwert: "transparent").	optional
color_old_days		Farbangabe für zurückliegende Tage (Standardwert: "transparent").	optional
color_this_day		Farbangabe für den aktuellen Tag (Standardwert: "transparent").	optional
current_day		Aktuellen Tag manuell festlegen.	optional
current_month		Aktuellen Monat manuell festlegen.	optional
current_year		Aktuelles Jahr manuell festlegen.	optional
list_id		ID des Artikels, in welchem die Einträge angezeigt werden.	erforderlich
month		Monat der Anzeige.	optional
table_width		Breite des gesamten Kalenders (Standardwert: "100%").	optional
type		Für diesen Container muss als Wert "show_month" verwendet werden.	erforderlich
year		Jahr der Anzeige.	optional