Overview

In typical use, the Search facility ('Product Search' widget) on your site (usually located in the themes layout) is used by website visitors to look for products. They type in keywords, usually product names or codes, and the search results find products you are selling linked to those keywords. Content (web) pages that contain the keywords are not automatically indexed and so, are not included in the results. You can now choose to include such content if you wish, or even add another Search facility just for finding such pages.     

redo images?

How does Content Search work?

When 'Static Content Search' is selected to be included in the Search facility, the search engine will index publicly accessible page content so it is searchable.

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 feature, navigate to Settings → Feature Management → Content
   
   
2. In the list of features, toggle on Content Search and click Configure.
   
   
   
3. In the 'Content Search Settings' window, toggle on Enable Content Search Feature.
   
   
   
4. In Page Content Reindex Task Start Date, set the schedule to a few minutes in the future.
   
   
5. In Page Content Reindex Task Period in Minutes, accept the default or enter the period in minutes before the system will reindex content pages.
   
   
6. To save any changes and exit, click Save and Exit.

2. Configure Indexing Settings

Content pages on your site need to be analysed and added to the search engine's database of web pages to be 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.
   
   
3. To enable indexing, tick the Enabled checkbox.
   
   
   
   
4. Tick Perform Partial Word Searches (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 words in content pages will not appear.) - check   
   
   
   
   
5. To save the settings, click Update.
   
   
6. Click the Indexing tab.
   
   
7. To reindex content pages, click the Reindex Page Content button.
   

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, this widget is under Zone:HeaderColumn2.
   
   
   
4. In the Product Search window, locate Static Content Search and select 'Include Static Content Search'. (Note - if you are creating a search for content pages only, then select 'Static Content Search Only'.)
   
   
   
   
5. If you want to limit the number of results returned for content pages in the search box,
   a. Scroll down to 'Limit the Product and Static Content Result Returned?' and ensure it is toggled on.
   b. In 'Static Content Search Result to Display', enter the maximum number of results to appear.
   
   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. 
   
   
   
6. If 'Show Search Suggestions' is on, click on the Titles tab and edit the 'Search Suggestions Heading text' as required.
   
7. 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 message that is displayed if a search yields no results.

1. Navigate to Content → Page & Templates → Other Page & Templates.
   
   
   
2. Click Edit for the Page Content Search Result widget.
   
   
   
3. Click the Notification tab and edit the message. 
   
   
   
4. Click Save, and if you have your site set to Page Preview, then click Publish to effect the changes.
   
   

5. Configure the Product List Title widget

1. Navigate to Content → Page & Templates → Products → Product List.
   
   
2. The Product List Title widget should be at the top of the Product List page. Click Edit.
   
   
3. The Static Web Pages Found Message 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}' is the number of pages found.
   Change the message to suit the tone of your business if required. 
   
   
   
4. Click Save at the bottom of the page. If your site is set to 'Page Preview', 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 Settings → Settings.
2. Under the 'General' tab, find 'Allow Redirect To ProdView For Single SearchResult' and make sure it is not checked.
3. If it is checked, uncheck it and click Update.

7. Test the reconfigured search for content

1. Perform a search to see what results are returned. You should be able to see the message from the Product List Title widget in the results display.
   
   
   If you search returns no results, ensure your "no results" message from the Product Search widget's notification tab is displayed.
   
2. If we click on the Search Suggestions message highlighted in red in the image from Step 1, the system will bring up a list of pages in our site that contain the keyword.
   
   
   
   
3. If we search for a partial word that is not in a title, the system will also return results.
   
4. 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. 
   
5. You can click on the web page results to display the static content.
   
   
6. If your keyword matches products and static content, then searching and pressing return will give the following results. 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.
   
   

Additional Information

Related help

Related articles appear here based on the labels you select. Click to edit the macro and add or change labels.