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"]
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 |