ZURÜCK ZUR GESAMTÜBERSICHT | DOKUMENTATIONEN | SCHRITT FÜR SCHRITT | WEITERE THEMEN

Kalender

Artikel aus den Modulen Veranstaltungen, Gottesdienste und aktuelle Meldungen können Sie mit Hilfe der Kalenderfunktion übersichtlich in einer Monatsansicht darstellen. Die Monatsansicht wird in das rechte Seitenelement (Infoleiste) eingeblendet und bietet eine Reihe von praktischen Funktionen:

Das Aktuelle Tagesdatum wird deutlich gekennzeichnet (roter Rahmen)
Feiertage und Einträge zum Tagesdatum können farblich anders dargestellt werden
Feiertage und Einträge werden angezeigt indem man die Maus über das Tagesdatum führt.
Das Datum ist anklickbar um einen Artikel zu dem betreffenden Tag aufrufen kann.

Abb: Im rechten Seitenelement ist der Kalender konfiguriert

Mit Hilfe der Navigationssymbole rechts und links kann der angezeigte Monat gewechselt werden. Ein Klick auf die Monatsanzeige springt immer zurück zum aktuellen Monat.

Grundsätzlich bietet der Kalender eine Monatsübersicht für die folgenden strukturierten Inhalte (Module):

Veranstaltungen
Gottesdienste
Aktuelle Meldungen

Grundkonfiguration

Die technische Vorraussetzung für die Kalenderfunktionen ist:

Die Aktivierung des Kalender für die gewünschte Site, Seiten oder Seite über die Dateieigenschaft: „calendar.show“ (Die Dateieigenschaften finden Sie im Kontextmenü unter Eigenschaften / Erweitert)
die Einstellung des Kalenders auf die gewünschten Module (Events, News, Gottesdienste) über die Konfigurationsdatei: „configuration_calender” (Die Datei finden Sie im Ordner _configuration)
Die farbliche Anpassung des Kalenderelements an das gegebene Template der Site über die Konfiguration: „calender_css” (Die Datei finden Sie im Ordner _configuration)

Aktivierung des Kalenders

Der Kalender kann für verschiedene Bereiche Ihrer Website aktiviert werden. Dabei kan der Kalender im linken oder im rechten Seitenelement erscheinen. Die folgenden Möglichkeiten stehen Ihnen zur Auswahl:

für die gesamte Website (alle Seiten einer Internetpräsents / Microsite)
für einen untergeordneten Bereich einer Site (alle Seite in einem Ordner)
für eine bestimmte Seite.

Hierzu rufen Sie über das Kontextmenü im Explorer das Dialogfenster „Eigenschaften“ auf und klicken dann auf den Button „Erweitert”. Sie finden diesen Button am unteren Ende des Dialogfensters. Es öffnet sich nun ein Dialogfenster zur Editierung der „Erweiterten Eigenschaften“. Sie finden hier bis zu 100 Eigenschaften denen bestimmte Werte zugewiesen werden können. Die Namen der Eigenschaften sind die originalen Termini der in OpenCms verwendeten XML-Sciptsprache. Vorsicht, die leeren Felder verbergen die geerbten Werte der Grundeinstellung.

Bitte verändern Sie in diesem Formular keinen Wert. Auch die vermeintlich leeren Felder dürfen nicht mit Einträgen versehen werden. Geerbte Werte für die Eigenschaften werden dann überschrieben. Fehler und Störungen sind dann die Folgen

Suchen Sie nun die Eigenschaft „calendar.show“ und tragen in das Eingabefeld den Wert „right“ ein (Der Begriff „true“ steht für „Wahr” bzw. „Ja”). Speichern Sie diesen Eintrag nun mit dem Button „OK”.

Abb: Tragen sie in den erweiterten Eigenschaften "right" oder "left" in das Eingabefeld "calendar.show" ein um das Kalendermodul auf Ihren Seiten anzuzeigen

Nachdem Sie diese Eigenschaft gesetzt haben, können Sie den Ordner (oder die Seite) an dem dieser Wert verändert wurde veröffentlichen. Sie sehen nun den Kalender im Template in der rechten oder linken Spalte im so genannten „Seitenelement”:

