Shortcodes

rating_form

Display a Rating Form.

Attribute Description Default Value
id Define rating form by ID 1 Number
post_id Gets automatically the post id or add one manually auto Number
comment_id Gets automatically the comment id or add one manually auto Number
custom_id Define a unique ID for multiple rating forms on same post / page
Allowed characters: letters, numbers, dash - or underscore _
Empty Text
term_id Define term ID of categories or taxonomies 0 Number
user_id Define user by ID 0 Number
title Show / Hide titles (tooltip text) false Boolean
score Show / Hide average ratings true Boolean
total Show / Hide total ratings true Boolean
stats Show / Hide rating statics true Boolean
user_stats Show / Hide user stats after rating statics false Boolean
tooltip Turn tooltip into static title if set to false true Boolean
result Display rating result (You cannot rate) false Boolean
before_content Add HTML / Content before a rating form Empty HTML / Text
after_content Add HTML / Content after a rating form Empty HTML / Text
count_type Change average rating output to percentage. Example: count_type="percentage" Empty Text
rates Change text ratings.
Separate the singular term with a plural term or use one term.
User variable %count% for changing position of 'total votes'
Example:  rates="%count% votes"
%count% rating,%count% ratings Text
txt_score Change score format
%1$s =  Average rating of maximum rating
%2$s = Maximum rating
Example: 4.4 out of 5
%1$s/%2$s HTML / Text
custom_id_group Assign group number of corresponding shortcodes (rating_form_total / rating_form_results). This to trigger live rating results of associated rating forms. Also assign it to the rating form it self. 0 Number

Shortcode Example

3.9/5514 ratings

rating_form_top_rating_results

Display top ratings of different result type (see attribute type).

Attribute Description Default Value
form_id Get style and settings from a Rating Form by ID 1 Number
post_id Get results of a specific post / page ID 0 Number
before_title Add HTML / Content before title HTML / Text
title Change title Top 5 Ratings Text
after_title  Add HTML / Content after title HTML / Text
limit Number of posts 5 Number
content_length Shorten post content length by words 10 Number
content_active Show / Hide post content false Boolean
image_size Size of the featured image of a post in pixels 48 Number
image_active Show / Hide featured image false Boolean
time Set time of given time field  0 Number
time_field Choice of fields: hour, day, week, month
Example: [time="1" time_field="day"]
Check post results of 1 day old
Empty Text / Choice
type Out of which type would you like to see the results?
Choices:
- post_pages
- comments
- taxonomies (for categories, tags etc.)
- users
post_pages Text
post_type Display by selected multiple (custom) post types post,page Array
taxonomy Filter by one or more taxonomies and/or terms within these taxonomy.
Seperate taxonomies by | (vertical bar)
Add terms using : (colon)
Add relation between terms through hyphen like -AND / -OR
- AND: every term in the array must be available
- OR (default behaviour): at least one of the term must be
availableExample shortcode attribute, filter by taxonomy category and computer. Display rating results of posts that are at least in one of the terms basketball OR football:
taxonomy="category:basketball,football|computer"Example shortcode attribute, filter by custom taxonomies computer and laptop. Display only rating results that are in hp, lenovo within taxonomy computer. Remove -AND :
taxonomy="computer-AND:hp,lenovo|laptop"
Empty Text
before_content Add HTML / Content before top results Empty HTML / Text
after_content Add HTML / Content after top results Empty HTML / Text
class Add custom CSS classes Empty Text

Shortcode Example

rating_form_total

Display total average rating result of multiple rating forms that uses custom_id.

Attribute Description Default Value
id Get same style and settings from a Rating Form by ID 0 Number
post_id Gets automatically the post id or add one manually auto Number
comment_id Gets automatically the comment id or add one manually auto Number
custom_id Display average rating result of a custom_id or multiple custom id's
Example multiple: {rating_form_total custom_id="computer,laptop,mobile"}Example: {rating_form_total custom_id="laptop"}
custom_id="0" will display results of a Rating Form with attribute id like the following shortcode: {rating_form id="1"}Change { } to [ ]
Empty Text
term_id Get average total result of a given term ID
term_id are ID's for category, tags and taxonomy
0 Number
round Set decimal of total average rounding 1 Number
live Load total average result through ajax on load
Useful for cache plugins
false Boolean
type Two type of rating result.
tud = Thumps Up and Down ratings
star = 1-5 ratings
star Text / Choice
form Enable to display average rating in stars / thumbs up down depending on given form id. false Boolean
type_count Display specific average result in percentage or real numbers.
Choice of: count, percentageExample: {rating_form_total type_count="percentage"}
Change { } to [ ]
count Text
text Two default text
Type 'star' (default): %1$s average based on %2$s ratings
Type 'tud': Up: %1$s Down: %3$s based on %2$s ratings
%1$s = average rating or total Up ratings depends on type
%2$s = total ratings
%3$s = total Down Ratings
See description HTML / Text
class Add custom CSS classes Empty Text
custom_id_group Assign group number of corresponding shortcodes (rating_form_total / rating_form_results). This to trigger live rating results of associated rating forms. Also assign it to the rating form it self. 0 Number

