Difference between revisions of "Listings Module"

From JReviews Documentation
Jump to: navigation, search
Line 1: Line 1:
== The Listings Module can be used for displaying ==
+
*the Listings Module can be used for displaying:
*Latest Listings
+
**Latest Listings
*Top User Rated Listings
+
**Top User Rated Listings
*Worst User Rated Listings
+
**Worst User Rated Listings
*Top Editor Rated Listings
+
**Top Editor Rated Listings
*Most Reviewed Listings
+
**Most Reviewed Listings
*Random Listings
+
**Random Listings
*Featured Random Listings
+
**Featured Random Listings
*Popular Listings
+
**Popular Listings
  
  
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>
  
  

Revision as of 22:40, 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