QC: {FIELD-REVIEW-CRITERIA-MENU}

The {FIELD-REVIEW-CRITERIA-MENU} QuickCode Tag may be used to create a dropdown menu which customers may use to select ratings for ranking criteria when submitting product reviews.

If a product is assigned to a ranking criteria group, then when a customer reviews the product, the customer may also rate the product in terms of each of the criteria in the ranking criteria group. There are two different options to create an input for rating ranking criteria: {FIELD-REVIEW-CRITERIA-MENU} to create a dropdown menu, or {FIELD-REVIEW-CRITERIA} to create a row of five clickable stars.

Requirements / Prerequisites

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

Since the {FIELD-REVIEW-CRITERIA-MENU} QuickCode Tag creates an HTML input, it must be used within a valid HTML form, which also contains a submit button. The entire form should be placed between {IF-REVIEWER-AUTHORIZED-BEGIN} and {IF-REVIEWER-AUTHORIZED-END}, so that the product review form will only be displayed to authorized customers.

Additionally, {FIELD-REVIEW-CRITERIA-MENU} should be placed between {REVIEW-CRITERIA-BLOCK-BEGIN} and {REVIEW-CRITERIA-BLOCK-END}, so that a dropdown menu will be displayed for each of the product's ranking criteria.

The entire {REVIEW-CRITERIA-BLOCK-BEGIN} {REVIEW-CRITERIA-BLOCK-END} section should be placed between {IF-REVIEW-CRITERIA-BEGIN} and {IF-REVIEW-CRITERIA-END}, so that the ranking criteria options and formatting will only be show for products that are assigned to a ranking criteria group.

Finally, the entire {IF-REVIEWER-AUTHORIZED-BEGIN} and {IF-REVIEWER-AUTHORIZED-END} section that contains the product review form should be placed 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!<br />
{IF-USING-PRODUCT-REVIEWS-BEGIN}
Interested in sharing your opinion of {PRODUCT-NAME}?<br />
{IF-REVIEWER-AUTHORIZED-BEGIN}
<form action="{THIS-PAGE}" method="post" name="sample_review_form">
{IF-REVIEW-CRITERIA-BEGIN}
{REVIEW-CRITERIA-BLOCK-BEGIN}
<span style="outline:red solid 1px;">{FIELD-REVIEW-CRITERIA-MENU}</span> for {REVIEW-CRITERIA-NAME}</span><br />
{REVIEW-CRITERIA-BLOCK-END}
{IF-REVIEW-CRITERIA-END}
<p><i>Write your review here:</i><br />
{FIELD-REVIEW-DETAILS}</p>
<p><input name="submit_review" type="submit" value="Submit Review" class="UNIVERSAL-BUTTON" /></p>
</form>
{ELSE}
Only customers who have purchased {PRODUCT-NAME} may submit a review. If you've purchased {PRODUCT-NAME}, log in to submit a review:<br />
<form action="{THIS-PAGE}" method="post" name="sample_login_form">
<p><span class="SECTION-TITLE">Email Address:</span> <input name="login_email" size="30" type="text" /></p>
<p><span class="SECTION-TITLE">Password:</span> <input name="login_password" size="30" type="password" /></p>
<p><input name="customer_login" type="submit" value="Log in to your Customer Account" /></p>
</form>
{IF-REVIEWER-AUTHORIZED-END}
{ELSE}
Product reviews are not allowed at this time.<br />
{IF-USING-PRODUCT-REVIEWS-END}
Thanks for shopping!<br />

2. If the store's Product Review Module is enabled, -AND- the store's Require Purchase? option is set to NO -OR- the current customer is logged in and has purchased the "Blue T-Shirt" product, -AND- the "Blue T-Shirt" product is assigned to a ranking criteria group which consists of the ranking criteria "True to Size" and "Comfortable", then the "Blue T-Shirt" product page will display the following:

Example
Hello, and welcome to my store!
Interested in sharing your opinion of Blue T-Shirt?

for True to Size
for Comfortable

Write your review here:

Thanks for shopping!

3. If the store's Product Review Module is enabled, -AND- the store's Require Purchase? option is set to NO -OR- the current customer is logged in and has purchased the "Blue T-Shirt" product, -AND- the "Blue T-Shirt" product is not assigned to a ranking criteria group, then the "Blue T-Shirt" product page will display the following:

Example
Hello, and welcome to my store!
Interested in sharing your opinion of Blue T-Shirt?

Write your review here:

Thanks for shopping!

4. If the store's Product Review Module is enabled, and the store's Require Purchase? option is set to YES -AND- the current customer is not logged in or has not purchased the "Blue T-Shirt" product, the "Blue T-Shirt" product page will display the following:

Example
Hello, and welcome to my store!
Interested in sharing your opinion of Blue T-Shirt?

Only customers who have purchased Blue T-Shirt may submit a review. If you've purchased Blue T-Shirt, log in to submit a review:

Email Address:

Password:

Thanks for shopping!

5. If the store's Product Review Module is disabled, the "Blue T-Shirt" product 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 {FIELD-REVIEW-CRITERIA-MENU} QuickCode Tag is changed into the source code below prior to the web page being displayed.