Range Module

From JReviews Documentation
Revision as of 14:15, 1 February 2011 by Jreviews (Talk | contribs)

Jump to: navigation, search

Range Module shows a clickable list of numeric range options for the chosen custom field.

It is mostly used for Price Range links.

When visitor clicks on a certain link, he will get a search results page with a list of listings that belong to that price range.


Example of the module layout

RangeModule.png

  • when someone clicks on the '$0-$100' link, he will get a list page with product listings that are priced between $0 and $100
  • to change the layout of the module, edit this theme file
    • \com_jreviews\jreviews\views\themes\default\modules\range.thtml


Module's Parameters

FieldsModuleParameters1.png

  • Module Class Suffix - a suffix will be applied to the CSS class of the module. This allows individual module styling
  • jReviews Template Suffix - suffix to be applied to the global search results theme file
  • Itemid selection
    • you can control the itemid used for the field option links so that modules on the current page are seen or not on the result list
    • (None | Current page | Use Itemid below )


RangeModuleParameters.png

  • Display mode - (Links horizontal | Links vertical | Dropdown list )
  • Field name (i.e. jr_fieldname) - you should use a decimal custom field for prices
  • Ranges - enter the numeric ranges in the specified format. The last value without an upper range will be used to show all numbers above that value
  • Option Prefix - use for units, currency, etc.
  • Option Suffix - use for units, currency, etc.
  • Range separator - goes in between the numbers in the range
  • Before text - this text will appear before the list. You can use html tags


FieldsModuleParameters3.png

  • Category Auto Detect - if a category is found for the page, the results will be limited to that category. If it is a section list, then the results will be limited to categories for that section
  • CriteriaID - limit results to all categories with the same criteria (listing type)
  • CategoryID - limit results to specified categories
  • Custom URL parameters - add any other custom search parameters you want. This could be custom ordering (i.e. order:jr_price)