Skip to main content

xmldirector.connector supports mounting storages like S3, Webdav backend or local filesystem into Plone

Project description


xmldirector.connector integrates Plone 5 with

  • local filesystem

  • WebDAV-backed backend

  • AWS S3

  • remote servers over SFTP/SSH

xmldirector.connector provides a Connector content-type that mounts a particular storage into Plone.

No support for indexing and search mounted content.


  • Plone 5.2 with Python 3.6 or higher (tested)

  • Supported backends:

    • eXist-db

    • Base-X

    • OwnCloud

    • Alfresco

    • Marklogic Server

    • AWS S3

    • Cloud federation services




Goto the Plone control panel and click on the XML-Director Connector configlet and configure the your service


  • webdav://localhost:6080/existdb/webdav/db

  • username and password required to access your XML database over WebDAV


  • webdav://localhost:8984/webdav

  • username and password required to access your XML database over WebDAV


  • webdav://hostname:port/remote.php/webdav

  • username and password required to access your Owncloud instance over WebDAV


  • webdav://hostname:port/webdav

  • username and password required to access your Alfresco instance over WebDAV

Local filesystem

  • file:///path/to/some/directory

  • no support for credentials, the referenced filesystem must be readable (and writable)


  • s3://bucketname

  • enter your AWS access key as username and the AWS secret key as password (You need to install the Python package fs-s3fs through buildout).


  • ssh:// or s (You need to install the Python package fs.sshfs through buildout).

API notes

The implementation of xmldirector.connector is heavily backed by the PyFilesystem 2 API. Every Connector instance in Plone gives you access to the mounted storage through the handle = connector.get_handle() call which is instance of fs.base.FS. Check for details.

Compatiblity with rclone

An alternative to using native drivers under the hood, using rclone ( is meanwhile perhaps the better solution. rclone is an application (a commandline utility) to interact with up to 40 different storage systems out of the box. rclone also allows you to mount different storages directly into your filesystem (tested on Linux but supposed to work on Mac and Windows too). So for example, you can mount your Dropbox and Google Drive storages into your local filesystem under /mnt/dropbox and /mnt/drive and point your connector instances to file:///mnt/dropbox and file:///mnt/drive. So any interaction would happen through the filesystem driver of Pyfilesystem. The underlying communication with the Dropbox or Google Drive API would be handled by rclone under the hood.


The mounted storage gives you access to all contents inside the mounted subtree. The mounted filesystem is sandboxed ( So you can not escape and access content outside the mounted storage.

Available drivers

Connectivity with other backend is accomplished through dedicated driverse that implementation the API layer between PyFilesystem 2 and the related backend. See for all available drivers.


This package is published under the GNU Public License V2 (GPL 2)

Source code





Andreas Jung/ZOPYX
Hundskapfklinge 33
D-72074 Tuebingen, Germany


0.5.0 (2021-02-09)

  • added support for referencing another connector instance for using their connector configuration

0.4.0 (2021-01-26)

  • updates JS resources

  • minor tweaks

0.3.1 (2020-11-24)

  • uninstall profile added

  • fix for mod_dav issue when sorting entries (issue #64)

0.3.0 (2020-11-04)

  • minor cleanup

  • removed Python 2 support

  • removed defusedxml dependency

0.2.9 (2020-05-04)

  • added @@connector-zip-export functionality

0.2.8 (2020-03-01)

  • fix for content-disposition header

0.2.5 (2020-02-05)

  • removed Python 3 support

0.2.4 (2019-07-24)

  • Python 3 fix

0.2.3 (2019-07-20)

  • fixed redirection upon remove

0.2.2 (2019-07-20)

  • import fix for nested zip files

  • updated to fs 2.4.8

0.2.1 (2019-03-04)

  • restored Python 2.7 compatibility

  • Travis tests for Python 2.7

0.2 (2019-02-20)

  • various fixes

  • various XML related backports

0.1 (2018-12-14)

  • initial release

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

xmldirector.connector-0.5.0.tar.gz (1.4 MB view hashes)

Uploaded source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page