Setup

Sana Commerce 9.3
Your connector

Search

Sana search is based on the Lucene search engine. By adding the product fields to the Lucene index you can extend the web store search functionality.

The fields that can be used to set up filtering and sorting of the products in the web store should be added to the index. In Sana Admin click: Setup > ERP integration > Index fields. On the Index fields tab, you can also set up the keyword fields that allow to search products in the web store by different keywords: title, item number, color, size, description and other.

For more information about index fields, see "ERP Integration".

When the fields are added to the index, you can set up filtering and sorting of products.

Facetted filters



In Sana Admin click: Setup > Navigation & search > Facetted filters.



On the Facetted filters tab you can set up filtering of products by adding facets to the web store on the product list and search results pages.

Using facets, a customer can filter the products in the web store, for example by color, size or brand. The facetted filter is shown in the web store on the left of the product list and search results pages.

For each product list page, you can use either the default facetted filters configured on the Facetted filters tab, or you can set up the page specific filters for any product list page. For more information, see "Product List Pages". 

The tables below provide description of the facetted filters settings.

Facet settings Description
Enable facets multiselection This option allows to select multiple facets on the product list and search results pages at once. For example, you want to filter the products by color and size.

Field Description
Field name This dropdown list presents all fields which can be used to filter the products using facets. Facet fields become available only after they are added to the search index fields.

To add fields to the search index, in Sana Admin click: Setup > ERP integration > Index fields > Filter fields. Thus, when you add a search index field which can be used for facets, it becomes available in the Field name dropdown of the facetted filters. Depending on the type of the field added to the search index, filtering using facets may not be available.
Followed by robots Use this option to allow or forbid search engine crawlers to follow the facet items (links) on the product list and search results pages.
Descending order Use this checkbox to change the order of the facetted filter values on the product list and search results pages. You can sort the values in the ascending or descending order. The order of the facetted filter values is ascending by default. Select the checkbox to change the order.

You can change the order of the facetted filter fields simply by dragging and dropping them. The facets are shown in the web store exactly in the same order as they are defined in the table.

 NOTE

When facets multiselection is enabled, and a user selects multiple filters, each selected facet will be added to the URL. If you have a lot of facetted filters on a page, it may result in a very long URL that cannot be handled and a user will see an error. If a lot of facets are used in your web store, open the In-site editor and click Create page messages at the top pane. Search for the page message with the ProductListUrl_NoneSelected text identifier. Add a short description to these text messages to build the shorter URLs for the facets. For example, if you have filtering by the operating systems, the description can be "OS".


Search & results



To set up search settings in Sana Admin, click: Setup > Navigation & search > Search & results.

Sana provides search settings that allow searching the products by different keywords, phonetic representation of the keywords pronunciation, to narrow or broaden search results, search by a part of the word.

The table below provides the description of the search settings.

Search settings Description
Phonetic search Phonetic search provides the possibility to search text by phonetic representation of the keywords pronunciation. This allows to search products not by the exact spelling of the words, but by their pronunciation. It is useful when the customer does not know the exact spelling of the word or misspelt.

For example, if you are not sure how to spell the word "discount" you can type "diskaunt", "dizkaunt", "discaunt", in the search field, which is close to the pronunciation of the word "discount".
Thumbnails This option allows to show or hide product images on the search results page.
Multiple search terms operator Use multiple terms search operators (AND, OR) to determine the relationship between multiple search terms and as a result to narrow or broaden your search by keywords.
  • AND: Searches for results that include all terms from the query.
    For example, if you search for a "black shirt", the query will return all items that contain both words "black" and "shirt".
  • OR: Searches for all results that include at least one term from the query.
    For example, if you search for a "mountain bicycle", the query will return all items that contain either the word "mountain" or the word "bicycle", or both.
Wildcard search A wildcard is an asterisk character (*) that is used as a placeholder for any sequence of characters or words. Using wildcard, you can search by a part of the word or you can search for a phrase based on core terms. Note, that if wildcard search is enabled, you should not enter the asterisk character (*) in the query, it is used automatically.

Available options:

  • Disabled: If this option is selected, the wildcard search is disabled.
  • Trailing: If this option is selected, the wildcard character is automatically used at the end of the query.
    For example, if you search for "bla", the query will return all items that contain words starting with "bla", for example "black". The query looks "bla*", thus in the example "ck" in the word "black" is substituted with a wildcard character (*).
  • Leading and trailing: If this option is selected, the wildcard character is automatically used at the beginning of the query and at the end.
    For example, if you search for "peak", the query will return all items that contain words with "peak" in it, for example "speaker" or "loudspeaker". The query looks "*peak*", thus in the example "s" and "er" in the word "speaker" are substituted with a wildcard character (*).

Remember that wildcard search can be used to search by a part of the word as well as part of a phrase.

Using search index fields added on the ERP Integration page you can configure sorting of the products in the web store, on the search results and product list pages.

The table below provides the description of the Sort fields.

Field Description
Field name This column presents all fields which can be used for sorting of the products. If you need to add any field, you can do this on the ERP Integration page, in the Filter fields table.

    Depending on the type of the field, sorting may not be available.
Sortable This option allows to sort products by the selected field name.

You can change the order of the sort fields simply by dragging and dropping them. The fields that are used to sort the products are shown on the product list and search results pages in the same order as they are placed in Sana Admin.