Advanced Search Module

SmithCart > Modules

The Advanced Search module can be placed in any pane on any page and allows you to search products in your catalog using custom dropdowns, categories and keywords. 

Please Note: The search module is not required to provide users the ability to search for products in your store. Full product catalog search capability is included in the BuyNow module and also using the built in DNN search box.

Contents



Adding the Advanced Search Module

The Advanced Search module can be placed in any pane on any page in your portal

After you have added the Search module to a page you will see the following:

Hover you mouse over the context menu of the module and click “settings” and the following screen will be displayed:

Configure the Setting you wish to use and click the Save button at the bottom of the screen to save your settings.

[up to contents]



Search Module Setup

BuyNow Page Name – Allows the store admin to configure which BuyNow module to search products in and redirect to display search results.

Button Theme – Select the button color you want the search module to use.

Single Search Box Layout – Select this option if you want to configure the search module to be displayed to the user as a single row textbox search. If you select the Single Search Box Layout option, the search module will be displayed in a style similar to the native DNN search module.

Multi Row Layout – User Defined Fields – Select this option if you want to configure the search module to be displayed in a multi row layout allowing the user to run more complex “and/or” searches on multiple custom fields you configure.

Multi Row Layout - Custom Product Fields – Select this option if you want to configure the search module to be displayed in a multi row layout allowing the user to run more complex “and/or” searches on multiple Custom Product Fields you configure.

[up to contents]



Single Search Box Layout Setup

When you select the Single Search Box Layout option the following settings will be displayed:

Show Product Role Filtering Dropdown – Checking this box will turn the search box into a combo box allowing the user to select from dropdown list options for more granular filtering options on the search term entered into the search box.

Dropdown List Filtering Options – f you have checked the “Show Product Role Filtering Dropdown” checkbox, you must select one or more of the following dropdown list filtering options:

  • All - Public and Role Secured – The “All” option will search across all products, both public viewable products and products you have defined as only viewable by DNN role.
  • Public Only – he “Public Only” option will allow searching of public viewable products only. Products you have defined as viewable by only certain DNN roles will be excluded from the search.
  • Role Only – The “Role Only” option will allow searching of Products you have defined as viewable by DNN role. Products you have defined as public viewable will be excluded from the search.

[up to contents]



Single Search Box Layout User Experience

The following section describes the single search box user experience and the dropdown list filter options when the user is logged in and when the user is not logged in (anonymous).

 

User Not Logged In

When the user is not logged in (anonymous) the following will happen:

  • The Search module will not display a dropdown list of filtering options.
  • Only the public viewable product in your catalog will be searchable. Any products you have defined as viewable by DNN role will be excluded from the search.

See the following mockup of the search module when a user is not logged in:

If the user opens the dropdown list notice the “All” list option is the only filtering option displayed:

 

User Logged In

When the user is logged in the search module will display the dropdown with the following options to search:

  • All Products – Public and role secured products.
  • Public Products Only – Products from your catalog that are publicly viewable.
  • Role Based Products – Products from your catalog that are only visible by a certain DNN role you have defined for a particular product.

See the following mockup of the search module when a user is logged in:

Please Note: In order for role secured products to be returned in the search results the user must be logged in and a member of the DNN role that matches the DNN role defined for the product.

[up to contents]



Multi Row Search Layout - User Defined Fields Setup

When you select the Multi Row Search Layout option in the search module settings, the following setup options will be displayed:

 

 

Show Dropdown 1 & 2 – Check this box to display the custom dropdown list to the user as a product filtering option in the search module.

Please Note: If you configure the Search Module to display dropdown #1 or #2, it requires that you configure search terms in the product setup screen. Please see the following link for more information on configuring product search terms.  http://helpdesk.smith-consulting.com/kb/a282/search-terms.aspx

Dropdown Label 1 & 2 – Enter a custom label that will be displayed next to dropdown in the search module.

Dropdown Values 1 & 2 – Allows entry of comma separated values to populate dropdown on search module with.  In order to associate products with the dropdown values entered you need to configure product search terms.

Show Category Dropdown – When checked will show a dropdown list in the search module that is populated with category and sub category names in your store.

Category Label – Allows you to enter a custom value that is used as the label for the category dropdown filter in the search module.

Show Textbox – When checked will show a textbox in the search module that allows the user to enter keywords to search on. The search module will a wildcard search on the search terms entered in the search textbox.

Textbox Label – Allows you to enter a custom value that is used as the label for the customer search textbox in the search module.

Show Sort – When checked displays a sort dropdown list in the search module with the following sort options:

  • Custom Dropdown 1
  • Custom Dropdown 2
  • Category
  • Product Price

[up to contents]



Multi Row Search - User Defined Fields User Experience

The following is a screen shot of the search module when it is configured for the multi row search layout:

 

 

When the user selects/enters their search options and clicks “Search” the search module the following will happen:

  • The search module will query the category and product tables looking for products that meet the specified criteria entered by the user.
  • The product listing page is displayed with search results  filtered according to the search criteria.
 

[up to contents]



Multi Row Layout - Custom Product Fields Setup

When you select the Multi Row Layout - Custom Product Fields option in the search module settings, the following setup options will be displayed:

 

 

Custom Product Search Fields - The list box on the left titled “Master Custom Product Fields” contains a listing of all Custom PRoduct Fields currently setup in your store. The list box on the right titled “Selected Custom Product Fields” contains a listing of the products you have selected as Search Fields.

List Columns - Formats the radio button or checkbox list single column or multiple column layout.

List Direction - Formats the radio button or checkbox list in either a vertical or horizontal direction.

[up to contents]



Multi Row Layout - Custom Product Fields Configuration

To configure the Multi Row Layout - Custom Product Fields search option take the following steps:

Step 1 – Create and Configure a Custom Product Field

The first step of configuring the Multi Row Layout - Custom Product Fields option is creating a Custom Product Field and associating the field with a Product. For detailed intructions on configuring a Custom Product Field see the Custom Product Fields KB article

Step 2 – Configure Custom Product Search Fields

The next step of configuring the Multi Row Layout - Custom Product Fields option is configuring the Custom Product Search Fields in the Advanced Search module settings. In the list box on the left, highlight the Custom Product Field you want to add as a Search Field the click the arrow button pointing to the right >>. Click the “Update” button at the bottom to save.

[up to contents]



Multi Row Search - Custom Product Fields User Experience

The following section describes the user experience when the search module is configured for the Multi Row Search - Custom Product Fields layout.

The following is a screen shot of the Search module after you have configured it as shown above:

When the user selects/enters their search options and clicks “Search” the search module the following will happen:

  • The search module will query the Custom Field and Product tables looking for products that meet the specified criteria entered by the user.

  • If the search module finds products in the database that match the specified filter criteria, the user will be redirected to the BuyNow module product listing page and the products will be filtered according to the search criteria entered in the search module.

  • If the search returns no rows, the user will remain on the page with the search module and the search module will display a message “No records found”.

[up to contents]