QC: {REVIEW-CRITERIA-DESCRIPTION}

Store admins may use the Ranking Criteria Editor to create and manage ranking criteria groups. The Ranking Criteria section of the Ranking Criteria Editor includes options to add and edit ranking criteria, and optionally to enter description text for each ranking criteria.

Requirements / Prerequisites

The {REVIEW-CRITERIA-DESCRIPTION} QuickCode Tag is compatible with the product template (product.tpl) only.

{REVIEW-CRITERIA-DESCRIPTION} must be located between {REVIEW-CRITERIA-BLOCK-BEGIN} and {REVIEW-CRITERIA-BLOCK-END}. It is recommended to place {REVIEW-CRITERIA-BLOCK-BEGIN} and {REVIEW-CRITERIA-BLOCK-END} between {IF-REVIEW-CRITERIA-BEGIN} and {IF-REVIEW-CRITERIA-END}, so that the content related to ranking criteria will be shown for products that are assigned to a ranking criteria group, but entirely hidden (including associated formatting such as line breaks or table rows) for products that are not assigned to a ranking criteria group.

{REVIEW-CRITERIA-DESCRIPTION} may be used within the product review form, which should be inserted between {IF-REVIEWER-AUTHORIZED-BEGIN} and {IF-REVIEWER-AUTHORIZED-END}; or may be used 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}
Reviews for {PRODUCT-NAME}....

{REVIEW-BLOCK-BEGIN}
{IF-REVIEW-CRITERIA-BEGIN}
{REVIEW-CRITERIA-BLOCK-BEGIN}
{REVIEW-CRITERIA-RANK} for {REVIEW-CRITERIA-NAME} ({REVIEW-CRITERIA-DESCRIPTION})
{REVIEW-CRITERIA-BLOCK-END}
{IF-REVIEW-CRITERIA-END}
{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 at least one approved review and is assigned to a ranking criteria group which consists of the ranking criteria "True to Size" and "Comfortable", 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!
Reviews for Blue T-Shirt....

4 for True to Size (Does this item fit correctly?)
5 for Comfortable (How comfortable is this item?)
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!

Thanks for shopping!

3. If the store's Product Review Module is enabled, and the "Blue T-Shirt" product has at least one approved review and is not assigned to any ranking criteria group, the "Blue T-Shirt" product page will display the following:

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!

Thanks for shopping!

4. 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:

5. 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-CRITERIA-DESCRIPTION} QuickCode Tag is changed into the source code below prior to the web page being displayed.