Coveo Share Query

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.

Share Query Menu Option | Coveo for Sitecore 5 Implements the Coveo JavaScript Search Framework ShareQuery component which populates the Settings popup menu with a Share Query menu item.

Selecting the Share Query menu item allows a user to share the URL of the current search interface and the current complete query, which another user may paste directly in their searchbox.

Usage notes

  • In the Share Query modal, the value in the Complete query field represents the combined query expression (((q AND aq) OR dq) AND cq). When this combined query expression is pasted into a search box, it becomes the basic query expression (q) of the new search query (see About the query expression).

  • For combined query expressions pasted in a search box to be interpreted correctly, the Enable query syntax option in the search box data source must be set to Enabled.

Insertion location

Coveo Hive

The Coveo Share Query rendering is an Allowed Control in the following placeholder(s): Searchbox Options

Example insertion sequence for the Coveo Share Query rendering.

Coveo Hive SXA

Coveo for Sitecore SXA rendering insertion locations aren't limited by placeholder Allowed Controls. The Coveo Share Query rendering may therefore be inserted throughout the partial design, whether in Coveo for Sitecore or Sitecore placeholders.

To ease rendering management, group Coveo Advanced Search, Coveo Export To Excel, Coveo Preferences Panel and Coveo Share Query renderings together near your Coveo Settings Button rendering.

Example insertion sequence for the Coveo Share Query rendering.

Data source options

The following table lists the available data source options for this rendering.

This rendering has no data source.

Sample generated HTML and corresponding visual output

Generated HTML:

<div class="CoveoShareQuery">
</div>

User search:

A website visitor performs a query using the terms west lake in the search box.

Search on west lake

Displayed Share Query modal:

The visitor then selects the Share Query option in the Settings popup menu.

Share Query Modal | Coveo for Sitecore 5