calender.show = "right" oder auch "true"
Wenn Sie eine Info-Box für Nachrichten, Termine oder Gottesdienste geschaltet haben (über das Kontextmenü im Menüpunkt „Eigenschaften” Auswahl: Layout rechts) dann erscheint der Kalender immer unter der Info-Box.
Calender.show = "left"
Der Kalender erscheint im linken Seitenelement immer unter der vertikalen Seitenavigation

Kalender einstellen

Nun müssen Sie festlegen, welche Informationen der Kalender aufrufen soll. Sie können den Kalender für tagesaktuelle Artikel verwenden. Folgende Typen von Verwaltungsmodulen stehen hierzu zu Verfügung:

Veranstaltungen im Verzeichnis / Ordner: ../modules/events
Gottesdienste im Verzeichnis / Ordner: ../modules/gottesdienste
Aktuelle Meldungen im Verzeichnis / Ordner: ../modules/news

Abb: Die zu durchsuchenden Verzeichnisse müssen in der Datei "configuration_calendar" eingestellt werden

Diese Einstellungen nehmen Sie in der Datei „configuration_calender” vor. Sie finden diese Konfigurationsdatei in dem Konfigurationsordner (_configuration) Ihrer Microsite:

Ordner „_configuration”: Wechseln Sie in das Verzeichnis „_configuration”.
Datei „configuration_calender”: Über das Kontextmenü im Explorer rufen Sie die Einstellungsdatei „configuration_calender” durch einen Klick auf den Menüpunkt „Bearbeiten” auf.
Feldgruppe „Kalender Eintrag [1]”: Nach dem sich der Formulareditor zu Bearbeitung geöffnet hat klicken Sie auf das „grüne Plus” um die Eingabefelder für die Auswahl des gewünschten Verwaltungsmodul zu aktivieren.
Auswahlbox „Ressource Typ”: Nach dem Sie die Eingabefelder aktiviert haben, wählen Sie nun den Modultyp (Ressource Typ). Die Auswahlbox bietet Ihnen die drei Modultypen an.
Feld „Ordner”: Wenn Sie den Typ festgelegt, haben tragen Sie im folgenden Arbeitsschritt das Verzeichnis des gewünschten Moduls ein. Hierzu steht Ihnen die Schaltfläche „Suchen“ am Ende des Eingabefeldes zur Verfügung. In dem neuen Fenster können Sie mit Hilfe des Dateibaums die entsprechende Auswahl tätigen. Wechseln Sie hierzu in den Ordner „modules“ im Hauptverzeichnis Ihrer Microsite.

Beachten Sie, dass je nach gewähltem Modul (Resource Typ) das dazugehörige Modul-Verzeichnis gewählt wird. Folgende Einstellungen sind bindend:

Veranstaltungen = ../modules/events

Gottesdienste = ../modules/gottesdienste

Aktuelle Meldungen = ../modules/news

Es muss der gesamte Verzeichnispfad nur bis zu dem jeweiligen Ordner eintragen sein. Es darf keine HTML-Seite in dem gewünschten Ordner angeklickt werden. Ein korrekter Pfad für den gewünschten Modulordner lautet z.B. für Veranstaltungen der Gemeinde St. Nikolaus und Karl Borromäus: /st-nikolaus-karl-borromaeus/modules/events/

Der Kalender kann die Inhalte beliebig vieler Module abrufen. Das heisst Sie können Artikel aus mehreren Modulen abrufen: Veranstaltungen, Gottesdienste und / oder aktuellen Meldungen. Die Voraussetzung hierzu ist der Dateizugriff auf das Verzeichnis der gewünschten Ressource.

Wenn Sie nun den Kalender mit einem weiteren Modul (Resource Typ) verknüpfen wollen, rufen Sie ein neues Eingabefeld auf. Klicken Sie hierzu auf das „grüne Kreuz” rechts neben den Eingabefeldern. Je nach gewünschter Anzahl können Sie durch weitere Klicks neue Einträge definieren. Füllen Sie anschließend die Eingabefelder wie oben beschrieben aus.

