Calendar:WCAP Provider

Please remind that this provider IS STILL PRELIMINARY, NO WARRANTY!

Using

Initial Steps

You currently have two options to switch on WCAP support:

• Setting calendar.wcap.enabled to true will switch on the provider (only).
• Setting calendar.prototypes.wcap to true will enable the provider and the enhanced (though still prototypical) WCAP UI. (recommended, Lightning only)

Subscribing To Your Calendar

The Sunbird/Lightning Create New Calendar wizard comes up with a third Format type for remote calendars (Sun Java System Calendar Server (WCAP)). As location, provide a HTTP URL to a Sun Java System Calendar server.

http://sd-calendar.staroffice.de/

If you need to login as different users on the same server, then create multiple calendar accounts, encoding user-Ids into the corresponding URLs, e.g. creating one calendar

http://jdoe@sd-calendar.staroffice.de/

and another

http://bbat@sd-calendar.staroffice.de/

After creation, you need to switch the view on for this calendar in the Calendars list.

Login

For login, you will be asked for a pair of UserName/Password. If you don't pass login, you will be asked again. If you cancel login, you won't be asked again anymore. HTTPS is preferred, even if you have specified plain HTTP, because the password is transmitted. If the calendar server does not support HTTPS (at least for login), you will be asked whether to continue the login.

UI

If you create items, keep care to have the correct calendar selected and checked in the Calendars list, because this will be the one for insertion. It can be confusing if the selected calendar is not shown (unchecked), i.e. you won't see your newly created event. IMO we have to improve this.

Logging

Log Level

The provider can log for diagnose purposes. Logs go to the js console, eventually to stdout (if user_pref("browser.dom.window.dump.enabled", true);) or log file.

Three log levels are defined:

• 0 → no logging (release, default)
• 1 → some logging, connection etc., but no calendar data
• 2 → full log

You can increase the log level your user.js in your profile:

user_pref("calendar.wcap.log_level", n);

Building Lightning, the default log level (i.e. 0) can be overridden, e.g.

make wcap_logging=2

The effective log level is

max( build-default-log-level, user-pref-log-level )

Log File

You can specify a log file. Logs are always appended to the specified file.

user_pref("calendar.wcap.log_file", "/system/path/to/log/file");

Misc

• contribution tracked via issue 340949