====== Kalenderpflege mit dem Google-Kalender und icalevents ======

<note important>Die Schreibweise für die Plugin-Syntax hat sich verändert. Bei OSP Versionen 1.0.x muss man schreiben 
  {{iCalEvents>...}}
bei neueren Versionen wie hier beschrieben 
  {{icalevents>...}}
</note>

{{:dokumentation:googlecal.png?200  |}}
Ein zentraler Punkt in der Schulorganisation ist ein (öffentlicher) Terminkalender.

Eine Möglichkeit, diesen Kalender zu managen ist es, den Kalender bei [[http://www.google.com/calendar/|google-Kalender]] zu führen und diesen dann in die Schulhomepage und/oder das Portfolio einzubinden((Datenschutzaspekte möchte ich hier nicht beleuchten - selbstverständlich ist der Datenschutz zu beachten, dieses Vorgehen eignet sich also nur für öffentliche Kalender wirklich gut.))

OSP bringt zu diesem Zweck das Plugin **icalevents** bereits mit - Sie müssen das Plugin **nicht** nachinstallieren((Man **darf das Plugin nicht nochmals nachinstallieren**, da OSP eine angepasste Version bereitstellt. Eine doppelte Installation führt zu Fehlern)).

  * Zunächst benötigt man einen google-Account, um auf den Google-Kalenderdienst zuzugreifen. Sekretariat oder beauftragte Kollegen tragen die Termine im Kalender ein.
  * Der Kalender muss nicht öffentlich freigegeben sein, es reicht die private Adresse des Kalenders zu kennen. [[kalender_google#woher_bekomme_ich_die_kalenderadresse|Diese Adresse kann man nach der Anmeldung in den Einstellungen des google-Kalenders  ermitteln]].

Nun kann man auf einer Portfolioseite (''kalender'') die Anweisung für das icalevents-Plugin einfügen:

  {{icalevents>http://www.google.com/calendar/ical/<Benutzer>/private-<hash>/basic.ics#from=today&previewDays=400}}

Die Paremeter ''from'' und ''previewdays'' geben dabei an, von welchem Tag an und wie viele Tage von dort in die Zukunft die Termine angezeigt werden sollen - hier alle Termine die von heute ab maximal 400 Tage in der Zukunft liegen. Man erhält eine Liste wie die folgende:

{{  :dokumentation:terminliste.png?700  |}}

===== Einstellungen des Plugins =====

Das Plugin verfügt in der mit OSP ausgelieferten angepassten Version über zwei Optionen, die unter ''Admin''->''Konfiguration''->''Icalevents Plugin-Konfiguration'' angepasst werden können((Die Beschreibungen der Optionen müssen noch erledigt werden, kommt in einer der nächsten Versionen von OSP...)):

{{  :praxistipps:icalevents_settings.png?640  |}}

  * Ist die erste Option ''plugin_icalevents_list_desc_as_acronym'' angehakt, wird die Beschreibung eines Termins (wenn eine solche eingegeben wurde) beim Drüberfahren mit der Maus als "Tooltip" angezeigt.
  * Die zweite Option ''plugin_icalevents_list_split_months'' legt fest, ob die Liste in Monate gesplittet werden soll oder nicht. Ich das Häkchen nicht gesetzt, erscheint eine einzige lange Terminliste, bei gesetztem Haken wird pro Monat eine eigene Tabelle erzeugt.


===== Woher bekomme ich die Kalenderadresse? =====

Die kalenderadresse kann in google-Calendar herausfinden:

  - oben rechts Einstellungen-Kalendereinstellungen wählen.
  - dann oben links den Reiter "Kalender" in
  - diesem Feld dann den Kalender wählen den du einbinden möchtest

{{ :praxistipps:googlecal08.png?590 |}}


Auf der Kalender-Einstellungsseite ganz unten gibt es dann das Feld **Privatadresse** mit dem grünen ICAL Button. Wenn man da draufklickt, wird die private Kalenderadresse in einem PopUp-Fenster angezeigt - hier kann man die Adresse markieren und kopieren, um sie dann dem icalevents-Plugin einzuverleiben.

{{  :praxistipps:googlecal09.png?590  |}}

===== Weitere Plugins.... =====

Auf der  [[http://www.dokuwiki.org/plugins?plugintag=calendar|Plugin-Seite von Dokuwiki]] finden sich noch andere Plugins, die mit dem google-Kalender zusammenarbeiten.