.. contents:: Contents .. section-numbering:: .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV ======== `CalDAV`_ ======== `CalDAV`_ is an Internet standard allowing a client to access scheduling information on a remote server. It extends WebDAV (HTTP-based protocol for data manipulation) specification and uses iCalendar format for the data. The protocol is defined by RFC 4791. .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV -- Wikipedia -------- People -------- `Jan Schneider`_ .. _`Jan Schneider`: https://wiki.horde.org/JanSchneider?referrer=CalDAV ------------- Description ------------- Horde, specifically the Kronolith and Nag modules for calendaring and tasks management, support `CalDAV`_ in two ways: it can be used as a `CalDAV`_ server for external calendar clients, providing a central cloud storage for multiple devices of the users. And it can use an external `CalDAV`_ server as a calendar client on its own, to display this server's events inside Horde. .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV Horde utilizes the 3rd party `SabreDAV`_ library for the grunt work of implementing the `CalDAV`_ and related protocols. .. _`SabreDAV`: http://sabre.io/dav/ .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV Full `CalDAV`_ support has been added with Horde 5.1/Kronolith 4.1/Nag 4.1. .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV --------------- Configuration --------------- The Horde_Dav library is automatically pulled in as a dependency when installing Kronolith or Nag. The necessary database tables can be created as usual from the Horde configuration screen or via horde-db-migrate. The storage backend for all DAV operations has to be enabled in the Horde configuration screen. ------------------- Service Discovery ------------------- Some `CalDAV`_ clients support automatic discovery of the `CalDAV`_ service end points just by providing the user's email address or a host name. To enable service discovery, redirect aliases have to be set in your web server's configuration. The redirect target is either the horde/rpc/ directory if you have "pretty" URLs enabled in your Horde configuration, or the horde/rpc.php file otherwise. This is an example for Apache web servers: .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV :: RedirectPermanent /.well-known/caldav /horde/rpc/ See your web server's documentation about how to set up redirects. DNS === Service Discovery can also be implemented via DNS setup. Please refer to `SabreDAV Service Discovery`_ for details. .. _`SabreDAV Service Discovery`: http://sabre.io/dav/service-discovery/ ---------------------- Client configuration ---------------------- There are two different kind of `CalDAV`_ service end points which may or may not be supported by different clients: .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV * **Principal URLs** are single URLs for each individual user. These provide information about the user himself, and all of his available (`CalDAV`_ and `CardDAV`_) resources. * **Calendar URLs** are URLs for each individual calendar (or task list). Clients not supporting Principal URLs require users to enter each Calendar URL individually. They are also required if users want to suscribe to shared calendars or task lists of other users. Both types of URLs can be retrieved from the calendars' and task lists' edit forms. In the Kronolith/Nag interface click on the edit icon next to an calendar/task list name and copy the required URL from there. .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV .. _`CardDAV`: https://wiki.horde.org/CardDAV?referrer=CalDAV ---------- Features ---------- This is a list of devices known to work with Horde's `CalDAV`_ implementation. Please update if you gather new information, or have more detailed knowledge about the supported features or versions. .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |Client/Device |Principal URLs|Calendar URLs|Service Discovery|Notes | +=========================================================+==============+=============+=================+========================================================================================================+ |*Desktop Clients* | | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |Thunderbird/Lightning |No |Yes | |Confirmed with Thunderbird | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |Thunderbird/`TbSync`_ |Yes |Yes | |TB 68.*-69.*, works with `Provider for CalDAV & CardDAV`_ (also with `Provider for Exchange ActiveSync`_| +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |`Outlook CalDav Synchronizer`_ (Outlook `CalDAV`_ Plugin)|Yes |Yes |Yes | | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |Apple iCal |Yes | |Yes |Confirmed with iCal 5.0/OS X 10.7 | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |Evolution |Yes |Yes | |Confirmed with Evolution 3.22 | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |*Mobile Devices* | | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |`DAVx5`_ (Android) |Yes |Yes |Yes | | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |`CalendarSync`_ (Android) |Yes |Yes |Yes | | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |`CalDAV-Sync`_ (Android) |Yes | |Yes | | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |iOS |Yes | |Yes | | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ |BlackBerry |Yes |Yes | |Tested with BB10 simulator | +---------------------------------------------------------+--------------+-------------+-----------------+--------------------------------------------------------------------------------------------------------+ .. _`TbSync`: https://addons.thunderbird.net/en-US/thunderbird/addon/tbsync/ .. _`Provider for CalDAV & CardDAV`: https://addons.thunderbird.net/en-US/thunderbird/addon/dav-4-tbsync/ .. _`Provider for Exchange ActiveSync`: https://addons.thunderbird.net/en-US/thunderbird/addon/eas-4-tbsync/ .. _`Outlook CalDav Synchronizer`: https://sourceforge.net/projects/outlookcaldavsynchronizer/ .. _`DAVx5`: https://www.davx5.com .. _`CalendarSync`: https://play.google.com/store/apps/details?id=com.icalparse .. _`CalDAV-Sync`: http://dmfs.org/caldav .. _`CalDAV`: https://wiki.horde.org/CalDAV?referrer=CalDAV -------------------------- Issues with moving horde -------------------------- - Moving horde's webroot or changing from pretty to traditional urls may break caldav/carddav requests. Fixing involves the client re-discovering the calendar (thunderbird: unsubscribe, re-register) -------------------------------- Know Missing features (by app) -------------------------------- Kronolith/Calendar ================== - Some handling of unknown properties (like X-Mozilla-Something) Nag/Tasks ========= - Support for long icalendar vtodo summaries / nag task titles - Some handling of unknown properties (like X-Mozilla-Something) - Multiple attendees/assignees Turba/Addressbook ================= - Not dropping properties unmapped to the backend - incomplete handling of backend-driven changes behind turba's back (namely LDAP)