QC: {URL-REVIEW-VOTE-IS-HELPFUL}

The {URL-REVIEW-VOTE-IS-HELPFUL} QuickCode Tag may be used to create a link that visitors may click to submit a positive vote regarding a particular product review.

{IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN}, {ELSE}, and {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END} may be used to prevent visitors from voting on the same review more than once. With this approach, {URL-REVIEW-VOTE-IS-HELPFUL} would be placed between {ELSE} and {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END}, so that the link to submit a vote would only be displayed if the current visitor has not yet voted on the review.

Requirements / Prerequisites

The {URL-REVIEW-VOTE-IS-HELPFUL} QuickCode Tag is compatible with the product template (product.tpl) only.

{URL-REVIEW-VOTE-IS-HELPFUL} is typically used in conjuction with {URL-REVIEW-VOTE-IS-UNHELPFUL}, to create a pair of links that visitors may use to submit a positive vote or a negative vote regarding a particular product review.

{URL-REVIEW-VOTE-IS-HELPFUL} should be placed between {REVIEW-BLOCK-BEGIN} and {REVIEW-BLOCK-END}, so that a link to vote on the review will be displayed for each one of the product's reviews.

{REVIEW-BLOCK-BEGIN} and {REVIEW-BLOCK-END} should be placed between {IF-REVIEWS-BEGIN} and {IF-REVIEWS-END}, so that content and formatting for product reviews will only be displayed if the product has at least one approved review.

Finally, it is recommended to always place any content related to product reviews between the {IF-USING-PRODUCT-REVIEWS-BEGIN} and {IF-USING-PRODUCT-REVIEWS-END} QuickCode Tags, so that the content will be shown when the store's Product Reviews Module is enabled, but hidden if the store's Product Reviews Module is disabled.

Example of Use

1. Add the following to the store's product template (product.tpl):

Example
Hello, and welcome to my store! 
{IF-USING-PRODUCT-REVIEWS-BEGIN}
Interested in learning about other customers' opinions of our products? With product reviews, you can read real feedback from real people, before you buy! 
{IF-REVIEWS-BEGIN}
{NUMBER-OF-REVIEWS} Reviews for {PRODUCT-NAME} 
<hr />
{REVIEW-BLOCK-BEGIN}
"{REVIEW-DETAIL}" 
Did you find this review helpful? 
{IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN}
You have already voted on this review. 
{ELSE}
<a href="{URL-REVIEW-VOTE-IS-HELPFUL}">YES</a> / <a href="{URL-REVIEW-VOTE-IS-UNHELPFUL}">NO</a> 
{IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END}
<hr />
{REVIEW-BLOCK-END}
{ELSE}
{PRODUCT-NAME} has not yet been reviewed. 
{IF-REVIEWS-END}
{ELSE}
Product reviews are not allowed at this time. 
{IF-USING-PRODUCT-REVIEWS-END}
Thanks for shopping!

2. If the store's Product Review Module is enabled, and the "Blue T-Shirt" product has five approved reviews, and the current visitor has already voted on the first review, the "Blue T-Shirt" product page will display the following:

Example
Hello, and welcome to my store!
Interested in learning about other customers' opinions of our products? With product reviews, you can read real feedback from real people, before you buy!
5 Reviews for Blue T-Shirt

"The Blue T-Shirt is great! It's a little bit bigger than expected, but extremely comfortable. It's made of soft, lightweight cotton, and the color is exactly as shown online!"
Did you find this review helpful?
You have already voted on this review.

"This blue t-shirt is my new favorite shirt!"
Did you find this review helpful?
YES / NO

"I bought the Blue T-Shirt as a gift for my brother. He seems to like it."
Did you find this review helpful?
YES / NO

"I was hoping the t-shirt would be a darker shade of blue, but other than that, I like this shirt very much."
Did you find this review helpful?
YES / NO

"This is the most comfortable t-shirt I've ever worn."
Did you find this review helpful?
YES / NO

Thanks for shopping!

3. If the store's Product Review Module is enabled, but the "Blue T-Shirt" product does not have at least one approved review, the "Blue T-Shirt" product page will display the following:

4. If the store's Product Review Module is disabled, the corresponding storefront page will display the following:

Example
Hello, and welcome to my store!
Product reviews are not allowed at this time.
Thanks for shopping!

Source Code

Source Code Updated:

When a web page using a template that contains this QuickCode Tag is viewed in the storefront, the {URL-REVIEW-VOTE-IS-HELPFUL} QuickCode Tag is changed into the source code below prior to the web page being displayed.