Shortcode type 'star' example

You can add content before a rating form.
Also rate below:
4.1/5124 ratings

Rate below
3.6/5108 ratings

3.9 average based on 232 ratings

Shortcode type 'tud' example

Would you recommend Rating Form?
+103-25128 ratings

Be honest. Do you like it?
+75-1691 ratings

Up: 178 Down: 41 based on 232 ratings

rating_form_results

Display rating result for each star.

Attribute Description Default Value
id Get settings of a rating form by ID 1 Number
post_id Gets automatically the post id or add one manually auto Number
comment_id Gets automatically the comment id or add one manually auto Number
custom_id Define a unique ID for multiple rating forms on same post / page
Allowed characters: letters, numbers, dash - or underscore _
Empty Text
term_id Define term ID of categories or taxonomies 0 Number
class Add custom CSS class Empty Text
layout_height Change layout (block) height 15px Text
layout_width Change layout (block) width 100px Text
layout_color Change layout color (grey) #dddddd Text
fill_color Change inner / fill color (yellow) #ffd700 Text
type_stars Choice of types: stars, titles
stars = 5 stars
titles = Good!
stars Text / Choice
type_count Choice of types: count, percentage count Text / Choice
show_count Show / Hide count true Boolean
live Update results after rating or not
To make this happen, select option in settings:
Update rating_form_results after rating
true Boolean
txt_stars Change text 5 stars, 4 stars etc.
%s = Number of stars
%s stars HTML / Text
txt_count Change text count
%s =  count (540) or percentage (78.5%)
%s HTML / Text
custom_id_group Assign group number of corresponding shortcodes (rating_form_total / rating_form_results). This is for triggering live rating results of associated rating forms. Also assign it to the rating form it self. 0 Number

Shortcode Example

5 stars
279
4 stars
58
3 stars
78
2 stars
53
1 stars
46

rating_form_stats

Display list of voted posts of an user by ID or IP (guests).

Attribute Description Default Value
ip Get list of voted posts by IP Visitor IP IP
user_id Get list of voted posts by user ID auto Number
class Add custom CSS class Empty Text
user_logged_in Display list only to logged-in users false Boolean
target Specify where to open link false Text
rating Show / Hide average rating of each post in list false Boolean
sort Sort list by oldest ratings, newest ratings, highest ratings, lowest ratings.
Choose from:
- new (newest ratings)
- low (lowest ratings)
- top_rating (highest ratings)
- down_rating (lowest ratings)
Empty Text

Shortcode Example

List of posts that you have voted on.

rating_form_user_ratings

Display rating list of anonymous user / logged in user ratings.

Attribute Description Default Value
limit Set number of votes 5 Number
time_period Choose from: sec, hour, day, week, month, year Empty Text
time_amount Set amount of time based on time period.
Example:
time_period="day"
time_amount="2"
This will show user votes from the last 2 days.
Empty Number
sort Sort by new or old ratings, highest or lowest ratings (multiple sorting possible)
Choose from: old,new,high,low
false Text
class Add your own CSS classes. Separate them with a space. Empty Text
text Default value:
%username% just gave %rating# ratings#% on <a href="%post_link%">%post_title%</a>Change default text output. Available values: %username% = username
%rating% = user rating. Use # some text# for adding words between rating and text after rating. For example: %rating# votes#% will output 4 votes.
%post_link% = post permalink
%post_title% = post title
Empty Text
anonymous_name Change default username text 'Someone' for anonymous users Someone Text
tu_name Change default text 'Thumbs Up' Thumbs Up Text
td_name Change default text 'Thumbs Down' Thumbs Down Text
type Two type of rating result.
tud = Thumps Up and Down ratings
star = 1-5 ratings
Empty (both types) Text

Shortcode Example

Vote this page:
3.9/5514 ratings