[commits] [Wiki] created: CalDAV

[Jan Schneider]

jan  Tue, 12 Nov 2013 13:28:33 +0000

Created page: http://wiki.horde.org/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.

-- Wikipedia

++ People

((JanSchneider|Jan Schneider))

++ 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.

Horde utilizes the 3rd party SabreDAV library for the grunt work of  
implementing the CalDAV and related protocols.

Full CalDAV support has been added with Horde 5.1/Kronolith 4.1/Nag 4.1.

++ 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:

<code>
RedirectPermanent /.well-known/caldav /horde/rpc/
</code>

See your web server's documentation about how to set up redirects.

++ Client configuration

There are two different kind of CalDAV service end points which may or  
may not be supported by different clients:

* **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.

++ 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.

||~ Client/Device ||~ Principal URLs ||~ Calendar URLs ||~ Service  
Discovery ||
||~ //Desktop Clients// |||||| ||
|| Thunderbird/Lightning || No || Yes ||  ||
||~ //Mobile Devices// |||||||||| ||
|| !CalDAV-Sync (Android) || Yes ||  || Yes ||
|| iOS || Yes ||  || Yes||