Displays a list of rating results. This shortcode also has filters for specific taxonomies (e.g. category) and can optionally show the featured image of a post.

E.g. [mrp_rating_results_list limit="2" show_featured_img="true" taxonomy="category" term_id="1" show_filter="true" filter_label_text="Category" filter_button_text="Filter" sort_by="highest_rated" title="Top Rating Results" show_load_more="true"]

Top Rating Results

1 New website!
 5/5 (1)
2 A Vetting Process for Choosing WordPress Plugins
 5/5 (1)
Attribute Description Values
rating_form_id The rating form id. If not set, default settings are used. If set to blank (i.e. rating_form_id=””), then all rating forms are used. Number
no_rating_results_text Text to display if there are no rating results yet. If not set, default settings are used. Text
show_title Do you want to display the title? Default set to true. true or false
title Title to be displayed i.e. Please rate this. If not set, default settings are used. Text
before_title HTML or text before title. Default is empty. HTML or text
after_title HTML or text after title. Default is empty. HTML or text
result_type The result type to use. Default is set to star_rating. star_rating, percentage or score
show_count Do you want to show the count of entries. Default set to true. true or false
class Add CSS classes to the parent div element (add spaces between each class). Text
category_id Show the rating results for a specific category. Default is set to 0 which means all categories. This overrides the term_id and taxonomy shortcode attributes and is simply an alias for shortcode attribute taxonomy=”category” and setting the term_id. Number
limit Set a limit on how many ratings to show. Default is 10. Number.
show_rank Do you want to show a rank? Default is set to true. true or false
taxonomy Show the rating results for a specific taxonomy. This is also used to default the taxonomy used to filter. Default is “category”. Taxonomy name e.g. category, post_tag etc…
term_id The term id to filter in the taxonomy. Default is 0 which means all (e.g. all categories). Number
show_filter Do you want to display the filter? Default is false. true or false
filter_button_text Text for filter button. If not set, default settings are used. Text
filter_label_text Text for filter label. If not set, default settings are used. Text
show_featured_img Do you want to show the post featured image? Default is true. true or false
image_size Set the image size. Default is thumbnail. You can change the thumbnail size in your Media settings. You can also register custom image sizes. See Add Image Size on WordPress.org codex. thumb, thumbnail, medium, large, post-thumbnail or custom image sizes
sort_by Sort the rating results. You can show the highest rated, lowest rated, recent ratings, most entries and also sort by post title ascending or descending alphabetical order. highest_rated is default. highest_rated, lowest_rated, most_recent, post_title_asc, post_title_desc or most_entries
user_roles Filter rating results by specific WordPress user roles (comma separated) e.g. administrator, editor, subscriber
rating_item_ids Specify the rating items you want to filter the results. If not set, the rating items assigned to the rating form of each rating entry are used. comma separated list of rating item ids e.g. 1, 2, 3
comments_only Do you want to only show ratings which contain comments? Default is null. true or false
from_date Date range from or start date. Date format yyyy-mm-dd. Default null.
to_date Date range to or end date. Date format yyyy-mm-dd. Default null.
rating_entry_ids Use a selected list or rating entries. comma separated list of Rating Entry Id’s e.g. 1,2,3
offset Page number offset. E.g. if limit is 10 and offset=1, then rows 11-20 will be returned. Number. Default is 0.
post_ids Use a selected list of posts. comma separated list of Post Id’s e.g. 1, 2, 3