Archive:Reference:WebDAV

Archived! This documentation is obsolete and no longer applies to the current BlueSpice version.

all extensions

Overview
Description:	Adds a WebDAV endpoint that exposes the wiki content
State:	stable	Dependency:	BlueSpice
Developer:	HalloWelt	License:	GPL v3 only
Type:	BlueSpice	Category:	Document Management
Edition:	BlueSpice pro (deactivated), BlueSpice Farm (deactivated)"BlueSpice Farm (deactivated)" is not in the list (BlueSpice free, BlueSpice free (deactivated), BlueSpice pro, BlueSpice pro (deactivated), BlueSpice farm, BlueSpice farm (deactivated), BlueSpice cloud, BlueSpice cloud (deactivated)) of allowed values for the "BSExtensionInfoEdition" property., BlueSpice Cloud (deactivated)"BlueSpice Cloud (deactivated)" is not in the list (BlueSpice free, BlueSpice free (deactivated), BlueSpice pro, BlueSpice pro (deactivated), BlueSpice farm, BlueSpice farm (deactivated), BlueSpice cloud, BlueSpice cloud (deactivated)) of allowed values for the "BSExtensionInfoEdition" property.	Version:	4.1+
For more info, visit Mediawiki.

WebDAV provides an endpoint for accessing files on the wiki using different client applications or mounting the wiki content as shared drive.

Usage / features

Certain file types that have been uploaded to the wiki can be opened with WebDAV.

Opening the context menu for these files offers an option to open the file with the client application. Click this option for example to open a docx-file in Microsoft Word. All changes to the file are automatically saved in the wiki when the file is closed.

Protocol	File extensions
ms-word	doc, docx, dot, dotx, rtf, docm, dotm, odt
ms-excel	xls, xlsx, csv, tsv
ms-powerpoint	ppt, pptx
<any installed zip handler>	zip
<any installed pdf handler>	PDF

The following Microsoft Office file types cannot be opened via the context menu, but can be uploaded and versioned via Windows Explorer if the wiki configuration allows the file type: Visio, Access, Project, Publisher, SharePoint Designer, Infopath.

Technical information

Rights (permissions)

WebDAV offers several ways for authenticating the users with the client application.

MediaWiki authentication

This type of authentication makes the client application prompt the user for the wiki username and password information when opening the file and/or mounting the drive. This type of authentication can only be used in normal local login wikis (no SSO, no LDAP).

Token authentication

This type of authentication appends a token to the URL that is generated for the user and file. On all subsequent requests from the client application, the token is evaluated wiki-side and the request is allowed or rejected based on the outcome of the token verification.

This is the preferred way of authentication and can (and should) be used on all types of wikis. For mounting drives when using this type of authentication, the static token that is generated per user must be included in the URL. The user-specific drive mounting URL is available in the user preferences, under the tab User profile. This URL must be used to mount the drive.

Requirements

This extension requires BlueSpiceFoundation.

There are three extensions that make up the WebDAV suite:

• WebDAV: Plain MediaWiki extension - provides the infrastructure.
• BlueSpiceWebDAVClientIntegration: Integrates WebDAV into BlueSpice - namely ContextMenu.
• BlueSpiceWebDAVMinorSave: Interferes with the saving process. It uploads a new version to the wiki only after a user has closed the client application, even if the user saved the file multiple times while editing. This allows having only one revision per complete edit rather than for each save. This functionality is largely experimental and might not work properly. Can be disabled without issue.

BlueSpiceNSFileRepoConnector interacts with WebDAV, and allows WebDAV to work with files that are in namespaces.

More info

For detailed description and usage, visit our help page.