• Introduction
• What's provided
• OS/X 10.6 Addressbook

Introduction

CardDAV Directory is a non-standard extension to the CardDAV protocol, implemented by iOS devices and OS/X Addressbook.

The directory acts as a global read-only addressbook. Both clients don't actually allow you to simply browse them, and will always present just a searching interface.

What's provided

SabreDAV does not provide default backends to create your directories, it provides just a simple interface which you must implement to make this work.

The interface Sabre_CardDAV_IDirectory flags the CardDAV plugin to mark an addressbook as a directory.

Furthermore, you must also specify the paths to all global CardDAV directories in the Sabre_CardDAV_Plugin::$directories properties.

This last step is required, because iOS will request locations to CardDAV directories on the principal, so it must be globally known where these are.

OS/X 10.6 Addressbook

The OS/X 10.6 client will not request the list of directories, but it rather assumes that there's one located at the /directory path on the root of the server.

So if you want to support this client as well, ensure that that's the exact location of the global addressbook. Because of this, this client will also not be able to support more than 1 directory.