Evolution OpenGroupware Connector for Evolution 1.5
=====================================================


Prerequisites:
---------------

You will need:

- Packages: Gnome, Evolution (and the development packages if you want to rebuild
	    evolution-ogo yourself)
- System: You will need a working setup of OpenGroupware including ZideStore


Installation:
--------------

See the "INSTALL" document or simple install the RPM.


Setup:
-------

After installing the software you will need to configure Evolution to include
the OGO storages. Up to now this is a manual process.

The evolution-ogo package includes a tool in order to support you in creating
new OGO accounts in Evolution. The tool is called "evo-ogo-create-account". It
will create two new entries in the "Addressbook" section of Evolution. One will
direct to "public/Accounts" the other to "public/Contacts" in ZideStore.

"evo-ogo-create-account" needs two (or three) command line arguments:

	evo-ogo-create-account hostname username [password]

It is important that hostname is really only the hostname. Not including any "http://"
prefix or trailing "/".

Calling it without any it will display the syntax.

If something goes wrong you can remove the created sources from
	"/apps/evolution/addressbook/sources"
using gconf-editor.


Activate:
----------

Start evolution. Access the new storage. Enter the password.

If you need an http proxy you need to set the environment variable "http_proxy"
somewhere global so that OAF can activate the evolution-ogo connector correctly.

Or you can start evolution-ogo from the command line.


Background Info:
-----------------

Each storage in Evolution has an URI. The protocol type for evolution-ogo is "ogo://".
The URIs are directing directly to the ZideStore URIs. So basically it is not more
than the ZideStore URI with "ogo://" instead of "http://" as protocol.

An example: Zidestore is at
	http://anyhost.net/zidestore/so/user and you want to include
the storage "public/Contacts" the full URI in Zidestore would be
	http://anyhost.net/zidestore/so/user/public/Contacts
therefore the URI of the Evolution source will be
	ogo://anyhost.net/zidestore/so/user/public/Contacts
while processing this evolution source the connector will change it back to
	http://anyhost.net/zidestore/so/user/public/Contacts

The sources which are added to Evolution by "evo-ogo-create-account" are simply
two storage locations in the ZideStore tree. Any other calendar source would be
possible. Simply create a new Evolution source with a URI pointing to your ZideStore
location. But instead of using "http://" you will use "ogo://".

This means that the tool is simply creating two entries from a template:

	ogo://<hostname>/zidestore/so/<user>/public/Contacts
	ogo://<hostname>/zidestore/so/<user>/public/Accounts

Any other URI would be OK but is simply not created by the tool up to now.

To add your own source you can either modify the tool or change the sources manually
with "gconf-editor". The sources are written to "/apps/evolution/addressbook/sources".


Known Bugs & Limitations:
--------------------------

This section lists only known bugs and limitations. Not missing implementations.

 - If the communication to the ZideStore server somehow fails only an empty list will
   be shown.
 - The data coming from ZideStore will be converted from "C" locale to "Unicode". But the
   "C" locale of the server and the client system may be different.
 - The proxy should not be taken from "http_proxy" but from gconf