Manage configuration files, templates and web resources using WebDAV
Introduction
Funnelback provides a WebDAV interface that enables administrators to manage their Freemarker templates, web resources and following list of collection level configuration files using a WebDAV client.
- spelling-blacklist.cfg
- spelling-whitelist.cfg
- kill_exact.cfg
- kill_partial.cfg
- server_alias.cfg
- reporting-blacklist.cfg
- cookies.txt
- custom_gather.groovy
- hook_extra_searches.groovy
- hook_post_datafetch.groovy
- hook_post_process.groovy
- hook_pre_datafetch.groovy
- hook_pre_cache.groovy
- hook_pre_process.groovy
- meta-names.xml
- workflow.cfg
This allows a user to:
- edit templates, web-resources and configuration files using a locally installed text editor application.
- create, upload and download templates, web resources and configuration files directly from a desktop computer.
Accessing the Funnelback resources via WebDAV
The following can be entered into a supported WebDAV client:
- Server:
https://<ADMIN_SERVER_HOST>:<ADMIN_SERVER_PORT>/admin-api/file-management/v1/webdav/
- Username: your Funnelback administration interface username
- Password: your Funnelback administration interface password
This will present a directory hierarchy including collections, the profiles they contain and the two views these profiles include (live and preview).
You can access the above list of collection level configuration files in the conf
directory
and a list of available profiles under profiles
directory, reside under each collection.
Example:
- Configuration files
https://<ADMIN_SERVER_HOST>:<ADMIN_SERVER_PORT>/admin-api/file-management/v1/webdav/collections/<COLLECTION_NAME>/conf
- Profiles
https://<ADMIN_SERVER_HOST>:<ADMIN_SERVER_PORT>/admin-api/file-management/v1/webdav/collections/<COLLECTION_NAME>/profiles
Within each profile view directory two directories are available, 'templates' and 'web-resources'.
The templates directory is a single flat directory which may contain only *.ftl template files. No other file formats or extensions are permitted.
The web-resources directory may contain any file format and nested directories as described in the web resources folder documentation
WebDAV Clients known to work well include:
- Cyberduck
- Transmit
- Cadaver
- MacOS's built-in directory mounting (but please be aware that MacOS will appear to allow read-only files in the live view to be edited and then silently lose any changes made)
Please be aware that the Microsoft Windows built-in WebDAV directory mounting is not compatible with Funnelback's implementation.
Publishing
WebDAV clients do not support the concept of publication, so after modifying the preview content via WebDAV, please use the administration interface to publish changes, or directly access the publication API endpoints which are documented within Funnelback's API UI.