...
...
- Please, tick here when approved
...
My first widget. 
There are other widgets that this one uses (indicated by the red rectangles in the image); I am in the process of documenting those also.
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 | ||
|---|---|---|
| ||
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
| Option | Use | Comments | Available from Version | |
|---|---|---|---|---|
| Description | A 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 fromuse 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 required 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 widgetwith 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 willfind, e.g., "Product Search with Preview".The default value is Product Search. | 4.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 URLresults page. | 4.13.00 | |
| Excluded Categories | Enter 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. 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 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.0013 |
| 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. The default value is 3. | 4.13.00 |
Works with Widgets
Product Search with Preview Product Category List Widget (DRAFT)
Product Search With Preview List Title Widget (DRAFT)
Product Search With Preview List Grid Widget (DRAFT)
...
| 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.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 | ||||||||
|---|---|---|---|---|---|---|---|---|
|
Related help
| Content by Label | ||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|