Difference between revisions of "Range Module"

From JReviews Documentation
Jump to: navigation, search
Line 9: Line 9:
  
 
[[File:RangeModule.png]]
 
[[File:RangeModule.png]]
*when someone clicks on '$0-$100' link, he will get a list page with product listings that have price between $0 and $100
+
*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  
 
*to change the layout of the module, edit this theme file  
Line 21: Line 21:
 
*'''jReviews Template Suffix''' - suffix to be applied to the global search results theme file
 
*'''jReviews Template Suffix''' - suffix to be applied to the global search results theme file
 
*'''Itemid selection'''
 
*'''Itemid selection'''
**  you can control the itemid used for the field option links so that modules on the current page are seen on the result list or not
+
**  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'' )
 
** (''None | Current page | Use Itemid below'' )
  

Revision as of 14:15, 1 February 2011

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)