QC: {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END}

The {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END} QuickCode Tag may be used with the {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN} QuickCode Tag to create a block of content that will only be shown if the current visitor has already voted on a particular product review.

Product review votes are tracked by IP address. This means that if a customer votes on a product review anonymously, and then views the same product page while logged in to his or her customer account, the shopping cart will still be able to show the dynamic content between {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN} and {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END}, based on the IP address.

However, if two customers share a computer, and one of the customers votes on a product review, the content between {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN} and {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END} will then be displayed to both customers, since they would both be viewing the product page from the same IP address.

Requirements / Prerequisites

The {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END} QuickCode Tag must be used in combination with the {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN} QuickCode Tag. The {ELSE} QuickCode Tag may optionally be inserted between {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN} and {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END}.

{IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN} and {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END} are compatible with the product template (product.tpl) only.

Content between {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN} and {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END} will be shown if the current visitor's IP address is already associated with a vote for the specific product review, or hidden if the current visitor's IP address is not already associated with a vote for the specific product review.

If {ELSE} is inserted between {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN} and {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END}, then content between {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN} and {ELSE} will be shown if the current visitor's IP address is already associated with a vote for the specific product review, while any alternate content between {ELSE} and {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END} will be shown if the current visitor's IP address is not already associated with a vote for the specific product review.

{IF-CUSTOMER-HAS-VOTED-ON-REVIEW-BEGIN} and {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END} should be placed between {REVIEW-BLOCK-BEGIN} and {REVIEW-BLOCK-END}, which should in turn be used between {IF-REVIEWS-BEGIN} and {IF-REVIEWS-END}.

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 {IF-CUSTOMER-HAS-VOTED-ON-REVIEW-END} QuickCode Tag is changed into the source code below prior to the web page being displayed.