Coveo Share Query
Coveo Share Query
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. |
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 toEnabled
.
Insertion location
Coveo Hive
The Coveo Share Query rendering is an Allowed Control in the following placeholder(s): Searchbox Options
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.
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.
Displayed Share Query modal:
The visitor then selects the Share Query option in the Settings popup menu.