Plugin: Group search results
|Other versions of this plugin may exist. Please ensure you are viewing the documentation for the version that you are currently using. If you are not running the latest version of your plugin we recommend upgrading. See: list of all available versions of this plugin.|
This plugin enables the grouping of search results by data source or metadata.
|There is a related feature, result collapsing, which provides some different options for grouping search results.|
Enable the grouping-results-by-criteria plugin on your results page from the Extensions screen in the administration dashboard or add the following results page configuration to enable the plugin.
|The plugin will take effect as soon as it is enabled.|
The following options must be set in the results page configuration to configure the plugin:
plugin.grouping-results-by-criteria.config.mode: (Required) Defines what will be used to group the search results. Acceptable values are
SOURCE- group by the data source to which the result belongs; or
METADATA: group the results on a metadata value.
plugin.grouping-results-by-criteria.config.metadata_class: Defines the metadata class that will be used to group the search results. Required, when using the
METADATAmode. Set this to the metadata class ID that you wish to group.
The following options enable the plugin to be used in conjunction with a tab facet (as defined in the faceted navigation configuration of the results page).
plugin.grouping-results-by-criteria.config.tabs_facet_name: (Optional) If being used with a search that has a tab facet, defines the name of tab facet to which grouping will be applied. Default:
plugin.grouping-results-by-criteria.config.tabs: (Optional) Indicates which tabs of the tab facet the grouping will be applied to. Set this to a comma separated list of tab category names. Default - apply grouping to all tabs.
plugin.grouping-results-by-criteria.config.target_facet: (Optional) If being used with a search that has a tab facet, defines the name of target tab facet for see more links. Default:
SOURCEmode, the data source name.
METADATAmode, the metadata class name.
plugin.grouping-results-by-criteria.config.link_label.SOURCE-OR-METADATA-VALUE: (Optional) Defines the see more label to display for the group of results.
SOURCE-OR-METADATA-VALUEcorresponds to the value of the data source or metadata that is being used to group the results. Clicking the see more link will take you to a more results listing on the corresponding tab in the target facet (indicated by
plugin.grouping-results-by-criteria.config.target_facet). When facet tabs are not available, then see more link will re-run the current search and restrict the results to items from the same data source (if in
SOURCEmode), or items with the same metadata field value set (if in
Consider a university search where you have course, people, event and web results each indexed in separate data sources.
The following configuration can be used to group the search results by the data source.
Consider an ecommerce search where you have type metadata, mapped to the
productType metadata class.
The following configuration can be used to group the search results by type.
Consider a membership association search that includes event and journal data sources.
The search includes a tab facet named Tabs which is configured with three tabs:
All results, containing all search results
Events, containing results from the
Journals, containing results from the
The following configuration can be used to group the search results when viewing the all results tab, and produce see more links to the corresponding tabs.
plugin.grouping-results-by-criteria.config.mode=SOURCE plugin.grouping-results-by-criteria.config.tabs=All Results plugin.grouping-results-by-criteria.config.target_facet=Tabs plugin.grouping-results-by-criteria.config.target_facet_label.membership-association-events=Events plugin.grouping-results-by-criteria.config.target_facet_label.membership-association-journals=Journals