Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Widget Use

Excerpt

The Product Search with Preview widget displays Displays each product and that matches the search text with related elements , such as category, image, title, price, and so on, that matches the search text typed into the Product Search with Preview prompt boxetc.


Example of Widget Use

Following is an example of the widget in use.

For each widget called by the Product Search with Preview widget, we have changed its display text to help you envisage show where they are used.

Info
titleAligning Product Preview with Product Search Results

Product Preview suggestions by default use a different set of criteria to that controlling Search Results rankings. If you would like suggestions to align with Product Search results, please contact Commerce Vision.  



Where can the Widget be placed?

The widget can be used in the following templates:

  • All Templates
  • We recommend adding the Product Search with Preview widget Recommendation: add to the Theme Layout template in place of the standard Product Search Widget.


Widget Options

OptionUseCommentsAvailable from Version
DescriptionA short description of the widget's use.
We recommend this field be updated so

This description is added to the widget title. It makes the widget's

purpose is clear at a glance from required

use clear on the template page.

4.13.00
Layer

The layer the widget is valid for.

Required.

The layering technology allows for the content to be shown to specific audiences.

This is handy if the content is only valid for a certain type of user, or if the same widget is

Use layering to limit widget content to certain groups of users. 

To use the same widget for more than one

audience,

user group but

different configuration is needed.The widget can be added to the zone more than once and the layer feature can determine which audience can see each widget

with different options set, add the widget as many times as needed in the same zone. Then add layering to define the user group each time

4.13.00
Search Place Holder
This text displays
Text displayed as
a
prompt in the Search Preview box. 
If you use the Product Search with Preview widget along

Default: Product Search.

Recommendation: If using this widget with the standard product list search,

then we recommend using

use this prompt to

advise

tell the

customer of what they should expect when they type a

user what the search word or phrase

into this field, such as 4

willfind, e.g., "Product Search with Preview".

The default value is Product Search.

.13.00 
 Search Button Text
This is the text that accompanies

Text for the search icon.

Required.

The default value is
Default: Search.4.13.00 
 Search Page URL
After the customer types
The URL of the search page the user is taken to after they type in the search value
into the field, when they
and press enter or click
the prompt
to view more
, this value determines the URL that is used to search.The default value is
.Default:  /search. 4.13.00 
Number of products to display
This value determines how
How many products
will
to display in the
drop-down
dropdown view as the
customer
user types in
the
search keywords. 
The default value is

Default: 9.

When

this value or

the maximum number of products

that match

matching the keyword is reached,

then the system displays the

a prompt to 'view more

, taking the customer

' is displayed. Clicking on it takes the user to the search

URL

results page.

4.13.00
Excluded CategoriesEnter the category code(s) to exclude from previewed searches.Separate
multiple categories
each category by a semi-colon.4.13.00
Exclude Products in Excluded Categories
Any
To display products in the excluded categories list
will not display when this option is checked.

The option is checked (ON) by default.

Turn this option off to override the Excluded Categories setting. Enter
or not.

Default: ON.

Toggle to disable. TIP- Useful for promotional products with limited availability.

4.13.00
Excluded Products
Rather than, or in addition to, excluding categories, you can also exclude individual products.
Enter product codes of products to exclude from previewed searches.Separate each product by a semi-colon
separated list of product codes to excluded those products from the search with preview results
.4.13.
00
13
Show levels
This option shows the category tree

Shows the category/sub-category level of each product that matches the keyword search.

Required.

Referring to the widget image, a


Default: 3

A value of 3

will display

displays the top-level category and two levels below: Sports & Outdoors > Camping > Tents.

A value of 2 would display: Camping > Tents.

A value of 1 would display: Tents and Tennis Equipment. In this instance, the system displays more than one first-level category as the products displayed are in multiple categories.


4.13.13
Use Prior Purchase?Allows user to search from products they purchased previously.

Default: OFF

Toggle to enable

4.13.13
Use User Favourites?Allows user to search from their Favourites list.

Default: OFF

Toggle to enable

4.13.

The default value is 3.

4.13.00

...

13
Always Do Global Search?Determines if the search will always be a global search even when current page has a category filter.

Default: OFF

Toggle to enable

4.16.15
Enable Prior Purchases And User Favourites Search On Checkbox Ticked?Have the Prior Purchases and User Favourites checkboxes to be ticked (ON) by default.

Default: OFF

Toggle to enable

4.33
Enable Default Template?

Displays the default search preview template when the user clicks into the Search box.

NOTE - Refresh the browser cache to view differences. 

Default: OFF

Toggle to enable

4.37


Used with these widgets

Content by Label
showLabelsfalse
showSpacefalse
excludeCurrenttrue
cqllabel = "widget" and title ~ "'product search with preview'"

Related help

Content by Label
showLabelsfalse
spacesKB
showSpacefalse
sortcreation
excerpttrue
reversetrue
excerptTypeexcludeCurrentsimpletrue
operatorAND
cqllabel = "cms" and label = "widgetproduct-search" and space = "KB"
labelswidget cms