Web resources
Linked external resources
Most templates often rely on external resources such as image, JavaScript and CSS files.
These external resources can be stored at any web-accessible location such as your public web server and referenced as external resources from the template using absolute URLs.
Funnelback also provides web resource folders that can be used for local storage of these files. Web resource folders are associated with the folders that contain the search template files.
Web resources can also be managed by mounting Funnelback on your computer using a compatible WebDAV client.
The URL of a web resources folder is constructed using the following pattern: PROTOCOL://FUNNELBACK SERVER NAME/s/resources/COLLECTION/PROFILE/FILENAME
where:
- PROTOCOL is either http or https
- FUNNELBACK SERVER NAME is the hostname of the Funnelback server. If referencing from a template the FUNNELBACK SERVER NAME and protocol can be omitted and presented as a relative link.
- COLLECTION is the collection containing the resource. (This can be copied from the collection parameter in the URL of the file manager). When accessing a resource from within a search template COLLECTION should be replaced with
${question.collection.id} - *PROFILE is the profile containing the resource (this can be copied from the profile parameter in the URL of the file manager). When accessing a resource from within a search template PROFILE should be replaced with
${question.profile} - FILENAME is the filename of the web resource.
This corresponds to a local folder on disk: SEARCH_HOME/conf/<collection>/<profile>/web which is created at the same time as the profile.
E.g. a link to a resource from a template styles.css might be:
<link rel="stylesheet" href="/s/resources/${question.collection.id}/${question.profile}/styles.css" />
Editing
The content Funnelback provides via the web resources mechanism can be edited in the administration interface for each service.
The 'Edit Web Resources' button on the home page will take you to the interface which allows files to be uploaded, added, edited or removed and published from preview to live and folders to be created, deleted and published/unpublished.
Please be aware that publishing a file within a folder requires that all parent directories are first published. Folders also include a 'Publish all' button which will publish all changes within them in a single click.
Content in these directories can also be accessed and edited via a WebDAV client application. Such an application allows familiar local editor applications to be used and also allows easy uploading of existing directory structures. Please see managing configurations templates and web resources using WebDAV for further details.