Kentico CMS 7.0 Tutorial  

Search page

Search page

Previous topic Next topic Mail us feedback on this topic!  

Search page

Previous topic Next topic JavaScript is required for the print function Mail us feedback on this topic!  

Kentico CMS allows users to perform index-based searches through all document content in the Kentico CMS repository, as well as other types of data. This topic describes how to add a basic search page to your website.

 

Creating a smart search index

 

Before you can use the search, you need to add a smart search index covering the website's documents.

 

1. Go to Site Manager -> Administration -> Smart search.

 

2. Click NewIndex New index.

 

3. Fill in the following details for the search index:

 

Display name: My website - Documents

Index type: Documents

Analyzer type: Standard

Stop words: Default

 

4. Click Save Save. The index's editing interface opens.

 

5. Open the Index tab and click View Add allowed content.

 

6. Type /% into the Path field and click Save Save. This ensures that the index includes all documents on the website.

 

7. Switch to the Sites tab and assign the index to My website.

 

8. Switch to the Cultures tab and choose the default culture of your site (typically English - United States).

 

9. Open the General tab and click RebuildIndex Rebuild.

 

Once the system rebuilds the index, you can start using it on the website. The Index info box on the right side of the tab displays the current status of the index and other relevant information.

 

tutorial_clip0221

 

 

InfoBox_Note

 

Searching through uploaded text files

 

You can also configure the CMS to search the text inside uploaded files, such as PDF, DOC or XLS documents. For additional details, see the following chapter in the Kentico CMS Developer's Guide: Installation and deployment -> Additional configuration tasks -> Configuration of full-text search in files

 

You do not need to configure this option now, since we will only use the basic document search in this tutorial.

 

 

Adding the search page

 

1. Return to CMS Desk. Select the root of the content tree (My website) and click New.

 

2. Choose the Page (menu item) document type.

 

3. Type Search as the Page name and choose the Use existing page template option. Select the General category and the Search page template.

 

4. Click Save Save to create the page.

 

5. Click the Down (Down) arrow on the main toolbar to move the Search page to the end of the document list.

 

tutorial_clip0134

 

6. Switch to the Design tab and Configure (Configure) the SearchDialogWithResults web part.

 

7. Click Select next to the Indexes property and choose the My website - Documents search index created in the previous section.

 

8. Click OK.

 

To try out the search functionality, view the /Search page in Live site mode. Type PC into the Search for box and click Search.

 

tutorial_clip0135

 

When you click a search result, the system redirects you to the corresponding page.

 

 

InfoBox_Tip

 

Modifying the format of the search results

 

If you prefer a different design of the search results, you can modify the format by editing the SmartSearchResults (or SmartSearchResultsWithImages) transformation in Site Manager -> Development -> Document types -> Root -> Transformations.