QC: {REVIEW-BLOCK-BEGIN}

The {REVIEW-BLOCK-BEGIN} QuickCode Tag may be used with the {REVIEW-BLOCK-END} QuickCode Tag to create a block of content that is displayed once for each of a particular product's approved product reviews.

If the store's Product Reviews Module is enabled, customers may submit product reviews from the product page, and store admins may also create product reviews from the Product Review Editor. Once a product review has been created, it must be approved before it will be displayed in the storefront. Store admins may approve product reviews from the Search Product Reviews page or from the Product Review Editor. Additionally, the Product Reviews Module Settings include an option to auto-approve reviews submitted by customers who have already submitted a certain number of approved reviews.

Requirements / Prerequisites

The {REVIEW-BLOCK-BEGIN} QuickCode Tag must be used in combination with the {REVIEW-BLOCK-END} QuickCode Tag.

{REVIEW-BLOCK-BEGIN} and {REVIEW-BLOCK-END} are compatible with the product template (product.tpl) only.

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

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}....
{REVIEW-BLOCK-BEGIN}
"{REVIEW-DETAIL}"
{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, 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!"
"This blue t-shirt is my new favorite shirt!"
"I bought the Blue T-Shirt as a gift for my brother. He seems to like it."
"I was hoping the t-shirt would be a darker shade of blue, but other than that, I like this shirt very much."
"This is the most comfortable t-shirt I've ever worn."
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 {REVIEW-BLOCK-BEGIN} QuickCode Tag is changed into the source code below prior to the web page being displayed.