One of the most powerful features of Multi Rating Pro is it’s ability to filter and combine results which share the same rating criteria, uncovering new insights from your rating data. Here are some shortcode examples:
- [mrp_rating_result rating_item_ids="1,2"] – shows an overall average rating of a post using a subset of ratings items in a rating form.
- [mrp_rating_result rating_item_ids="1,2" rating_form_id=""] – if you have multiple rating forms on the same post, you can show the overall average rating using a subset of rating items across all rating forms which have the same rating items.
- [mrp_rating_item_results rating_form_id="" post_id="" rating_item_ids="1,2"] – shows a breakdown of specific rating item results across all posts and rating forms which have the same rating items.
- [mrp_rating_results_list rating_item_ids="1,2"] – shows a list of overall average ratings for posts using a subset of ratings items in a rating form.
- [mrp_rating_entry_details_list post_id="" rating_form_id="" rating_item_ids="1,2"] – shows a list of overall average ratings for rating entries using a subset of rating items across all posts and rating forms which have the same rating items.
See the shortcodes documentation for a comprehensive list of shortcodes available and the attributes you can use.
Some examples with sample data and expected results
Let’s assume we have 3 rating items:
Rating Item Id | Label | Max Option |
---|---|---|
1 | Rating item 1 | 5 |
2 | Rating Item 2 | 3 |
3 | Rating item 3 | 2 |
3 rating forms:
Rating Form Id | Name | Rating Items | ||
---|---|---|---|---|
1 | 2 | 3 | ||
1 | Rating form 1 | Yes | Yes | Yes |
2 | Rating form 2 | Yes | Yes | No |
3 | Rating form 3 | Yes | No | No |
and 4 rating entries:
Rating Entry Id | Post Id | Rating Form Id | Rating Item Values | Overall rating (blue) | ||
---|---|---|---|---|---|---|
1 | 2 | 3 | ||||
1 | 1 | 1 | 5/5 | 3/3 | 2/2 | 10/10 |
2 | 1 | 1 | 2/5 | 2/3 | 2/2 | 6/10 |
3 | 1 | 2 | 2/5 | 2/3 | N/A | 4/8 |
4 | 1 | 3 | 2/5 | N/A | N/A | 2/5 |
Filter by Rating Item Id’s
You can filter ratings by specifying rating item id’s e.g. [mrp_rating_result rating_item_ids="1,2" rating_form_id="1" post_id="1" result_type="score"]. This example would return an average score of 6/8.
Rating Entry Id | Post Id | Rating Form Id | Rating Item Values | Overall rating (blue) | |
---|---|---|---|---|---|
1 | 2 | ||||
1 | 1 | 1 | 5/5 | 3/3 | 8/8 |
2 | 1 | 1 | 2/5 | 2/3 | 4/8 |
Average score = 6/8 |
Filter by all rating forms
You can filter ratings across all rating forms e.g. [mrp_rating_result rating_form_id="" post_id="1"]. This example would return 6.25/10.
Note all rating entry scores are adjusted to be out of the max total option value.
Rating Entry Id | Post Id | Rating Form Id | Rating Item Values | Overall rating (blue) | ||
---|---|---|---|---|---|---|
1 | 2 | 3 | ||||
1 | 1 | 1 | 5/5 | 3/3 | 2/2 | 10/10 |
2 | 1 | 1 | 2/5 | 2/3 | 2/2 | 6/10 |
3 | 1 | 2 | 2/5 | 2/3 | N/A | 4/8 (adjusted to 5/10) |
4 | 1 | 3 | 2/5 | N/A | N/A | 2/5 (adjusted to 4/10) |
Average score = 6.25/10 |
Filter by all rating forms and rating item 2 only
[mrp_rating_result rating_form_id="" post_id="1" rating_item_ids="2"]. This example would return 2.33/3.
Rating Entry Id | Post Id | Rating Form Id | Rating Item Values | Overall rating (blue) | ||
---|---|---|---|---|---|---|
1 | 2 | 3 | ||||
1 | 1 | 1 | 5/5 | 3/3 | 2/2 | 3/3 |
2 | 1 | 1 | 2/5 | 2/3 | 2/2 | 2/3 |
3 | 1 | 2 | 2/5 | 2/3 | N/A | 2/3 |
4 | 1 | 3 | 2/5 | N/A | N/A | N/A |
Average score = 2.33/3 |