SetUpThunderbirdLightningCalDAVClient - Revision history

Khgras at 06:40, 30 August 2012

2012-08-30T06:40:37Z

← Older revision		Revision as of 06:40, 30 August 2012
Line 1:		Line 1:
	= CalDAV access via Thunderbird/Lightning ~~(Preliminary)~~ =		= CalDAV access via Thunderbird/Lightning =
	This article describes how the Open-Xchange server can be accessed via its CalDAV interface using the Mozilla Thunderbird client with the Lightning Add-on.		This article describes how the Open-Xchange server can be accessed via its CalDAV interface using the Mozilla Thunderbird client with the Lightning Add-on.

Tobias.friedrich at 10:08, 13 August 2012

2012-08-13T10:08:25Z

← Older revision		Revision as of 10:08, 13 August 2012
Line 67:		Line 67:
	* Appointments classified as "private" are exported by the server with the "CLASS" property set to "PRIVATE"		* Appointments classified as "private" are exported by the server with the "CLASS" property set to "PRIVATE"
	* iCal events with the "CLASS" property set to either "CONFIDENTIAL" or "PRIVATE" are treated in the same way by the server and are imported as "private" appointments		* iCal events with the "CLASS" property set to either "CONFIDENTIAL" or "PRIVATE" are treated in the same way by the server and are imported as "private" appointments
			* Since "private" appointments with participants are not supported by the server, saving such an appointment results in the participants being removed implicitly during import.

	== Debug Options ==		== Debug Options ==
	In case of synchronization problems, the built-in error console of Mozilla Thunderbird may provide valuable information. The error console can be opened via "Tools" -> "Error Console". To increase the loglevel of the Lightning Add-on, open the config editor by selecting "Tools" -> "Options..." -> "Advanced" -> "Config Editor..." and set the properties "calendar.debug.log" and "calendar.debug.log.verbose" to "true".		In case of synchronization problems, the built-in error console of Mozilla Thunderbird may provide valuable information. The error console can be opened via "Tools" -> "Error Console". To increase the loglevel of the Lightning Add-on, open the config editor by selecting "Tools" -> "Options..." -> "Advanced" -> "Config Editor..." and set the properties "calendar.debug.log" and "calendar.debug.log.verbose" to "true".

Tobias.friedrich at 07:18, 6 August 2012

2012-08-06T07:18:37Z

← Older revision		Revision as of 07:18, 6 August 2012
Line 10:		Line 10:

	== Discover the CalDAV URL of your Calendar Folders ==		== Discover the CalDAV URL of your Calendar Folders ==
	In contrast to some other clients, Thunderbird/Lightning is not able to discover all the available calendar collections automatically. Instead, each calendar folder needs to be added seperately in the client. To do so, one needs to know the CalDAV URLs of the calendar folder that should be synchronized with the client. This URL is ~~shown~~ in the Groupware web-interface ~~when selecting "Properties" from~~ the folder's context menu. The CalDAV URL is ~~then~~ shown in ~~properties page of~~ the ~~folder~~.		In contrast to some other clients, Thunderbird/Lightning is not able to discover all the available calendar collections automatically. Instead, each calendar folder needs to be added seperately in the client. To do so, one needs to know the CalDAV URLs of the calendar folder that should be synchronized with the client. This URL is displayed in the properties-page in the Groupware web-interface.

			{\|
			\| [[image:CalDAV_URL_Step1.png\|thumb]] \|\|
			* Open a webbrowser and login to the groupware web-interface
			* From the folder tree, open the context menu of a calendar folder and select "Properties"
			\|-
			\| [[image:CalDAV_URL_Step2.png\|thumb]] \|\|
			* The CalDAV URL is shown in the content area. Note down the URL or copy it to the clipboard.
			\|}

	== Add a Calendar in Thunderbird/Lightning ==		== Add a Calendar in Thunderbird/Lightning ==

Tobias.friedrich at 08:31, 1 August 2012

2012-08-01T08:31:52Z

← Older revision		Revision as of 08:31, 1 August 2012
Line 1:		Line 1:
	= CalDAV access via Thunderbird/Lightning =		= CalDAV access via Thunderbird/Lightning (Preliminary) =
	This article describes how the Open-Xchange server can be accessed via its CalDAV interface using the Mozilla Thunderbird client with the Lightning Add-on.		This article describes how the Open-Xchange server can be accessed via its CalDAV interface using the Mozilla Thunderbird client with the Lightning Add-on.

Tobias.friedrich: /* Reminders */

2012-07-11T11:26:54Z

Reminders

← Older revision		Revision as of 11:26, 11 July 2012
Line 49:		Line 49:
	* Multiple reminders in an event are not supported by the OX server and are discarded.		* Multiple reminders in an event are not supported by the OX server and are discarded.
	* Only reminders of type "DISPLAY" are supported by the OX server, reminders of other iCal types are discarded.		* Only reminders of type "DISPLAY" are supported by the OX server, reminders of other iCal types are discarded.
	* When dismissing reminders of recurring appointments in the Mozilla Lightning client, the reminder is removed from the whole recurring appointment object, since it's not possible to determine to ~~shich~~ occurrence the dismiss action belongs to.		* When dismissing reminders of recurring appointments in the Mozilla Lightning client, the reminder is removed from the whole recurring appointment object, since it's not possible to determine to which occurrence the dismiss action belongs to.

	=== Unsupported Properties ===		=== Unsupported Properties ===

