You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 9 Next »

The product display page now provides the ability to display favourites or prior purchases along with bringing the ability to apply products sorting, filtering, paging and feature filtering to the favourites

Page Modes

There are two query string arguments that you may need to use, in menu items for example, depending on what you want to achieve. The ProductDisplay.aspx page has two modes indicated by these two new query string arguments:

  • User Favourites
    • The query string argument of "UserFavourites=true" must be present to enable this mode. If the UserFavourites key is provided and the value is "true" (case-insensitive) then the page will render the user favourites, if the key is not there or the value is anything else the page will obey any other flags or fall-back to the default behaviour
    • This scenario will always result in the User Favourites being returned
  • Prior Purchases Mode
    • The query string argument of "PriorPurchases=true" must be present to enable this mode. If the PriorPurchases key is provided and the value is "true" (case-insensitive) then the page will render the customer favourites, if the key is not there or the value is anything else the page will obey any other flags or fall-back to the default behaviour
    • This scenario will return no results unless one of the following conditions is true
      • The user is a sales rep and the "Display Customer Favourites for Reps" setting is enabled
      • The current user's role has its "Enable Customer Favourites" setting enabled.

On this page:

Supporting Query String Arguments

These two modes also support the following already existing supplementary arguments:

  • SortProduct - the value supplied for this query string argument will be considered the product field that the data will be sorted by. For example, if "SortProduct=Description" is put into the query string then the data will be sorted by the description field (ascending order)
  • FilterProduct - the value supplied for this query string argument is considered to be a complex filter condition. This condition allows filtering the product by those records who's field contains the value in question. For example the condition might be "FilterProduct=description:lk:paper" which would result in the favourites/prior-purchases being further filter down to those products that have a description that is like (lk) or contains the word "paper"
  • FilterFeature - the value supplied for this query string argument is considered to be a complex filter condition, which allows complex filtering based on separate meta-data associated with individual products. This functionality is far beyond the scope of this document.
  • PageProduct - the value supplied for this query string argument will be considered the page of data to get from the full product results. So if 2 is given as the value only the 2nd page of results will be shown.
  • Template - the value supplied for this query string argument will be considered to be an override template for the system to use. So instead of using the Role/System level templates (explained in Templates section below) the template will be overridden with the one in the value of this query string argument.

Templates

There are both system level and role level settings available for configuring the new templates.

The System level settings are on the zAllocate.aspx page and the Role level settings are on the zRoles.aspx pages Functionality tab (configurable per role)

The Role level templates, if not set, will fall back to their System level equivelants

On both pages the labels are:

  • Product Display User Favourites Template - configures the User Favourites mode template to use 
  • Product Display Prior Purchases Template - configures the Prior Purchases mode template to use

Step-by-step guide

The steps to setup this functionality are as follows:

  1. As administrator, go to either System Level or Role Level templates.
    1. System Level Templates
      1. Go to zAllocate.aspx
      2. Find the Product Display User Favourites Template or Product Display Prior Purchases Template settings and either select or create a template for the relevant (or both) of the settings as required
    2. Role Level Templates
      1. Go to zRoles.aspx
      2. Tick Enable Customer Favourites. 
      3. Select the role you want to configure one, or both of the new templates for
      4. Choose the Functionality tab
      5. Find the Product Display User Favourites Template or Product Display Prior Purchases Template settings and either select or create a template for the relevant (or both) of the settings as required
  3. Setup a Menu Item (as an example) to point to the ProductDisplay.aspx page with the addition of a "UserFavourites=true" or a "PriorPurchases=true" query string argument for the menu items. This will result in the menu-item/page rendering the user favourites or prior purchases on the ProductDisplay.aspx page

  • No labels

© Copyright 2001-2023 Commerce Vision Pty Ltd. Use of this site signifies your acceptance of Commerce Vision’s Terms & Conditions. CV Connect, the Commerce Vision logos, and other Commerce Vision marks are assets of Commerce Vision Pty Ltd.