TIP WebDAVContrib is not installed on Foswiki.org.

WebDAVContrib

WebDAV module for Foswiki

WebDAV stands for "Web-based Distributed Authoring and Versioning". It is a set of extensions to the HTTP protocol which allows users to collaboratively edit and manage files on remote web servers.

This module contains a full Class 2 WebDAV implementation. It uses a standard abstraction of the server filesystem, allowing it to be used with a range of different filesystems, including (via the FilesysVirtualPlugin) the Foswiki datastore.

The module is designed to work with a number of different web servers, and also includes a complete stand-alone server implementation.

Integration with WebDAV means that users can edit topics and attachments using an appropriate WebDAV enabled client program, such as Microsoft Office, Internet Explorer, Open Office, etc. When used with the companion WebDAVLinkPlugin, you can embed links to WebDAV resources in Foswiki pages that will open the linked documents in native applications.

Foswiki permissions are honoured throughout.

Use of the FilesysVirtualPlugin means that all the data views supported by that module are available to WebDAV clients, so clients can read and write Foswiki topics as text, as HTML, as a JSON data structure, or as any other view supported by FilesysVirtualPlugin.

Installation Instructions

You do not need to install anything in the browser to use this extension. The following instructions are for the administrator who installs the extension on the server.

Open configure, and open the "Extensions" section. Use "Find More Extensions" to get a list of available extensions. Select "Install".

If you have any problems, or if the extension isn't available in configure, then you can still install manually from the command-line. See http://foswiki.org/Support/ManuallyInstallingExtensions for more help.

Debugging

If you encounter problems with clients it can be useful to be able to trace the activity of the server. All the web servers have some mechanism to pass a debugging option in. This tracing option is in the form of a bit mask, where the bits mean:
  • 1 to enable error tracing (shows reason for failures)
  • 2 to enable tracing of WebDAV requests.
  • 4 to enable detailed debugging
  • 8 to enable memory usage information
  • 16 to enable very detailed filesystem level tracing
The bits can be combined e.g. 17 will enable detailed filesystem tracing and error reporting. Trace information is output to the web server error log.

If you have experience, then another tool that can be very useful in debugging is a network protocol analyser, such as wireshark.

Configuring FilesysVirtualPlugin

Refer to the documentation for FilesysVirtualPlugin for information on configuring it to support different data views. Each data view presents topics as a different file type, allowing you to read and write the same topic in a range of different formats.

Clients

There are many DAV clients out there that it would be impossible to describe them all.

Linking to DAV resources from a web browser

To link to a DAV resource from a web browser, all you have to do is link to the DAV url of the resource. However most browsers will open the link in a "read only" mode. If you want to open DAV resources from Firefox or Internet Explorer for editing using a DAV-aware native application (such as Microsoft Word or Open Office) you can use the companion WebDAVLinkPlugin.

Accessing WebDAV resources on Microsoft Windows

There are so many problems with the Microsoft implementation of WebDAV that unfortunately it merits a topic of it's own: WebDAVAndWindowsClient

Libreoffice

The otherwise excellent LibreOffice suite has implemented locking since version 4.1. Unfortunately their lock implementation is not consistent with the WebDAV spec, and we have had to disable lock support for LibreOffice. The only risk this poses is if two people try to edit the same attachment via WebDAV simultaneously.

Server Validation

All the standard Litmus tests for a class 2 WebDAV server pass. WebDAVContribLitmusTests describes how to run them.

License

This software is released under the GNU Public License, version 2.

Info

Another great Foswiki extension from the wikiringlogo20x20.png WikiRing - working together to improve your wiki experience!

Many thanks to the following sponsors for supporting this work:

Change History

11 Jul 2016: Foswikitask:Item13571 - fixed compatibility with Foswiki-2
08 Mar 2016: Foswikitask:Item14018 - fixed Can't locate object method "LastCall" via package "HTTP::Headers" (Foswiki:Main.FlorianSchlichting); Foswikitask:Item13799 - fails to connect network drive on Windows 7 (Foswiki:Main.FlorianSchlichting)

Topic attachments
I Attachment Action Size Date Who Comment
WebDAVContrib.md5md5 WebDAVContrib.md5 manage 162 bytes 11 Jul 2016 - 08:52 MichaelDaum  
WebDAVContrib.sha1sha1 WebDAVContrib.sha1 manage 186 bytes 11 Jul 2016 - 08:52 MichaelDaum  
WebDAVContrib.tgztgz WebDAVContrib.tgz manage 42 K 11 Jul 2016 - 08:52 MichaelDaum  
WebDAVContrib.zipzip WebDAVContrib.zip manage 56 K 11 Jul 2016 - 08:52 MichaelDaum  
WebDAVContrib_installerEXT WebDAVContrib_installer manage 6 K 11 Jul 2016 - 08:52 MichaelDaum  
wikiringlogo20x20.pngpng wikiringlogo20x20.png manage 1 K 08 Mar 2016 - 16:48 MichaelDaum  
Topic revision: r6 - 11 Jul 2016, MichaelDaum - This page was cached on 27 Sep 2016 - 08:06.

The copyright of the content on this website is held by the contributing authors, except where stated elsewhere. See Copyright Statement. Creative Commons License