Calendar

Aus FHEMWiki
Version vom 31. Januar 2018, 14:44 Uhr von Baumbuwe (Diskussion | Beiträge) (Vorlage Link2CmdRef)
Calendar
Zweck / Funktion
Anlegen eines Kalenderobjekts
Allgemein
Typ Hilfsmodul
Details
Dokumentation EN / DE
Support (Forum) Unterstützende Dienste/Kalendermodule
Modulname 57_Calendar.pm
Ersteller borisneubert (Dr. Boris Neubert )
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!


Calendar ist ein Hilfsmodul, das Kalenderereignisse aus einer Datei oder einem über die URL angegeben Kalender holt. Der Kalender muss im iCal-Format vorliegen.

Zur Anzeige der Kalenderereignisse kann das Modul CALVIEW verwendet werden.

Voraussetzungen

Wenn die Kalender-URL mit https:// beginnt, muss das Perl Modul IO::Socket::SSL installiert sein (z.B. mit cpan -i IO::Socket::SSL oder mit apt-get install libio-socket-ssl-perl).

Anwendung

Define

Siehe commandref/Calendardefine;

define <name> Calendar ical url <URL> [<interval>]
define <name> Calendar ical file <FILENAME> [<interval>]

Sofern für den Zugriff auf den Kalender Benutzername und Passwort erforderlich sind, können diese in der URL beispielsweise so mit angegeben werden:

define myCalendar Calendar ical url https://user:password@my.domain.com/.../yourcalendar.ics

Attribute

Siehe commandref/Calendarattr;

Anwendungsbeispiel(e)

  • Einbindung von owncloud-Kalendern

Für ownCloud-Kalender muss bei der Definition als <URL> der Link zum Export des jeweiligen Kalenders angegeben werden. Der Link kann in der Weboberfläche von ownCloud gefunden werden. Für ownCloud 9.0 folgt dieser URL z.B. dem folgenden Muster:

http://<ownCloud-Benutzer>:<ownCloud-Passwort>@example.com/owncloud/remote.php/dav/calendars/<ownCloud-Benutzer>/<Kalendername>?export

Der Standard für <Kalendername> ist defaultcalendar

Die Attribute hideOlderThan <timespec> und hideLaterThan <timespec> bewirken, dass nur Kalendereinträge des definierten Zeitraums angezeigt werden. Gerade bei langjährig genutzen Kalendern kann die Datenmenge ansonsten extrem groß werden und schlägt sich in entsprechend langen Update-Runs nieder.

Links

  • Modul, das alle Termine aus einer bestehenden Instanz von Calendar in Readings übernimmt: CALVIEW