Rating Documentation

Rating:Insert_Rating_Vote template tag

The Rating:Insert_Rating_Vote tag allows you to enable votes to be submitted on existing reviews for your entries. In other words, when a user writes a rating/review for a channel entry, that review can then be voted up or down. It's a way for your users to indicate which ratings/reviews they find useful and helpful versus unfair or inappropriate. You would normally create vote links in your Rating:Entries loop that in turn would link to a template with this code.

{exp:rating:insert_rating_vote} content {/exp:rating:insert_rating_vote}


The following parameters are available for use:



This parameter is available to prevent users from submitting duplicate votes for reviews.



This parameter allows you disable IP checking on Guest voting submissions. By default, Rating will check for a matching IP address and a cookie. Setting this parameter to no will set Rating to ONLY look for a cookie with a Guest user. While this isn't a complete solution, it solves the issue where multiple users have a shared IP address.



This parameter tells the function which rating to count the vote for.


The following variables are available for use:



This variable will display a success or failure message for the vote.


The following conditionals are available for use:


{if failure}{/if}

This conditional will show its contents if the vote fails for any reason.


{if success}{/if}

This conditional will show its contents if the vote is successful.


The following code example is what your Insert_Rating_Vote template should contain for outputting success or failure messages:

    {if failure}
    {if success}
        <h2>Thank You!</h2>

To link to this template, you’ll need to create “up/down” voting links in your Rating:Entries loop, like this (URI vote options are up/yes and down/no). See Rating:Rating_Vote_Stats documentation for more information.


Having problems setting up and/or using Rating? Support is offered from 10am to 4pm EST weekdays. Send us an email at help@eeharbor.com and we will respond as quickly as we can.