guessmer.de wiki | Text / Baikal-caldavzap

this is about how to use
CalDavZAP - a web frontend for CalDav Calendars with
Baikal - a server for CalDav (and CardDav)
on shared web hosting

Please see the respective projects for setting each one up, I will only provide hints on make them work together. I simply put Baikal server in a folder on my server, lets assume "bk" and created another subfolder in there for CalDavZAP, called "www".
Tested versions are: Baikal 0.2.6 and CalDavZAP 0.9.1.2 ...update: still works with Baikal 0.2.7 and CalDavZAP 0.13.0

Baikal

In Baikal server create a user - let's call him "test", leave the calendar name at "default calendar".
~~Under settings leave the WebDAV authentication type at "Digest".~~ (does not work for Thunderbird...)

CalDavZAP

Use a text editor to open config.js in CalDavZAP's main directory.

disable globalAccountSettings (this seems to be default now, so might be skipped)
change globalNetworkCheckSettings to the URL for your server:
var globalNetworkCheckSettings={href: 'http://your.server.xyz/bk/cal.php/principals/',... (leave or change other params as you like)
enable var globalUseJqueryAuth=true;
configure other params (language, startview, etc) as you like...
Look for the file "cache.manifest" in caldavzap directory, on its 2nd line (starting with #V) change maybe the last digit of the following number. This is needed to make the browser flush the cache from last usage - there is also a script to do that, but it does not work for me.

test

You should now be able to access your.server.xyz/bk/www and log in with the username and password you created in Baikal server. Use Firebug console to check for possible errors.
To use that calendar in Thunderbird/Lighting create a new calendar "on the net", calDAV, http://your.server.xyz/bk/cal.php/calendars/test/default/.
Thunderbird requires auth type "basic" in Baikal!
If you want to use more than one calendar / addressbook from the same domain in Thunderbird you have to set an option "calendar.network.multirealm" to true in about:config!

SSL proxy

If your shared hosting is with Strato, you could use their SSL proxy (https://www.ssl-id.de) even for this scenario. See their FAQ for general details.

in Baikal system settings change CalDAV base URI to "/server.xyz/bk/cal.php" (including the qoutes)
in CalDavZAP config.js change the above mentioned URL to https://www.ssl-id.de/server.xyz/bk/cal.php/principals/
use https://www.ssl-id.de/server.xyz/bk/www to access the web frontend.
Thunderbird URL becomes: https://www.ssl-id.de/server.xyz/bk/cal.php/calendars/test/default

(exchange server.xyz with your domain name in all cases)

And thanks again for all that great open source software!