This QuickCode Tag is used to display the average criteria rating of all of the reviews for a specific product.

In order to enable review criteria, a store admin must first create one or more criteria group, and apply the criteria to one or more products. The options to add a criteria group are located in the store's admin area at [Modules > Product Reviews > Add a Ranking Criteria Group].

Once a criteria group has been created and applied to a product, reviewers will be able to assign rating between 1 and 5 for each criteria, as part of the product review. The {REVIEW-COMPOSITE-RANK} QuickCode Tag will display the average of all of the ratings from all reviews for a specific product.

The {REVIEW-COMPOSITE-RANK} QuickCode Tag is compatible with the product detail page template, including product.template.php, upsell.template.php, and downsell.template.php.

The {REVIEW-COMPOSITE-RANK} QuickCode Tag should ideally be used after the {IF-USING-PRODUCT-REVIEWS-BEGIN} and {IF-REVIEWS-BEGIN} QuickCode Tags, and before the {REVIEW-BLOCK-BEGIN} QuickCode Tag. That way, the overall average rating will only be display if the Product Reviews module is enabled, and if the product has at least one review, and will only be displayed once for the entire review block, instead of being repeated for each review within the block.

The {REVIEW-COMPOSITE-RANK} QuickCode Tag might also optionally be enclosed between the {IF-REVIEW-CRITERIA-BEGIN} and {IF-REVIEW-CRITERIA-END} QuickCode Tags.

If product.template.php contains the following:

{IF-USING-PRODUCT-REVIEWS-BEGIN}
    {IF-REVIEWS-BEGIN}
        {NUMBER-OF-REVIEWS} Reviews of {PRODUCT-NAME} {IF-REVIEW-CRITERIA-BEGIN}(Average rating: {REVIEW-COMPOSITE-RANK}){IF-REVIEW-CRITERIA-END}
                {REVIEW-BLOCK-BEGIN}

And the product Sandwich has five reviews, with average ratings of 3, 4, 3, 3, and 5, for a total composite rating of 3.6, the Sandwich product detail page would display the following:

5 Reviews of Sandwich (Average rating: 3.6)