#language en
~-[[DebianWiki/EditorGuide#translation|Translation(s)]]: English-~
----
SOGO Connector is a plugin for the DebPkg:Thunderbird package.

<<TableOfContents(2)>>

= Overview =
The SOGo Connector is a connector for any groupware server like SOGo, !OpenGroupware, DebPkg:Citadel or DebPkg:Owncloud. The SOGo connector works through CardDAV so any application that provides CardDAV functionality will work with the connector.
The connector provides
 * Event organizers
 * CardDAV implementation for the address book
 * Support for WebDAV access control lists (ACL)
 * Free / Busy URL field in the address book
 * Free / Busy functionality through HTTP
 * Synchronization of the address book using GroupDAV

= Installation =
The SOGo connector is available for Wheezy (backports), Jessie, Stretch and Sid. The installation is quite easy with the common tools for installation. Use synaptics, apper or the terminal.
{{{
$ sudo apt-get install xul-ext-sogo-connector
}}}
Please ensure you have '''not''' installed the XPI package provided by SOGo before you install the package! There is no need to stop an already running Thunderbird normally, just install the SOGo Connector package and go further with the setup.

= Setup a external Address Books =
To implement one new external Address Book you have to open the Address Book inside Thunderbird first.

{{attachment:00_sogo-connector_new-addressbook.png}}

Add than a new external Remote Address Book.

{{attachment:01_sogo-connector_new-addressbook.png}}

Add the desired local name for the Address Book and the respective URL for the remote connector.

{{attachment:02_sogo-connector_new-addressbook.png}}

= Integration into OwnCloud =
== Getting the remote URL for a calendar ==
The needed WebDAV URL for the remote calendar can be found inside the Website of the DebPkg:OwnCloud after you have login.

{{attachment:00_owncloud-calendar-URL.png}}