Difference between revisions of "Listings Module"

From JReviews Documentation
Jump to: navigation, search
Line 15: Line 15:
  
 
*the module displays listing's thumbnail, title, category, editor and user rating.
 
*the module displays listing's thumbnail, title, category, editor and user rating.
*to modify the layout, the theme file of the listings Listings Module is located here:  
+
*to modify the layout, the theme file of the Listings Module is located here:  
 
**<span style="color: blue">\com_jreviews\jreviews\views\themes\default\modules\listings.thtml</span>
 
**<span style="color: blue">\com_jreviews\jreviews\views\themes\default\modules\listings.thtml</span>
  
Line 21: Line 21:
 
== Module's Parameters ==
 
== Module's Parameters ==
 
[[File:ListingsModuleParameters1.png]]
 
[[File:ListingsModuleParameters1.png]]
*'''Everywhere Extension''' - This is a universal module that works not only with core JReviews  listings, but also with 3rd party components integrated via the [[JReviews Everywhere Add-on|Everywhere Add-on]]. The module can only display listings from one component at a time so you need to enter the component's name here (i.e. com_content, com_sobi2, com_k2, etc.)
+
*'''Everywhere Extension''' - This is a universal module that works not only with core JReviews  listings, but also with 3rd party components integrated via the [[JReviews Everywhere Add-on|Everywhere Add-on]]. The module can only display listings from one component at a time, so you need to enter the component's name here (i.e. com_content, com_sobi2, com_k2, etc.)
 
*'''Custom WHERE''' - custom where for query (i.e Field.jr_brand LIKE '%Canon%')
 
*'''Custom WHERE''' - custom where for query (i.e Field.jr_brand LIKE '%Canon%')
 
*'''Custom ORDER BY''' - overrides listing ordering (i.e Field.jr_brand DESC)
 
*'''Custom ORDER BY''' - overrides listing ordering (i.e Field.jr_brand DESC)
Line 28: Line 28:
 
[[File:ModuleParametersSuffix.png]]
 
[[File:ModuleParametersSuffix.png]]
 
*'''JReviews Template Suffix''' - this parameter allows you to use a different theme file for each published instance of the module.
 
*'''JReviews Template Suffix''' - this parameter allows you to use a different theme file for each published instance of the module.
*'''Module Class Suffix''' - a suffix will be applied to the CSS class of the module. This allows individual module styling
+
*'''Module Class Suffix''' - a suffix will be applied to the CSS class of the module. This allows individual module styling.
  
  

Revision as of 22:18, 31 January 2011

The Listings Module can be used for displaying:

  • Latest Listings
  • Top User Rated Listings
  • Worst User Rated Listings
  • Top Editor Rated Listings
  • Most Reviewed Listings
  • Random Listings
  • Featured Random Listings
  • Popular Listings


Example of the module layout

ListingsModule.png

  • the module displays listing's thumbnail, title, category, editor and user rating.
  • to modify the layout, the theme file of the Listings Module is located here:
    • \com_jreviews\jreviews\views\themes\default\modules\listings.thtml


Module's Parameters

ListingsModuleParameters1.png

  • Everywhere Extension - This is a universal module that works not only with core JReviews listings, but also with 3rd party components integrated via the Everywhere Add-on. The module can only display listings from one component at a time, so you need to enter the component's name here (i.e. com_content, com_sobi2, com_k2, etc.)
  • Custom WHERE - custom where for query (i.e Field.jr_brand LIKE '%Canon%')
  • Custom ORDER BY - overrides listing ordering (i.e Field.jr_brand DESC)


ModuleParametersSuffix.png

  • JReviews Template Suffix - this parameter allows you to use a different theme file for each published instance of the module.
  • Module Class Suffix - a suffix will be applied to the CSS class of the module. This allows individual module styling.


ModuleParametersPagination.png

  • Enable Ajax Pagination - allows users to navigate to other pages inside the module without page reloads
  • Plugin width (px) - required only when Ajax Pagination is enabled
  • Plugin height (px) - required only when Ajax Pagination is enabled
  • Limit results - sets the number of results shown in the module
  • Columns - number of columns or items per row to show


ModuleParametersCats.png

  • Category Autodetect - JReviews will try to determine the category id and show only results for that category. If enabled, this setting overrides all the ID settings below it.
  • To use filtering by IDs you must enter "com_content" in the Everywhere extension parameter


ModuleParametersThumb.png

  • Thumbnail Type - Scale creates thumbnail with specified width. Height is scaled proportionately. Crop takes a square from the center of the image and scales to the specified width


ListingsModuleParameters2.png

  • Filter: Listings submitted in past x days - filter the results to use listings submitted in the past x days
  • Filter: Listings with reviews submitted in past x days - filter the results to use reviews submitted in the past x days
  • Filter: Listings with review count higher than - filter the results to listings having at least the defined number of reviews
  • Filter: Avg rating higher than - filter the results to listings with rating higher than the defined number