Difference between revisions of "Listings Module"

From JReviews Documentation
Jump to: navigation, search
Line 16: Line 16:
 
*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 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 27: Line 27:
  
 
[[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. Read [[Modifying Listings module]]'s theme file for more details
+
*'''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:39, 23 August 2010

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 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
  • 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.


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