Search templates

Funnelback provides a templating system to allow the customization of search results that are delivered using the HTML search endpoint.

This allows an administrator to adapt the search results display to any HTML design, and also to output the search results in other text based formats such as CSV or customized XML or JSON.

Funnelback uses the Freemarker templating language to define the search templates. These templates look like HTML files with additional custom tags - anyone familiar with editing HTML will be able to understand the Freemarker template code. The Freemarker documentation should be read to assist in understanding the Funnelback templates.

Each search results template must handle two cases covering what to present to the end user before and after a search is run.

Search template customization and management

Search templates control how the search results are formatted for end users. This includes changing the styling and layout of the search results page as well as providing the search results in alternate formats such as CSV.

Search templates can also be created and edited in the editor of your choice by mounting Funnelback on your computer using a compatible WebDAV client.


Web resources

Funnelback provides a web resources folder for each profile that can be used to store linked resources such as CSS, image and JavaScript files.

Debugging search template errors

Search templates will fail with an error if the template contains syntax errors or references to undefined variables. Funnelback provides a number of ways to debug template errors.


Remote includes

Funnelback includes an IncludeUrl macro that allows configuration of server-side includes to allow remote fetching of headers, footers, navigation and any other components that you may wish to include in your generated page.