Difference between revisions of "JReviews:ShortCodes"
From JReviews Documentation
| Line 5: | Line 5: | ||
<pre> | <pre> | ||
| − | [jreviews type="listings" | + | [jreviews type="listings" listing_alias="westville-east" summary="1"] |
</pre> | </pre> | ||
| Line 24: | Line 24: | ||
| '''Parameter''' || '''Example''' || '''Description''' | | '''Parameter''' || '''Example''' || '''Description''' | ||
|- | |- | ||
| − | | | + | | listing_alias || listing_alias="westville-east" || Alias of a specific listing |
|- | |- | ||
| listing_order || listing_order="latest" || Available options: latest, rdate, rating, rrating, topratededitor, raviews, random, featuredrandom, rhits, proximity | | listing_order || listing_order="latest" || Available options: latest, rdate, rating, rrating, topratededitor, raviews, random, featuredrandom, rhits, proximity | ||
Revision as of 13:17, 14 September 2016
JReviews Shortcodes allow you to embed listings or reviews inside an article text.
For example, this shortcode would display a listing with an alias "westville-east":
[jreviews type="listings" listing_alias="westville-east" summary="1"]
Inside an article that shortcode displays this:
There are two types of shortcodes:
- listings - reuses the functionality of the Listings Module
- reviews - reuses the functionality of the Reviews Module
Listings shortcode
There are many parameters that you can use:
| Parameter | Example | Description |
| listing_alias | listing_alias="westville-east" | Alias of a specific listing |
| listing_order | listing_order="latest" | Available options: latest, rdate, rating, rrating, topratededitor, raviews, random, featuredrandom, rhits, proximity |
| summary | summary="0" | 0 - disabled, 1 - enabled |
| summary_words | summary_words="10" | Number of words |
| show_category | show_category="0" | 0 - disabled, 1 - enabled |
| fields | fields="jr_state,jr_city" | Comma separated list of custom fields to show |
| editor_rating | editor_rating="0" | 0 - disabled, 1 - enabled |
| user_rating | user_rating="1" | 0 - disabled, 1 - enabled |
| tmpl_suffix | tmpl_suffix="_vertical" | Theme file suffix. The default theme used is /modules/listings.thtml |
| tn_show | tn_show="1" | 0 - disabled, 1 - enabled |
| tn_position | tn_position="left" | Available options: left, right, top, bottom |
| tn_mode | tn_mode="scale" | Available options: crop, scale |
| tn_size | tn_size="100x100" | Thumbnail size in WIDTHxHEIGHT format |
| cat_auto | cat_auto="0" | 0 - disabled, 1 - enabled |
| dir | dir="1" | Directory IDs |
| category | category="22" | Category IDs |
| listing | listing="51" | Listing IDs |
| nav_position | nav_position="bottom" | Available options: bottom, side |
| total | total="10" | Max. number of results |
| limit | limit="5" | Results per page |
| columns | columns="2" | Number of columns |
| show_numbers | show_numbers="0" | 0 - disabled, 1 - enabled |
| compare | compare="0" | 0 - disabled, 1 - enabled |
Examples
10 top rated listings:
[jreviews type="listings" listing_order="rating" columns="2" total="10" limit="10" show_numbers="1"]
Latest listings from the category that has ID 23:
[jreviews type="listings" listing_order="latest" category="23" total="6" limit="6"]
Reviews shortcode
Available parameters:
| Parameter | Example | Description |
| reviews_order | reviews_order="latest" | Available options: latest, helpful, random |
| reviews_type | reviews_type="all" | Available options: all, user, editor |
| show_comments | show_comments="0" | 0 - disabled, 1 - enabled |
| comments_words | comments_words="10" | Number of words |
| fields | fields="jr_pros,jr_cons" | Comma separated list of review custom fields to show |
| tmpl_suffix | tmpl_suffix="_vertical" | Theme file suffix. The default theme used is /modules/listings.thtml |
| tn_show | tn_show="1" | 0 - disabled, 1 - enabled |
| tn_position | tn_position="left" | Available options: left, right, top, bottom |
| tn_mode | tn_mode="scale" | Available options: crop, scale |
| tn_size | tn_size="100x100" | Thumbnail size in WIDTHxHEIGHT format |
| extension | extension="com_jreviews" | Name of the extension from which reviews will be displayed. Required when using filters below. |
| cat_auto | cat_auto="0" | 0 - disabled, 1 - enabled |
| dir | dir="1" | Directory IDs |
| category | category="22" | Category IDs |
| listing | listing="51" | Listing IDs |
| nav_position | nav_position="bottom" | Available options: bottom, side |
| total | total="10" | Max. number of results |
| limit | limit="5" | Results per page |
| columns | columns="2" | Number of columns |
| show_numbers | show_numbers="0" | 0 - disabled, 1 - enabled |
Examples
10 most helpful user reviews:
[jreviews type="reviews" reviews_order="helpful" reviews_type="user" columns="2" total="10" limit="10" show_numbers="1"]
Latest reviews:
[jreviews type="reviews" review_order="latest" total="6" limit="6"]