The Search Results widget is used to display multiple items (records) from a content set. The Search Results widget is normally used in conjunction with the Search Box widget, Browse widget, or the Advanced Search widget. You may also reference the page the Search Results widget sits on while using attribute query parameters in the URL to get a filtered result set. If no other widget is used in conjunction with this widget or no query parameters are referenced in the URL, the Search Result widget will default to displaying all items found in the content set. This widget must be used in conjunction with a Page Element, which is used as a template for each content set item displayed by the Search Result widget. Pagination is automatically created for results greater than the page size specified in the settings. Examples of where you would use this would include displaying a list of products, a list of blog entries, a list of portfolio items, etc. from a content set.
To use this widget:
1. Place the widget and open the widget settings.
2. Click on Add to add a search result page element.
3. Select the Page Element to use as your template for each content set item.
4. Select the Content Set that the results will be from.
5. You may add additional page elements, though in most cases, only a single page element is all that is required.
6. Optionally enter a page size -- this is the number of items to display per page, default is 9.
7. Optionally enter a default sort attribute -- this is used to sort the results. NOTE: any attribute that is to be used for sort must be non-analyzed.
Creating a Page Element Template
The Search Result widget must be used in conjunction with a page element containing widgets using content aware attributes. For every item that is displayed with the Search Result widget, the page element is used to visually display the item values.
1. Create a new page element.
2. Drop widgets and lay out your page element the way that you wish it to display for each item.
3. Make sure to use content aware attributes from the same content set you are using with the Search Result widget.
Creating Optional Sort Selections
Sort options allow the user to sort the displayed result set by an attribute and is displayed in the form of a dropdown list positioned at the top. Some examples of sorting options including sorting by Price, by Name, etc.
1. Under Sort Options, click on the Add button.
2. Enter the Attribute to sort by. NOTE: you must use the content aware bubbles and the attribute must be non-analyzed.
3. Select the Sort Direction, either in ascending or descending order.
4. Enter a Label that will be displayed in the dropdown selection.
5. Repeat steps 1-4 to add additional sort options.
Creating Optional Page Filters
Filters allows the user additional flexibility to filter the result set further by filters you create. The filters section is always positioned at the bottom of the Search Result widget. Use the Advanced Search widget to place filters in other positions or on separate pages.
1. Under Filters, optionally enter a Filters Label -- this label text appears on top of the filters section.
2. For each filter you wish to add, click on the Add button.
3. Enter the text Label for the filter you wish to create.
4. Select the Filter Type -- options include allowing the user to filter by a specific attribute keyword, predefining your own filter values, allowing the platform to populate filter selections with existing values from the content set for that attribute, and providing a defined range to filter from.
5. Enter the attribute to use for this filter. NOTE: you must use content aware bubbles in this field.
6. Optionally enter another filter attribute to depend on. This allows a filter selection to be dynamically populated only with selections that are dependent on another filter selection that a user has chosen. NOTE: you must use content aware bubbles in this field and the attribute must be present as a selection in another filter. A filter style of "Dropdown with attribute values" must be selected.