Difference between revisions of "Customizing the list page"

From JReviews Documentation
Jump to: navigation, search
Line 1: Line 1:
Theme files of the section/category list page are located here:
 
*<span style="color: blue">\com_jreviews\jreviews\views\themes\{theme_name}\listings\listings_header.thtml</span> - header, included on every list page
 
*<span style="color: blue">\com_jreviews\jreviews\views\themes\{theme_name}\listings\listings_blogview.thtml</span> - used if you selected Blogview as 'Display Type' in JReviews [[Configuration Settings]]
 
*<span style="color: blue">\com_jreviews\jreviews\views\themes\{theme_name}\listings\listings_tableview.thtml</span> - used if you selected Tableview as 'Display Type'
 
*<span style="color: blue">\com_jreviews\jreviews\views\themes\{theme_name}\listings\listings_thumbview.thtml</span> - used if you selected Thumbview as 'Display Type'
 
*<span style="color: blue">\com_jreviews\jreviews\views\themes\{theme_name}\listings\cmsblog.thtml</span> - used on Joomla frontpage and on Joomla Blogsection/Blogcategory pages
 
  
 +
List pages display a list of listings. Those are category pages, search result pages and any other special type of pages which displays multiple listings.
  
Before making any changes, read [[How does the JReviews Theme Engine work]] and copy the files to "jreviews_overrides" folder.
+
Here is an [http://demo.reviewsforjoomla.com/city-guide/hotels example of a category list page on the demo site].
  
 +
There are 4 different layouts available for list pages: Blogview, Tableview, Thumbview and Masonry. Each of those have their own theme files:
 +
*<span style="color: blue">/com_jreviews/jreviews/views/themes/default/listings/listings_blogview.thtml</span> - Blogview
 +
*<span style="color: blue">/com_jreviews/jreviews/views/themes/default/listings/listings_tableview.thtml</span> - Tableview
 +
*<span style="color: blue">/com_jreviews/jreviews/views/themes/default/listings/listings_thumbview.thtml</span> - Thumbview
 +
*<span style="color: blue">/com_jreviews/jreviews/views/themes/default/listings/listings_masonry.thtml</span> - Masonry
  
== Structure of the list page ==
 
  
=== listings_header.thtml ===
+
Before making any theme changes, read about [[JReviews Code Overrides]] and create a custom theme.
*<nowiki><div class="jr_pathway"></nowiki> - '''JReviews breadcrumbs'''
+
Every list page also includes a separate &quot;list page header&quot; theme file which contains the pagination, page title, category list, etc. This is the theme file:
*<nowiki><div class="jr_rss"></nowiki> - '''RSS icons'''
+
*<span style="color: blue">/com_jreviews/jreviews/views/themes/default/listings/listings_header.thtml</span>
*<nowiki><h1 class="contentheading"></nowiki> - '''page title'''
+
*<nowiki><div class="jr_pgDescription"></nowiki> - '''page description'''
+
*<nowiki><div class="jr_listScope roundedPanel"></nowiki> - '''rounded box with section name and categories'''
+
*<nowiki><div class="jr_itemList_new"></nowiki> - '''add new listing link'''
+
  
=== listings_blogview.thtml ===
 
*<nowiki><table class="jr_pagination"></nowiki> - '''top pagination'''
 
*<nowiki><div class="jr_blogview"></nowiki> - '''all listings'''
 
**<nowiki><div class="listItem"></nowiki> - '''listing'''
 
***<nowiki><div class="contentColumn"></nowiki> - '''rating table and thumbnail'''
 
***<nowiki><div class="contentTitle"></nowiki> - '''listing title and icons'''
 
***<nowiki><div class="contentInfo"></nowiki> - '''author details, date, hits'''
 
***<nowiki><div class="jr_customFields"></nowiki> - '''custom fields'''
 
***<nowiki><div class="contentIntrotext"></nowiki> - '''summary text'''
 
***<nowiki><div class="contentActions"></nowiki> - '''read more links'''
 
*<nowiki><table class="jr_pagination"></nowiki> - '''bottom pagination'''
 
  
  

Revision as of 14:49, 6 January 2014

List pages display a list of listings. Those are category pages, search result pages and any other special type of pages which displays multiple listings.

Here is an example of a category list page on the demo site.

There are 4 different layouts available for list pages: Blogview, Tableview, Thumbview and Masonry. Each of those have their own theme files:

  • /com_jreviews/jreviews/views/themes/default/listings/listings_blogview.thtml - Blogview
  • /com_jreviews/jreviews/views/themes/default/listings/listings_tableview.thtml - Tableview
  • /com_jreviews/jreviews/views/themes/default/listings/listings_thumbview.thtml - Thumbview
  • /com_jreviews/jreviews/views/themes/default/listings/listings_masonry.thtml - Masonry


Before making any theme changes, read about JReviews Code Overrides and create a custom theme. Every list page also includes a separate "list page header" theme file which contains the pagination, page title, category list, etc. This is the theme file:

  • /com_jreviews/jreviews/views/themes/default/listings/listings_header.thtml