Versions Compared

Key

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

Overview


Multiexcerpt
hiddentrue
MultiExcerptNameFeature Title

...

Static Content Search

...

MultiExcerptNameFeature Overview

We have widened our search functionality to not only search for products, but also static content, such as articles, videos, or images.

Your customers can search for a specific product as well as additional content, such as marketing material, assembly videos, or feature articles on product care. A search for “delivery” may return results related to lead times or cost. A customer could search for firmware files to upgrade the smart device they purchased from you.

Image Removed

How does it work?

...

Configure Product Search to include static (content) page results.



In its traditional use, the Search tool ('Product Search Widget') on your site (usually located in the Themes Layout template) enables website visitors to look for products. They type in keywords, usually product names or codes, and the search results lists products you sell based on those keywords. Content (web) pages that contain those keywords are not automatically indexed by the system and so, are not included in the results. (Example 1.)


It is now increasingly popular for visitors to a selling site to use the Search facility to find static content such as product guides, how-to articles or info about firmware upgrades for the device they purchased. You can configure the search tool to include content pages in search results.


Excerpt
hiddentrue

 Configure the search tool to include results from content pages such as articles and blogs.  


Multiexcerpt
hiddentrue
MultiExcerptNameFeature Overview

Widen Product Search results to include relevant content pages, e.g., articles and blogs. 



Panel

On this page:

Table of Contents
minLevel2




Choose to include such content if you wish, or even add another Search facility just for finding such pages. (Example 2.)    

Example 1. Product Search suggestions - results with products only

Search without content pagesImage Added

Search Results with no Content page search

Image Added

Example 2. Product Search suggestions with products AND content pages

Product Search with contentImage Added

Search Results with Content Page search

Search Results pageImage Added


How does Include Content Search work?

By default, content pages are not included in Product Search. When the search facility is set to include such pages, the search engine will index those that are publicly accessible so they can be findable.

Step-by-step guide

Follow these steps to configure

...

'Include Content Search' for your site

...

.

1.

...

Turn on Content Search

  1. To turn on the Content Search

...

  1. feature, navigate to Settings → Feature Management → Content

  2. In the list of features, toggle on Content Search and click Configure.

Image Removed

...

  1. Image Added

  2. In the 'Content Search Settings' window, toggle on Enable Content Search Feature.

Image Removed

...

  1. Image Added

  2. In Page Content Reindex Task Start Date, set the schedule to a few minutes in the future

...

5.       Select Advanced Settings from the CMS side-menu.
6.       Select Lucene Search Settings.

...

  1. .

  2. The Page Content Reindex Task Period in Minutes sets the amount of time before the system will reindex content pages after the date/time entered in Step 4. Accept the default or enter an alternative.

  3. Click Save and Exit to save and close the window.

2. Configure Indexing Settings

Content pages on your site need to be analysed and added to the search engine's database of web pages included in searches. The system takes advantage of Lucene's indexing and searching features to maximise its search capabilities.  

  1. In CMS, navigate to Advanced Settings → Lucene Search Settings.

  2. Select the Index Settings tab.

...


  1. To enable indexing, tick the Enabled checkbox.

    Image Modified

...


  1. Tick Perform Partial Word Searches

...

Image Removed

10.      Click Update to save your settings.
11.      Click the Indexing tab.
12.      Click the "Reindex Page Content" button to initiate an index of the content on all pages.
Image Removed
13.      The progress bar will display the progression of the reindexing.
14.      Once complete, the Reindex process displays the time taken to index your site's pages.
Now, we need to reconfigure the existing Product Search widget to search for content other than products.
15.      Go to Content → Page & Templates → Theme Layout.
16.      Click the Theme Layout option.

...

  1. (recommended). If this is enabled, as the user types in the search box, products linked to a partial (unfinished) word will be displayed. Leave this box unticked if you want the search to find the exact whole word entered.  (Note - partial word search is not yet enabled for content pages.)  

    Image Added

  2. To save the settings, click Update.

  3. Click the Indexing tab.

  4. To reindex content pages, click the Reindex Page Content button.
    Image Added

    Info

    Every time you add a new content page or update an existing one to your site, the new content will only be searchable after reindexing.


