This is an old revision of the document!
Table of Contents
webdavclient Plugin
Compatible with DokuWiki
Detritus, Hrun
This extension has not been updated in over 2 years. It may no longer be maintained or supported and may have compatibility issues.
webdavclient
WebDAVClient is a content-providing PlugIn that allows other PlugIns to interact with WebDAV-enabled calendars and contacts. A full two-way synchronisation is performed.
It features an Admin component where an Administrator can add WebDAV connections to Calendars and Address books. The data is then synchronized in the background to a local SQLite cache.
Every configured connection has a unique ID that can be used by other PlugIns (currently, davcal) to enable support for remote connections.
There is no user functionality, this PlugIn relies on other PlugIns to represent and work with the data
Requirements
Installation
Make sure that the sqlite PlugIn is installed.
Install the plugin using the Plugin Manager and the download URL above, which points to latest version of the plugin. Refer to Plugins on how to install plugins manually.
Examples/Usage
Only an admin can configure WebDAV connections. Go the Admin → WebDAV Connection Setup and add a new connection. You can try auto-discovery first by providing only the minimal information set in the lower left corner. If it is successful, you get a list with all discovered calendars/addressbooks and can select the ones you would like to add.
If auto-discovery fails, you can manually add a new connection in the lower right corner.
After adding a connection, it is disabled by default. This is due to the possibility of a large initial sync. Keep the connection disabled and click on “Force Sync”. If it went successful, you can enable the connection (Dropdown to “active” and then click on “Modify Connection”).
Currently, it is not possible to change the username and password.
Attention Most of the buttons do not ask for confirmation! If you click on “Delete”, the connection is deleted! The button “Empty” deletes all entries from the server. The button “Resync” first deletes all local entries and performs a synchronisation afterwards.
When you want to use one of the connections in, e.g., caldav, simply note the ID in the first column and configure a new calendar with the ID webdav://7
to connect to the WebDAV connection with ID 7.
CRON Job
By default, webdavclient hooks into DokuWiki's Indexer event to synchronise connections when needed. You can, however, change this to CRON if you would like your calendars to keep perfectly in sync. To do this, enable the configuration option “use_cron” and set up your CRON daemon to hit lib/plugins/webdavclient/cron.php
.