Hi Bronwyn, sure I can. Here is a quick overview of what is above. I will create something a bit more detaild to post to the community in a couple of weeks but for now this should suffice. Follow the steps and you should be OK
1) Create a new Custom Field, name it 'rating' and choose Radio Buttons. You need to give each button the following values 0,1,2,3,4,5 and select 0 as default. Create any other fields you may need for your reviews. In my case I had review title and description.
2) Create a Custom Post Type and name it 'reviews'
3) Create a CRED form to display the fields you just created in your Custom Field.
4) Add the code below to your functions.php file. I placed mine in a custom functions file to keep my file clean, but if you do not have one, funtions.php will be fine
//Calculates and displays the Average Rating of a post
add_shortcode('rating-average', 'rating_average_func');
function rating_average_func()
{
$child_posts = types_child_posts('reviews');
$sum = 0;
$num = 0;
foreach ($child_posts as $child_post) {
if(isset($child_post->fields['ratings']))
{
$sum += $child_post->fields['ratings'];
$num ++;
}
}
$average = 0;
if($num>0)
{
$average = $sum/$num;
}
$res = $average;
if($average==0) $res = 0;
if($average>0.001 && $average<0.5)$res = 0.5;
if($average>0.501 && $average<1) $res = 1;
if($average>1.001 && $average<1.5) $res = 1.5;
if($average>1.501 && $average<2) $res = 2;
if($average>2.001 && $average<2.5) $res = 2.5;
if($average>2.501 && $average<3) $res = 3;
if($average>3.001 && $average<3.5) $res = 3.5;
if($average>3.501 && $average==4) $res = 4;
if($average>4.001 && $average<4.5) $res = 4.5;
if($average>4.501 && $average<5) $res = 5;
//... here put more condition ...
return $res;
}
What we have done above is create the short code to display the average rating in increments of 0.5. Your short code will now be
5) Add this code beneath the code above
//Calculates and displays the number of reviews in a post
[reviews_total] shortcode:
add_shortcode('reviews_total', 'reviews_total_func');
function reviews_total_func()
{
$child_posts = types_child_posts('reviews');
return count($child_posts);
}
With the code above, we are counting the number of reviews we have in a post. This is an important function for Schema. The short code created by this is:
6) Next in line, you need to create your stars (or any imagery you want). In total you are going to have to create 11 images for the following options: 0, 0.5, 1, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5 . Give each image a name + the value assigned to it. For example, mine are called stars0.png, stars0.5.png, stars1.png etc. Upload them to your folder. Mine is uploaded to a folder 'ratings which I created in my main images folder: images/ratings.
7) Go to the View which will generate the necessary loop to display your reviews and add the following code:
<!-- wpv-loop-start -->
<wpv-loop>
<div><strong>[wpv-post-title]</strong> | <img src="<em><u>hidden link</u></em> field="ratings"][/types].png" alt="Rated [types field="ratings"][/types] out of 5"/></div>
<div><strong>Review by:</strong> [wpv-post-author] on [wpv-post-date]</div>
<div>[wpv-post-body view_template="None"]
<hr />
</div>
</wpv-loop>
Note what has been done here. We have called [types field="ratings"][/types] and placed it to replace the value of the star within our image, so that star1.png becomes
star[types field="ratings"][/types].png
So now when your view is loaded on the front end, the types shortcode will be replaced by the value selected on the review and will display your star images.
8) Go to your Content Template which your reviewd item will be using, and put this code in it. Place it where you want your star rating to appear.
<div class="rating-box">
<span itemprop="aggregateRating" itemscope itemtype="<em><u>hidden link</u></em>">
<meta itemprop="ratingValue" content="[Rated [rating-average] out of 5]">
<img src="<em><u>hidden link</u></em>" alt="Rated [rating-average] out of 5"/> from <span itemprop="ratingCount">[reviews_total]</span> reviews.
</span></div>
On my view template, I also called the View which displays the actual reviews and the individual star ratings given by each reviewer (step 7).
9) Make sure all the paths and file names are correct for your own site settings. Give one of your items a review with stars and check it out on the front end. It should now display your stars.
A word on Schema:
You need to customize the Schema depending on what your site is. You already have a sample of how it would look like in (8) above and you can leave the values as they are. However, for the snippets to show up in the search engine, you need to add much more into your Content Template (ex: type of Schema you will use, product name etc.) . Many of the tutorials out there are good though for some reason many say Schema is complex. IT IS NOT and its as easy as writing basic HTML.
Hope I did not forget anything above and that it works fine for you. Do not forget to check the values in all the codes to make sure they correspond with your own on your site. 🙂
