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:
- Login as an administrator
- Setup System Level or Role Level templates
- System Level Templates
- Go to zAllocate.aspx
- 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
- Role Level Templates
- Go to zRoles.aspx
- Select the role you want to configure one, or both of the new templates for
- Choose the Functionality tab
- 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
- System Level Templates
- 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
Related articles