- Creating and Making Use of a New Result Template
- Editing the Content of a Result Template
- Creating a Simple Listing Page
- Applying Filtering and Ranking Rules
- Routing Search Queries to Query Pipelines
- Inserting and Configuring a Global Search Box
- Inserting and Customizing a Distance Resources Component
- Configuring Custom Ranges for a Date Range or Numeric Range Facet
- Inserting Custom Components in an Existing Search Interface
- Integrate the Search Interface in an Existing Page
- Translating Fields to the Coveo Format
- Overriding Coveo for Sitecore Hive Initialization Options
- Duplicating a Coveo for Sitecore Component to Modify Its HTML
- Creating a Custom Hive Component - Multi-Sort Tutorial
Inserting Custom Components in an Existing Search Interface
There are two ways to insert your own components into an existing search interface.
Inserting a Placeholder Section
The placeholder section allows adding a provided placeholder in the interface. This placeholder can be an existing one that already has been configured for custom placeholder.
Many of the placeholders in the Coveo Modular Frame already allow you to add the Placeholder Section component.
- Select the Main Content section, and click Add To Here
Select the Placeholder Section component.
- Select or create a new Data Source. If you select an existing Data Source that is already configured, jump to step 7.
You should now have a non-configured Placeholder Section component.
- Click on the component, and click the Edit Coveo Data Source button.
Enter the placeholder key that you want to insert.
You should now have an empty placeholder. If you do not see it, ensure that you have properly configured the Placeholder Settings for the key entered in the Data Source.
Patching the Allowed Controls of an Existing Placeholder
This item allows you to add your own Allowed Controls to a placeholder without running the risk getting your placeholder overwritten during an upgrade.
You should always use this method to patch the placeholders provided by Coveo for Sitecore.
- In the Content Editor, in the location of your choice.
For instance, create a folder named “My Placeholder Extenders” under the path Sitecore > Layout> Placeholder Settings..
- Right-click on the folder and choose Insert > Insert From Template
- In the templates, navigate to Coveo Hive > Structure and choose Placeholder Extender.
Choose a name that identifies what you are extending.
- In your newly created item, select the Placeholder Setting property.
Choose the placeholder that you want to extend.
- In the Allowed Controls property, click the Edit button.
- Choose the controls that you want to add and click OK.
In this example, we add Coveo Pager to the coveo-facets placeholder. This allows us to add the Pager component where the Facets are usually located.
- Save the item.
You should now be able to add the component from the extender to the provided placeholder.