3. Set Product Search widget to include content pages

The Product Search widget, which provides the search facility on your site, needs to be set to include content pages. 

  1. Navigate to Content → Page & Templates → Theme Layout.

  2. Click the Theme Layout option.

  3. Locate the Product Search widget and click Edit. In our example,

...

  1. this widget is under Zone:HeaderColumn2.
Image Removed

...

  1. Product Search widgetImage Added

  2. In the Product Search window, locate Static Content Search and select 'Include Static Content Search

...

Image Removed
19.      Click on the Titles tab, where you can change the search results headings.
Image Removed
20.      Select Save, and if you have your site set to Page Preview, then Publish the changes.
21.      You can customise the zero results returned message in the new Page Content Search Result Template. You can locate that template via Content → Page & Templates → Other Page & Templates.

Image Removed

22.      Click to Edit the new Page Content Search Result widget.
Image Removed

...

  1. '. (Note - if you are creating a search for content pages only, then select 'Static Content Search Only'.)

    Product Search boxImage Added

  2. In Use Suggestions?, decide whether the search box will display 'Suggestions', (i) or (ii).  (For more on 'Use Suggestions, refer to Product Search widget help.)

     (i) Toggle OFF: no content page suggestions will be displayed as the user types in the Search box. After typing in the keyword(s), the user clicks 'Search' or presses 'Enter' to run the search. 
    Image Added 

    (ii) Toggle ON: web page suggestions will be displayed. Decide whether you want to set a maximum number of suggestions to display and go through the steps in either (a) or (b). (Note - if toggled on, both product and content suggestions must have maximum numbers.)

    (a) Set no maximum number of results displayed

    Image Added

    1. Ensure Limit the Product and Static Content Result Returned? is off.
    Image Added
    2. Decide whether you want to use a 'Search Suggestions' heading. Scroll down to Show Search Suggestions Heading? and toggle on or off.

    Image Added

    3. If show heading is on, you can edit the heading text. Click the Titles tab and edit the Search Suggestions Heading Text

    Image Added

    (b) Limit maximum number of results displayed

    Image Added

    1. Ensure 'Limit the Product and Static Content Result Returned?' is on.   

    Image Added

    2. In 'Static Content Search Result to Display', enter the maximum number of results to display. 

    If there are more results than the maximum number, the button 'View More Pages' will appear for the user to click to view more results. 

    3. To edit the text in the 'View More Pages' button, click the Buttons tab and edit the content in View More Pages Button Text

    View More Pages buttonImage Added

    Info
    titleHeadings

    Note - Suggestions headings are not used and 'Related Products' and 'Related Pages' default instead.  




     

  3. When you have finished configuring the widget, click Save and if your site is in Page Preview mode, click Publish to effect the changes on your site.

4. Customise the Page Content Search Result template (optional)

You can edit the message that displays when a search yields no content results.

  1. Navigate to Content → Page & Templates → Other Page & Templates.
    Image Added

  2. Click Edit for the Page Content Search Result Widget.
    Image Added

  3. Click the Notification tab and edit the message. 
    Image Added

  4. Click Save, and if you have your site set to Page Preview, then click Publish

...

  1.  to effect the changes.
Image Removed

...


5. Configure the Product List Title widget

  1. Navigate to Content → Page & Templates → Products → Product List.

...


  1. The Product List Title widget should be at the top of the Product List page. Click

...

  1. Edit.

...


  1. The Static Web Pages Found Message

...

27.      You can leave the message as the default, or alter it to reflect the language and tone of your site. 

Image Removed

...

  1. displays text relating to search results for content pages. In the default message '{0} web page(s) found with contents related to your search', '{0}' = the number of pages found.
    Change the message to suit the tone of your business if required. 
    Product List Title widgetImage Added

  2. Click Save at the bottom of the page. If

...

  1. your site is set to 'Page Preview',

...

  1. click Publish to effect the changes on your site.

6. Turn off 'Direct Product Display'

Product Search can be set so that if the search finds only one product, the system will automatically redirect to its product page. This feature should be turned off for searches that include Content Pages.

To ensure it is off: 

  1. Navigate to SettingsSettings.
  2. Under the 'General' tab, find 'Allow Redirect To ProdView For Single SearchResult' and make sure it is not ticked.
  3. If it is ticked, untick it and click Update.

7. Test the reconfigured search for content

Once Product Search with Content Page results is configured, you can test it to ensure it is as required for your website.

  1. Perform a search to see what results are returned.

...

  1. What is displayed depends on the configurations entered in the Product List Title widget

...

  1. .

...


  1. Product Search with contentImage Added
    If you search returns no results,

...

  1. the "no results" message from the Product Search widget's notification tab

...

  1. is displayed.
    Image Modified

...

  1. If

...

Image Removed
32.      We can confirm we have those Articles in our system by navigating in CMS to Content → Articles. Click Edit.
Image Removed
33.      We can see that we have three articles with our keyword "article" in their heading.
Image Removed

34.      If we search for a partial word that is not in a title, the system will also return results.

Image Removed

35.       If you hit return on the Search Suggestions instead of clicking the "n web pages found" message, then the system will return a list of web pages that contain the keyword and a list of products that match it.

            In this example, 1 web page and no products match the keyword. 

Image Removed

36.      You can click on the web page results to display the static content.

37.      If your keyword matches products and static content, then searching and pressing return will give the following results.

Image Removed

38.      In our example, we have Product Suggestions turned on in the Product Search widget, so the product search returned product names that are spelled similarly to our keyword.

The static content search facility will allow your customers to search on content other than products. Explore the search results and tinker with the widgets detailed in this knowledge base article until you are confident with the results.

Additional Information

Multiexcerpt
MultiExcerptNameAdditional Info

Make sure you enable Partial Word Search in your Lucene Search Indexing so your customers don't have to know the exact name of your static content to find it.

  1. the keyword entered has product and content results, then pressing 'Enter' will list the web pages and products found. Clicking on the number, '4' in the example, will take you to the list of content pages where you click through to the content page.

    Search Results pageImage Added

    Image Added




Additional Information


Minimum Version Requirements


Multiexcerpt
MultiExcerptNameMinimum Version Requirements

4.

...

23


Prerequisites


Multiexcerpt
MultiExcerptNamePre reqs

...

--


Self Configurable


Multiexcerpt
MultiExcerptNameSelf Configurable

Yes


Business Function


Multiexcerpt
MultiExcerptNameBusiness Function

...

Site Optimisation


BPD Only?


Multiexcerpt
MultiExcerptNameBPD Only

Yes


B2B/B2C/Both


Multiexcerpt
MultiExcerptNameB2B/B2C/Both

Both

...

Multiexcerpt
MultiExcerptNameBallpark Hours From CV (if opting for CV to complete self config component)

Contact CV Support

...

...

Contact CV Support

Multiexcerpt
MultiExcerptNameCMS Category

Advanced Settings Lucene

...


Third Party Costs


Multiexcerpt
MultiExcerptNameThird Party Costs

...

N/A

...

n/a



Related help

Content by Label
showLabelsfalse
max5
spacesKB
showSpacefalse
sortmodified
reversetrue
typepage
cqllabel in ("

...

product-search-lucene","website-product-search","

...

product-search") and type = "page" and space = "KB"
labelsnew ver41400


Multiexcerpt
hiddentrue
MultiExcerptNameFeatures List Headers

Macro Instructions for carrying Article Information through to Feature List

Minimum

Version

Requirements

BPD

ONLY


Business Function

CMS Category

B2B
B2C

BOTH

Feature

Feature Description

(Written for our customers and can be pasted into comms sent to them)

Additional info

Pre-Reqs/
Gotchas

Self Configurable

Ballpark Hours
From CV

(if opting for CV to complete self config component)

Ballpark Hours
From CV

(in addition to any self config required)

Third Party Costs

Instructions for carrying Excerpts through from this page to the Feature List

Article Page:

Add macro  / Multiexcerpt (or copy and existing excerpt and edit) or (Copy existing page and place content into existing excerpt macros)

On Features List page:

Click in the Cell to be populated  / add macro /  Multiexcerpt Include / Select the Article page and the excerpt (or copy another feature line and edit the 'Article page' source.