Diff for TurbaModule between 13 and 14

+ Turba, the Horde Address Book

Turba can be configured to provide multiple address books from multiple backends. This is done in {{turba/config/sources.php}}.

Supported backends are:
* SQL (i.e. localsql)
* LDAP (see ExistingLDAPHowTo, which includes address book configuration information, and NewLDAPHowTo for general LDAP setup)
* Kolab
* IMSP (docs soon to follow at http://cyrusimap.web.cmu.edu/twiki/bin/view/Cyrus/OtherCyrusSoftware )

++ Nomenclature and architecture

* Turba can manage any number of different **sources**, each source can use a different backend driver like LDAP or SQL and utilize a different address book scheme. Administrators can set permissions for each source.
* SQL sources can be used as a backend for **shares**. These are address books that each users can create and share with other users and groups.
* The user can also create (shareable) **virtual address books**, which are basically saved searches.
* All those, i.e. non-shared sources, the shares that the user has permissions for, and the user's virtual address books appear as **address books** in the user's interface.
* The user can further create **distribution list** next to regular contacts in any address book that he has write access to. Distribution lists can contain contacts from any available address book, but other users can of course only see those contacts in the list that they also have permissions for.

++ Arbitrary information

Someone's !OpenLDAP/Turba howto:

@@--- http://ww2.redant.ca/consulting/ldap/turba.php +++ dead link, see http://web.archive.org/web/20060708192705/http://ww2.redant.ca/consulting/ldap/turba.php @@

**[Turba 2.1 and later]:** For shared address books add the following to the bottom stanza of the source declaration:

    'use_shares' => true,

Hit the icon next to All Permissions to add the new top level permissions for Address Book (turba).

Select the key icon next to Address Book (turba) and add permissions for the Sources.

Select the key icon next to Sources and add the address book you want to establish permissions for.

Select the notepad icon to modify the permissions on the address book.  In order for the groups to work you must have the !DataTree tied to a valid source (SQL or hooks) or LDAP.

++ External Links

Syncing the iPhone addressbook with Horde: http://edeca.net/wp/2010/01/syncing-the-iphone-addressbook-with-horde/
Modifying fields in the Turba addressbook: http://edeca.net/wp/2010/01/modifying-fields-in-the-turba-addressbook/
Someone's !OpenLDAP/Turba howto: http://web.archive.org/web/20060708192705/http://ww2.redant.ca/consulting/ldap/turba.php