Mit dem „grünen Kreuz“ fügen Sie neue Felder oder Feldgruppen hinzu

Mit dem „roten Andreaskreuz“ löschen Sie Felder oder Feldgruppen

Kalender optisch anpassen

Der Kalender kann sich in seinem Erscheinungsbild den farblichen Einstellungen Ihrer Site komplett anpassen. Hierzu finden Sie im Ordner „_configuration“ eine Datei mit dem Namen „calender_css“. Nachdem Sie diese Datei mit Hilfe des Menüeintrages „Bearbeiten“ im Kontextmenü zum editieren aufgerufen haben, können Sie die Farbwerte entsprechend Ihren Wünschen anpassen.

Abb: Die Datei "calendar_css" bestimmt das farbliche Erscheinungsbild des Kalenders

Manuelles Einstellen der Farbeinstellungen

Wenn Sie sich bei der Farbauswahl nicht sicher sind, ob die für das Kalendermodul gewählten Farben zu Ihrer Website passen, so bietet sich die folgende Herangehensweise:

Öffnen Sie eine Ihrer Internetseite auf der das Kalendermodul bereits aktiviert worden ist. Verkleinern Sie das Fenster soweit, dass Sie den Kalender und das Umfeld noch gut sehen können.
Im Online-Explorer wechseln Sie in das Verzeichnis „_configuration“
Über das Kontextmenü im Online-Explorer rufen Sie die Einstellungsdatei „calender_css” über den Menüpunkt „Bearbeiten” auf.
Positionieren Sie nun das Fenster des Bearbeitungsformulars neben der HTML-Seite mit der Ansicht des Kalenders so, das beide Fenster nebeneinander liegen und gut zu sehen sind.
Verändern Sie nun die gewünschten Werte und speichern diese Änderung.
Aktualisieren Sie die Internetseite mit der Kalenderansicht und überprüfen Sie das Ergebnis.

Die Internetseite im Browser (Internet Explorer oder Mozilla Firefox) aktualisieren Sie über den Button „Aktualisieren“ oder mit dem Tasten-Kurzbefehl „Strg“ + „F5“ (beide Tasten gleichzeitig drücken).

Übernehmen der Farbeinstellungen aus dem Template

Mit der einfachen aber effektiven Methode „Versuch und Irrtum“ probieren Sie so lange, bis Sie das gewünschte farbliche Ergebnis erzielen. Wenn Sie jedoch die exakten Farbwerte direkt aus Ihrem Template übernehmen wollen, müssen Sie in die entsprechende Konfigurationsdatei „configuration_css“ für das Template-Layout aufrufen und die Werte (Hexadezimalwerte z.B. #000000) notieren bzw. direkt übertragen.

Folgende Herangehensweise ist hierbei sinnvoll:

Wenn Sie hierzu beide Konfigurationsdateien nebeneinander öffnen wollen, müssen Sie sich ein zweites Mal in OpenCms als Benutzer anmelden.
Nachdem sie sich ein zweites Mal angemeldet haben wechseln Sie im Online-Explorer in den Konfigurationsordner „_configuration“) Ihrer Microsite.
In diesem Verzeichnis finden Sie die Datei „configuration_css“. Öffnen Sie bitte diese Datei über das Kontextmenü indem Sie auf das Symbol klicken und dann den Menüpunkt „Bearbeiten“ wählen.
Nachdem sich das Fenster zur Bearbeitung des Templates geöffnet hat, positionieren Sie beide Fenster so das Sie nebeneinander zu betrachten sind.
Nun können Sie die Farb- und Einstellungswerte bequem übertragen.
Testen Sie alle Veränderungen an einer geöffneten HTML-Seite aus Ihrer Site indem Sie die Seite immer wieder aktualisieren (wie oben beschrieben).
Speichern Sie die Konfigurationsdatei Ihres Kalenders nach der Überprüfung ab oder Veröffentlichen diese sofort. Die Button „Veröffentlichen“ oder „Speichern und Schließen“ finden Sie oben am Konfigurationsfenster.