Tobias.friedrich at 11:59, 9 July 2012

2012-07-09T11:59:22Z

← Older revision		Revision as of 11:59, 9 July 2012
Line 16:		Line 16:

	{\|		{\|
	\| [[image:LightningSetup_Step1~~.png\|thumb]] [[image:LightningSetup_Step2~~.png\|thumb]] \|\|		\| [[image:LightningSetup_Step1.png\|thumb]] \|\|
	* Select "Events and Tasks" -> "Calendar" from the menu bar to switch to the Calendar view		* Select "Events and Tasks" -> "Calendar" from the menu bar to switch to the Calendar view
			\|-
			\| [[image:LightningSetup_Step2.png\|thumb]] \|\|
	* From the menu bar, select "File" -> "New" -> "Calendar..."		* From the menu bar, select "File" -> "New" -> "Calendar..."
	\|-		\|-

Tobias.friedrich: Created page with "= CalDAV access via Thunderbird/Lightning = This article describes how the Open-Xchange server can be accessed via its CalDAV interface using the Mozilla Thunderbird client wi..."

2012-07-09T11:57:49Z

Created page with "= CalDAV access via Thunderbird/Lightning = This article describes how the Open-Xchange server can be accessed via its CalDAV interface using the Mozilla Thunderbird client wi..."

New page

= CalDAV access via Thunderbird/Lightning =
This article describes how the Open-Xchange server can be accessed via its CalDAV interface using the Mozilla Thunderbird client with the Lightning Add-on.

== Prerequisites ==
Please ensure that the following preconditions are met before continuing:
* The server has to be configured to support CalDAV / CardDAV as described in [[Caldav_carddav_Bundles]] in order to let this work
* Latest versions of the Mozilla Thunderbird E-Mail client and the Lightning Add-on (check https://addons.mozilla.org/thunderbird/addon/lightning/ and http://www.mozilla.org/thunderbird/ for details)
* In the Mozilla Thunderbird client, an E-Mail account for the user's Open-Xchange mailbox needs to be setup before configuring the CalDAV access

== Discover the CalDAV URL of your Calendar Folders ==
In contrast to some other clients, Thunderbird/Lightning is not able to discover all the available calendar collections automatically. Instead, each calendar folder needs to be added seperately in the client. To do so, one needs to know the CalDAV URLs of the calendar folder that should be synchronized with the client. This URL is shown in the Groupware web-interface when selecting "Properties" from the folder's context menu. The CalDAV URL is then shown in properties page of the folder.

== Add a Calendar in Thunderbird/Lightning ==
As already mentioned, each Calendar folder that should be sychronized has to be added separately in the client. The following steps show how to add a Calendar in Thunderbird/Lightning. Before starting, ensure that the client is connected to the network and the server can be accessed.

{|
| [[image:LightningSetup_Step1.png|thumb]] [[image:LightningSetup_Step2.png|thumb]] ||
* Select "Events and Tasks" -> "Calendar" from the menu bar to switch to the Calendar view
* From the menu bar, select "File" -> "New" -> "Calendar..."
|-
| [[image:LightningSetup_Step3.png|thumb]] ||
* In the popup window, select "On the network" and click "Next >"
|-
| [[image:LightningSetup_Step4.png|thumb]] ||
* As format, select "CalDAV"
* Enter the CalDAV path as reported by the folder's properties page (see above) as location
* For offline access, check the "Cache" checkbox
* Click "Next >" to continue
|-
| [[image:LightningSetup_Step5.png|thumb]] ||
* Enter a name for the Calendar and assign a color if you like
* Select whether reminders should be shown or not
* Select the E-Mail account belonging to the Calendar user from the list
* Click "Next >" to create the Calendar
|-
| [[image:LightningSetup_Step6.png|thumb]] ||
* When requested, enter your username and password for the server
* Afterwards, the Calendar setup is complete and the contents are synchronized
|}

== Limitations ==
Please consider the following known limitations when synchronizing your calendar folders via Thunderbird/Lightning:

=== Reminders ===
* While the iCalendar standard allows to set appointment reminders past due an appointment's start-date, the OX server is not able to save such alarm times and discards them.
* Multiple reminders in an event are not supported by the OX server and are discarded.
* Only reminders of type "DISPLAY" are supported by the OX server, reminders of other iCal types are discarded.
* When dismissing reminders of recurring appointments in the Mozilla Lightning client, the reminder is removed from the whole recurring appointment object, since it's not possible to determine to shich occurrence the dismiss action belongs to.

=== Unsupported Properties ===
* The "URL" property for iCal resources is not supported by the OX server and is discarded.
* Importing or exporting file attachments (property "ATTACH") is not supported via the CalDAV interface

=== Private Appointments ===
* Appointments classified as "private" are exported by the server with the "CLASS" property set to "PRIVATE"
* iCal events with the "CLASS" property set to either "CONFIDENTIAL" or "PRIVATE" are treated in the same way by the server and are imported as "private" appointments

== Debug Options ==
In case of synchronization problems, the built-in error console of Mozilla Thunderbird may provide valuable information. The error console can be opened via "Tools" -> "Error Console". To increase the loglevel of the Lightning Add-on, open the config editor by selecting "Tools" -> "Options..." -> "Advanced" -> "Config Editor..." and set the properties "calendar.debug.log" and "calendar.debug.log.verbose" to "true".