Add Related Controls

This is for:

Developer System Administrator
Warning
Legacy feature

This article pertains to the Coveo Hive framework which is now in maintenance mode.

Choose one of Coveo’s more modern, lightweight, and responsive libraries for any future search interface development. See the search interface Implementation guide for more details.

Now that you have a basic search page with a search box and a result list, you’re ready to add other controls to your page to improve the user experience of your search page.

Add a Result Header

The result header component displays the number of results on your search page. You usually want it on your page.

  1. In the Sitecore Experience Editor, select the Result Header placeholder above your Result List.

  2. Select Add here and select the Result Summary Section.

  3. Click the Result Summary control and select Add here.

  4. In the Select a Rendering window, select Coveo Query Summary.

  5. In the Select the Associated Content window, select Create New Component and choose the parent you prefer.

  6. Save the page.

You should now see a query summary text field before your Result List.

37103739

Add a Pager

A pager lets you load the next results by changing the result page. Since you don’t currently have infinite scrolling on your page, you will want to have it on your page.

  1. In the Sitecore Experience Editor, select the UI Results Footer section below the Result List control.

  2. Select Add here, and select the Coveo Pager rendering.

  3. In the Select the Associated Content window, select Create New Component and choose the parent you prefer.

  4. Save the page.

You should now have a Coveo Pager component at the bottom of your page.

37103740

Add Other Components

There are many other components to add to your search page. Some of the most common ones include the Facet, which allows your users to filter the result list according to a specific value, and Sort components, which allow users to change the order in which your results are presented.

The placeholder for the Sort control is in the Result Header placeholder, where you should insert a Result Header section and a Result Sort Section.

The placeholder for the Facet control is in the Main section. In the Main section, you first insert a Facets Section component. This will add a Facets placeholder. In the Facets placeholder, you can insert one of the numerous facet components Coveo offers.

You should also add the Analytics control, which sends Usage Analytics to the Coveo Platform so you can review it afterward, and the Error Report control, which visually displays an error when it occurs.

For more information on all the various controls you can add to your search page, see Coveo Hive framework.

Important

When adding a control, you always need to either select an existing data source or create a new one.