Calendar ical: Unterschied zwischen den Versionen

Aus Contao Community Documentation

K (div. Korrekturen)
Zeile 1: Zeile 1:
 
[[Kategorie:Extensions]]
 
[[Kategorie:Extensions]]
  
Erzeugen Sie iCal-Dateien von Ihren Contao-Kalendern oder importieren Sie iCal-Dateien in Ihre Contao-Kalender.
+
Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.
  
 
{{ExtInfo
 
{{ExtInfo
Zeile 19: Zeile 19:
 
* Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.
 
* Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.
 
* Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.
 
* Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.
* Einem Abonnement, mit dem Sie einzelne Kalender für Kalenderprogramme zur Verfügung stellen können.
+
* Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.
  
 
=== Export von Contao-Kalendern als iCal-Dateien ===
 
=== Export von Contao-Kalendern als iCal-Dateien ===
  
Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, können Sie einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.
+
Mit dem Inhaltselement '''iCal''' können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird.
Im Feld Titel-Präfix haben Sie die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.
+
Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.
  
 
[[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]
 
[[Datei:ical_ce.png|Parameter des iCal-Inhaltselements|center|frame]]
  
Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber Sie verwenden die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.
+
Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.
 
=== Import von iCal-Kalenderdateien in Contao-Kalender ===
 
=== Import von iCal-Kalenderdateien in Contao-Kalender ===
  
Wenn Sie sich im Contao Backend in einem Kalender befinden (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhalten Sie im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':
+
Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel '''Kalender importieren''':
  
 
[[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]
 
[[Datei:ical_import.png|Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender|center|frame]]
  
Wenn Sie auf diesen Verweis klicken, erhalten Sie die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics aus Ihrer Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass Sie die iCal-Datei vorher bereits in Ihre Dateiverwaltung hochgeladen haben. Für den Import müssen Sie neben der Auswahl der iCal-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der iCal-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.
+
Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal-Datei vorher bereits in Ihre Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der iCal-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der iCal-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.
  
 
[[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]
 
[[Datei:ical_import_selection.png|Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei|center|frame]]
Zeile 41: Zeile 41:
 
Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:
 
Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:
  
Wenn Sie eine iCal-Datei importieren, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao Sie auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollten Sie nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.
+
Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.
  
 
[[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]
 
[[Datei:ical_import_no_tz.png|Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone|center|frame]]
  
Wenn Sei eine iCal-Datei importieren, die eine andere Zeitzone hat als die Ihres Contao-Systems, so erhalten Sie einen Warnhinweis, der Sie auf diesen Umstand aufmerksam macht. Sie haben außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone Ihres Contao-Systems zu setzen, wenn Sie vermuten, dass die Termine eigentlich mit der identischen Zeitzone Ihres Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich "falschen" Zeitzonen-Einstellung Ihres Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn Sie das Kontrollkästchen nicht auswählen, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.
+
Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich "falschen" Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.
  
 
[[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]
 
[[Datei:ical_import_wrong_tz.png|Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei|center|frame]]
Zeile 52: Zeile 52:
 
=== Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===
 
=== Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme ===
  
Einzelne Kalender können Sie gezielt als Abonnements für externe Kalenderprogramme anbieten. Gehen Sie dazu in die Bearbeitung der Events und Bearbeiten Sie einen existierenden Kalender:
+
Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:
  
 
[[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]
 
[[Datei:ical_be_edit.png|iCal Abonnement Einstellungen eines Kalenders|center|frame]]
  
Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis ihrer Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL können Sie dann beliebig in Ihren Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.
+
Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.
  
Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, können Sie eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.
+
Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird.
Im Feld Titel-Präfix haben Sie die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.
+
Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.
  
 
--[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)
 
--[[Benutzer:Hschottm|Hschottm]] 13:21, 11. Sep. 2010 (CEST)

Version vom 12. September 2010, 16:56 Uhr


Erzeugt iCal-Dateien von Contao-Kalendern oder importiert iCal-Dateien in den Contao-Kalender.


Erweiterungs-Übersicht
Name des Entwicklers Helmut Schottmüller (hschottm)
Entwickler Webseite http://www.aurealis.de
Version der Erweiterung 1.3.0
Kompatibilität mit Contao Version 2.9.0 - 2.9.1
Kompatibilität mit TYPOlight Version 2.8.0 - 2.8.4
Link zum Extension Repository http://www.contao.org/erweiterungsliste/view/calendar_ical.de.html
Den Entwickler unterstützen http://aurealis.de/spenden.html


calendar_ical (iCal-Dateien erzeugen und importieren)

Die Erweiterung besteht aus drei Komponenten:

  • Einem Inhaltselement, das aus einem oder mehreren Contao-Kalendern für einen angegebenen Zeitraum einen Download-Link auf eine iCal-Kalenderdatei erzeugt. Der Download-Link kann verwendet werden, um den Kalender in einer externen Kalenderanwendung, wie z.B. Apple iCal zu abbonieren.
  • Einem Import-Wizard, mit dem man in die Dateiverwaltung hochgeladene iCal-Dateien (.ics) in einen beliebigen Kalender importieren kann.
  • Einem Abonnement, mit dem man einzelne Kalender für Kalenderprogramme zur Verfügung stellen kann.

Export von Contao-Kalendern als iCal-Dateien

Mit dem Inhaltselement iCal können einer oder mehrere Contao-Kalender als iCal-Download im Frontend zur Verfügung gestellt werden. Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man einen Titel für den Download-Link angeben, der zugleich der Names des Kalenders in der iCal-Exportdatei sein wird. Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.

Parameter des iCal-Inhaltselements

Die iCal-Exportdatei kann über den angebotenen Hyperlink heruntergeladen werden oder aber man verwendet die Download-URL als URL für ein Kalenderabonnement in einer iCal-fähigen Kalendarapplikation, wie z.B. Apple iCal.

Import von iCal-Kalenderdateien in Contao-Kalender

Wenn man sich im Contao Backend in einem Kalender befindet (Kategorie Kalender/Events mit anschließender Auswahl eines Kalenders), so erhält man im oberen Teil des Kalenders bei den globalen Funktionen einen zusätzlichen Verweis mit dem Titel Kalender importieren:

Import-Verweis zum Importieren von iCal-Dateien in Contao-Kalender

Wenn man auf diesen Verweis klickt, erhält man die Möglichkeit, eine iCal-Kalenderdatei mit der Dateiendung .ics aus der Dateiverwaltung in den ausgewählten Contao-Kalender zu importieren. Dies setzt voraus, dass man die iCal-Datei vorher bereits in Ihre Dateiverwaltung hochgeladen hat. Für den Import muss man neben der Auswahl der iCal-Datei außerdem ein Start- und Enddatum für die zu importierenden Termine angeben. Alle Termine, die sich innerhalb dieses Zeitraums in der iCal-Datei befinden, werden beim Import in Ihren Contao-Kalender übernommen.

Auswahl einer iCal-Datei und des Import-Zeitraums beim Import einer iCal-Datei

Während des Imports können zwei Fälle auftreten, denen besondere Beachtung geschenkt werden sollte:

Wenn man eine iCal-Datei importiert, der die Angabe einer Zeitzone fehlt (was z.B. bei iCal-Dateien der Fall ist, die aus Microsoft Outlook Versionen bis Microsoft Office 2003 exportiert werden), so fordert Contao einem auf, eine Zeitzone für die Importdatei anzugeben. Dabei sollte man nach Möglichkeit die Zeitzone auswählen, die bei der Erstellung der Termine verwendet wurde, weil es ansonsten zu unbeabsichtigten Zeitverschiebungen kommen kann.

Auswahl einer Zeitzone beim Import von iCal-Dateien ohne Zeitzone

Wenn man eine iCal-Datei importierz, die eine andere Zeitzone hat als die des Contao-Systems, so erhält man einen Warnhinweis, der auf diesen Umstand aufmerksam macht. Man hat außerdem die Möglichkeit, durch die Auswahl eines Kontrollkästchens die Zeitzone der Importdatei auf die Zeitzone des Contao-Systems zu setzen, wenn man vermutet, dass die Termine eigentlich mit der identischen Zeitzone des Contao-Systems hätten erstellt werden sollen (was z.B. bei einer versehentlich "falschen" Zeitzonen-Einstellung des Contao-Systems oder des externen Kalender-Programms der Fall sein kann). Wenn man das Kontrollkästchen nicht auswählt, werden die Termine entsprechend der im externen Kalenderprogramm verwendeten Zeitzone in Contao importiert. Dabei wird es in den meisten Fällen zu einer Zeitverschiebung bei den importierten Terminen kommen, da diese nun in der in Contao voreingestellten Zeitzone angezeigt werden.

Optionale Korrektur der Zeitzone bei einem Zeitzonenunterschied von Contao-System zu Importdatei

Da Contao in seinen Kalendern nicht über eine separate Ortsangabe verfügt, werden Termine, die einen Ort enthalten so importiert, dass der eingetragene Ort mit der Kennung Ort: in die Beschreibung des Termins übernommen wird.

Abonnieren von einzelnen iCal-Kalenderdateien in Kalenderprogramme

Einzelne Kalender kann man gezielt als Abonnements für externe Kalenderprogramme anbieten. Dazu geht man in die Bearbeitung der Events und bearbeitet einen existierenden Kalender:

iCal Abonnement Einstellungen eines Kalenders

Das Kalender-Alias ist der Dateiname, unter dem der iCal-Kalender im Hauptverzeichnis der Contao-Installation zur Verfügung stehen wird (als http://IHRE_Contao_INSTALLATION/kalenderalias.ics). Diese URL kann man dann beliebig in den Webseiten verwenden oder als Abonnement für Kalenderprogramme weitergeben.

Neben einem Zeitraum, innerhalb dessen Termine aus den ausgewählten Contao-Kalendern extrahiert werden, kann man eine Beschreibung für den Kalender angeben, die beim Abonnieren in externen Kalenderprogrammen, wie z.B. Apple iCal oder Microsoft Outlook angezeigt wird. Im Feld Titel-Präfix hat man die Möglichkeit, den Titeln aller Termine eine bestimmte Zeichenkette voranzustellen.

--Hschottm 13:21, 11. Sep. 2010 (CEST)

Ansichten
Meine Werkzeuge

Contao Community Documentation

noch 4 mal das Wort Abstraktion und ich beginne Zigaretten zu rauchen...

Martin Mildner
Navigation
Verstehen
Verwenden
Entwickeln
Verschiedenes
Werkzeuge