Contextual navigation (related searches)

Contextual navigation suggests a list of related searches by analysing the result summaries in the set of results returned for a search.

These suggestions are grouped into types and topics related to the original search query.

Contextual navigation surfaces these sub-topics by presenting them to users as suggestions for refining their query. This enables users of all levels to explore large volumes of content more efficiently and intuitively.

Editing contextual navigation settings

To edit contextual navigation settings:

  1. Select the collection you wish to modify in the manage collection section of the administration home page

  2. Select edit collection configuration

  3. Select contextual navigation from the left hand menu

Basic settings

Option Description

contextual-navigation.enabled

This setting enables display of the contextual navigation output for the selected collection. Note that contextual navigation will not appear on the search results page without a valid template.

contextual-navigation.categorise_clusters

This setting groups the suggestions into types and topics based on the query. The categorisation algorithm is not always accurate, but in most cases provides a helpful grouping of the suggestions. If set to false, types and topics are grouped together into topics. The default is true.

contextual-navigation.type.max_clusters

This setting limits the number of type suggestions displayed on the search results page. The default is 15 type suggestions.

contextual-navigation.topic.max_clusters

This setting limits the number of topic suggestions displayed on the search results page. The default is 15 topic suggestions.

contextual-navigation.site.max_clusters

This setting limits the number of site suggestions displayed on the search results page. The default is 8 site suggestions.

contextual-navigation.kill_list

Suggestions containing any of these words or phrases will not be displayed as a related search.

contextual-navigation.cannot_end_with

Suggestions ending in any of these words or phrases will not be displayed as a related search.

contextual-navigation.case_sensitive

Words in this list found in any suggestions will be treated as case sensitive when generating the suggestions and case will be preserved.

contextual-navigation.summary_fields

The summary fields are Funnelback metadata classes that are analysed in addition to the page content for the purpose of generating the suggestions. The default summary fields are description (c) and subject (keyword) metadata. Any other metadata classes that contain descriptive information can be added to this list to further enhance the quality of suggestions.

Advanced settings

Option Description

contextual_navigation.max_phrase_length

Limits the maximum length of suggestions to the specified number of words (default is 5). Decreasing this setting will mean that contextual navigation excludes potentially lower quality suggestions at the expense of displaying fewer overall suggestions.

contextual_navigation.max_phrases

Configure how many potential candidate phrases should be processed when generating suggestions (default is 750). This value may be increased to improve suggestion quality but this may lead to slower response time.

contextual_navigation.max_results_to_examine

Specify a maximum number of results to examine when generating suggestions. Default value is empty, which will result in an internal default of 150 results being examined. The absolute maximum that will be examined is 200 results.

contextual_navigation.site.granularity

Specify the type of granularity to be used for contextual navigation site suggestions. The default value is host which will result in hostnames being displayed e.g. www.example.com, info.example.com. Other allowed values are domain e.g. example.com and tldir (top level directory) e.g. www.example.com/hr, www.example.com/support.

contextual_navigation.timeout_seconds

Specify a timeout for how long contextual navigation should run for - if limit is reached then the system will return whatever suggestions it had generated by that point. Default value is empty, which will result in an internal default of 1 second being used.

How does contextual navigation work?

Contextual navigation works by performing an query-time analysis of an extended set of search result summaries. Commonly occurring phrases that meet certain criteria are presented as related search suggestions. Clicking on a suggestion reveals the search results for that suggestion and a new set of suggestions for further refining the query.

The example below shows the contextual navigation (related searches) that is rendered in the default template. This is usually presented below the search results.

Contextual_navigation_figure_one.png

© 2015- Squiz Pty Ltd