Settings

You can start configuring the global settings for reviews posted in your store from the section General options in the plugin Settings. The options are divided into the following sets of settings:

• Review options
• reCAPTCHA options
• Reviews attachment gallery
• Reviews pagination
• Mandrill integration

Review options

• Auto-approve reviews: enable this option if you want the reviews to be automatically approved. By leaving it disabled, the review status will be Pending and the users will view a message after publishing the review.

As an admin, you can approve the reviews from the plugin panel section All reviews > Pending through the Bulk actions or by changing the status in the review edit page.

• Allow anonymous reviews: enable this option to let guest users publish their reviews. When enabled, please make sure the option Reviews can only be left by “verified owners” in WooCommerce > Settings > Products is left unchecked.

• Show user’s country: enable if you want to show the user’s country based on their IP address geolicalization;

• Show “Verified buyer” label on customer reviews: enable to show the verified buyer badge. This option is linked to the option available in WooCommerce > Settings > Products;

• Reviews can only be left by “Verified buyers”: enable to let only logged in customers who purchased the product leave a review. This option is linked to the option available in WooCommerce > Settings > Products;
• In review show: choose how to show the username of the review authors from:
  • Full username
  • Only first and last letter ( A****E )
  • Initials of first and last name only ( J*** D*** )
  • First name and the initial of the last name ( John D. )
  • Username ( John45 )

• Show tooltip with graph bars: enable this option to show graph bars in a tooltip when hovering over the product name;

• Notice to show in products without reviews: enter the text to show on the frontend on products with no reviews.

reCAPTCHA options

The reCaptcha system refers to Google’s “No CAPTCHA reCAPTCHA”. To work correctly, it requires both the reCaptcha site key and the reCaptcha secret key. Let’s learn how to configure the reCaptcha correctly.

Register an account on Google (if you don’t have any yet), go to https://www.google.com/recaptcha/about/ and click on v3 Admin Console.

Now select the reCAPTCHA version you want to use, fill in the available fields and click on the submit button to add the reCAPTCHA to your site.

The site key and secret key are now created.

Go to the plugin General options > reCAPTCHA options and copy and paste the site and secret keys into the related fields.

Reviews attachment gallery

These are the options through which you can manage the gallery of review attachments.

• Display a gallery to highlight all review attachments: enable this option to show the gallery of all review attachments. The gallery will show at the top of the list of reviews;

• Hide attachments of review replies from the gallery: enable this option to prevent reply attachments from being shown in the gallery.

Reviews pagination

Here, you can choose whether to show pagination or not.

• Show pagination of reviews: enable this option to show the reviews with pagination;
  • Reviews pagination: define the number of reviews to show per page.

Note: by disabling this option, please consider that, in the case of a large number of reviews, the product page may take longer to load.

Mandrill integration

To benefit from the integration with Mandrill and send emails through this service, you need to have or create a Mailchimp account first. You can then enter your Mandrill API Key after enabling the option Mandrill integration.

This is the section where you can manage global permissions for users publishing their reviews. To configure the options, go to Settings > User permissions.

General permissions

Below are the options for the actions that your users will be able to perform when enabled.

• User can: select one or more of the following options:
  • Publish multiple reviews for the same product
  • Write a title for their reviews
  • Edit their reviews
  • Delete their reviews
  • Reply to reviews
  • Vote reviews as helpful
  • Report reviews as inappropriate
• Highlight a review as helpful after: define the number of votes needed to add the review to the Most helpful reviews tab automatically;

Note: the tab Most helpful reviews shows only if the related option in the Review box settings is selected.

• Users that can report reviews: choose if all users or only logged ones can report reviews as inappropriate;

• Hide a review automatically after: define the number of reportings needed to hide the review automatically.

Image attachments

To allow users to attach video files to their reviews, enable the option Allow image uploads.

You can then configure the following options:

• Max. number of images: define the maximum number of images per review that users can upload;
• Supported file formats: select the supported formats by choosing from jpg, jpeg, gif, png, and webp;
• Upload size limit (MB): enter the maximum size allowed for the upload (in MB).

Video Attachments

To allow users to attach image files to their reviews, enable the option Allow video uploads.

You can then configure the following options:

• Max. number of videos: define the maximum number of videos per review that users can upload;
• Supported file formats: select the supported formats by choosing from flv, m4v, mp4, ogv, webm, and wmv;
• Upload size limit (MB): enter the maximum size allowed for the upload (in MB).

This is the section where you can customize the layout of the reviews box in terms of options, colors, and badges. To configure the options, go to Settings > Style and customization.

Layout options

• Show % value on graph bars: enable this option to show the percentage value of the ratings in graph bars;

Note: the graph bars show only if the related option in the Review box settings is selected.

• Show filtered reviews on modal window: enable this option to show reviews in a modal window when users filter them by rating;

• Avatar and name position: choose where to show the user’s avatar and name in the review box by choosing from:
  • Above review
  • Below review

• Avatar style: choose the style to apply to the avatar from
  • Image to show the user’s image
  • Initials to show the user’s initials

Colors

Use the following options to customize the plugin colors:

• General colors
• Average rating & Graph boxes
• Graph
• Stars
• Avatar (available only if Initials option has been selected as avatar style)
• Like section
• Review box
• Submit button
• Load more button colors

Bagdes

The plugin provides two badges, one to show on the admin’s replies and one to highlight the featured reviews.

• Show staff badge on admin replies: enable this option to show a badge on the replies posted by the admin. You can additionally enter the label to show for the badge (default is Staff) and choose the background and text colors;

• Featured review badge: enter the label to show for this badge (default is Featured) and choose the background, text, review border, and shadow colors.

In the Emails section of the plugin settings panel, you can find and manage all the emails sent by the plugin.

The available emails are:

• New review
• New reply
• Reported review
• Review reminder (only if the Review reminder module is enabled)
• Reward for a single review (only if the Review for discounts module is enabled)
• Reward for multiple reviews (only if the Review for discounts module is enabled)
• Target to achieve (only if the Review for discounts module is enabled)

Let’s see them one by one.

New review

This email is sent to the admin whenever a user posts a new review.

LAYOUT

• Email style: choose the style for this email. Available styles are Woocommerce template, Style #1, Style #2, and Style #3.
• Header colors: (not available for WooCommerce template) choose the colors for the background and text of the email header;
• Body colors: (not available for WooCommerce template) choose the colors for the background, text, link, link hover of the email body;
• Upload logo: drag or upload the logo to show in the email;
• Logo position: choose the position of the logo from Left, Center, or Right.

CONTENT

• Email heading: enter the text to show as the email heading;
• Message: use the built-in editor to create the text of the email message. Available placeholders are:
  • {site_title}: the title of the site;
  • {site_address}: the address of the site;
  • {site_url}: the URL of the site;
  • {customer_name}: the name of the customer;
  • {customer_last_name}: the last name of the customer;
  • {customer_email}: the email address of the customer;
  • {admin_name}: the name of the site admin;
  • {user_info}: the info of the user;
  • {review}: the review posted on the product;
  • {reply_link}: the link to post the reply on the product page;
  • {edit_link}: the link to edit the review from the admin panel.

CONFIGURATION

• Subject: enter the text for email subject;
• Email type: select the email type: HTML or Multipart;
• Send test email: enter the email address to send a test email then click on Send.

PREVIEW

When configuring the email, you can check a real-time preview on the right side of the screen.

New reply

This email is sent to customers whenever someone posts a new reply to their review.

LAYOUT

• Email style: choose the style for this email. Available styles are Woocommerce template, Style #1, Style #2, and Style #3.
• Header colors: (not available for WooCommerce template) choose the colors for the background and text of the email header;
• Body colors: (not available for WooCommerce template) choose the colors for the background, text, link, link hover of the email body;
• Upload logo: (not available for WooCommerce template) drag or upload the logo to show in the email;
• Logo position: (not available for WooCommerce template) choose the position of the logo from Left, Center, or Right.

CONTENT

• Email heading: enter the text to show as the email heading;
• Message: use the built-in editor to create the text of the email message. Available placeholders are:
  • {site_title}: the title of the site;
  • {site_address}: the address of the site;
  • {site_url}: the URL of the site;
  • {customer_name}: the name of the customer;
  • {customer_last_name}: the last name of the customer;
  • {customer_email}: the email address of the customer;
  • {user_info}: the info of the user;
  • {reviewed_product}: the reviewed product in which the reply was posted;
  • {reply}: the reply posted on the product;
  • {reply_link}: the link to read the review on the product page.

CONFIGURATION

• Subject: enter the text for email subject;
• Email type: select the email type: HTML or Multipart;
• Send test email: enter the email address to send a test email then click on Send.

PREVIEW

When configuring the email, you can check a real-time preview on the right side of the screen.

Reported review

This email is sent to the admin when a customer reports a review.

LAYOUT

• Email style: choose the style for this email. Available styles are Woocommerce template, Style #1, Style #2, and Style #3;
• Header colors: (not available for WooCommerce template) choose the colors for the background and text of the email header;
• Body colors: (not available for WooCommerce template) choose the colors for the background, text, link, and link hover of the email body;
• Upload logo: (not available for WooCommerce template) drag or upload the logo to show in the email;
• Logo position: (not available for WooCommerce template) choose the position of the logo from Left, Center, or Right.

CONTENT

• Email heading: enter the text to show as the email heading;
• Message: use the built-in editor to create the text of the email message. Available placeholders are:
  • {site_title}: the title of the site;
  • {site_address}: the address of the site;
  • {site_url}: the URL of the site;
  • {customer_name}: the name of the customer;
  • {customer_last_name}: the last name of the customer;
  • {customer_email}: the email address of the customer;
  • {admin_name}: the name of the site admin;
  • {review}: the review posted on the product;
  • {edit_link}: the link to edit the review from the admin panel.

CONFIGURATION

• Subject: enter the text for email subject;
• Email type: select the email type: HTML or Multipart;
• Send test email: enter the email address to send a test email then click on Send.

PREVIEW

When configuring the email, you can check a real-time preview on the right side of the screen.

Review reminder

This email is sent to customers xx* days after the order is set to Completed to invite them to leave a review for the purchased products. It is available only if the Review reminder module has been enabled.

* The email will be sent based on the number of days set in the module’s general options (see here).

LAYOUT

• Email style: choose the style for this email. Available styles are Woocommerce template, Style #1, Style #2, and Style #3;
• Header colors: (not available for WooCommerce template) choose the colors for the background and text of the email header;
• Body colors: (not available for WooCommerce template) choose the colors for the background, text, link, link hover of the email body;
• Upload logo: (not available for WooCommerce template) drag or upload the logo to show in the email;
• Logo position: (not available for WooCommerce template) choose the position of the logo from Left, Center, or Right;
• Button colors: choose the colors for the background, text, background hover, and text hover of the button;
• Button label: enter the text for the button to post the review.

CONTENT

• Email heading: enter the text to show as the email heading;
• Message: use the built-in editor to create the text of the email message. Available placeholders are:
  • {site_title}: the title of the site;
  • {site_address}: the address of the site;
  • {site_url}: the URL of the site;
  • {customer_name}: the name of the customer;
  • {customer_last_name}: the last name of the customer;
  • {customer_email}: the email address of the customer;
  • {completed_date}: the date of the completed order;
  • {items}: the products to be reviewed;
  • {days_ago}: the number of days passed from the order completion;
• Unsubscribe text: enter the text for the Unsubscribe link.

CONFIGURATION

• Subject: enter the text for email subject;
• Email type: select the email type: HTML or Multipart;
• Send test email: enter the email address to send a test email then click on Send.

PREVIEW

When configuring the email, you can check a real-time preview on the right side of the screen.

Reward for a single review

This email includes the coupon that is sent to customers who post a single review. It is available only if the Review for discounts module has been enabled.

LAYOUT

• Email style: choose the style for this email. Available styles are Woocommerce template, Style #1, Style #2, and Style #3.
• Header colors: (not available for WooCommerce template) choose the colors for the background and text of the email header;
• Body colors: (not available for WooCommerce template) choose the colors for the background, text, link, link hover of the email body;
• Upload logo: (not available for WooCommerce template) drag or upload the logo to show in the email;
• Logo position: (not available for WooCommerce template) choose the position of the logo from Left, Center, or Right.

CONTENT

• Email heading: enter the text to show as the email heading;
• Message: use the built-in editor to create the text of the email message. Available placeholders are:
  • {site_title}: the title of the site;
  • {site_address}: the address of the site;
  • {site_url}: the URL of the site;
  • {customer_name}: the name of the customer;
  • {customer_last_name}: the last name of the customer;
  • {customer_email}: the email address of the customer;
  • {product_name}: the name of the reviewed product;
  • {coupon_description}: general info about the coupon (code, validity, amount or percentage, etc.)

CONFIGURATION

• Subject: enter the text for email subject;
• Email type: select the email type: HTML or Multipart;
• Send test email: enter the email address to send a test email then click on Send.

PREVIEW

When configuring the email, you can check a real-time preview on the right side of the screen.

Reward for multiple reviews

This email includes the coupon that is sent to customers who reached the threshold for multiple reviews. It is available only if the Review for discounts module has been enabled.

LAYOUT

• Email style: choose the style for this email. Available styles are Woocommerce template, Style #1, Style #2, and Style #3.
• Header colors: (not available for WooCommerce template) choose the colors for the background and text of the email header;
• Body colors: (not available for WooCommerce template) choose the colors for the background, text, link, link hover of the email body;
• Upload logo: (not available for WooCommerce template) drag or upload the logo to show in the email;
• Logo position: (not available for WooCommerce template) choose the position of the logo from Left, Center, or Right.

CONTENT

• Email heading: enter the text to show as the email heading;
• Message: use the built-in editor to create the text of the email message. Available placeholders are:
  • {site_title}: the title of the site;
  • {site_address}: the address of the site;
  • {site_url}: the URL of the site;
  • {customer_name}: the name of the customer;
  • {customer_last_name}: the last name of the customer;
  • {customer_email}: the email address of the customer;
  • {total_reviews}: the total number of reviews posted by the customer;
  • {coupon_description}: general info about the coupon (code, validity, amount or percentage, etc.).

CONFIGURATION

• Subject: enter the text for email subject;
• Email type: select the email type: HTML or Multipart;
• Send test email: enter the email address to send a test email then click on Send.

PREVIEW

When configuring the email, you can check a real-time preview on the right side of the screen.

Target to achieve

This email is sent to customers when they’re about to reach the “Multiple review” threshold. It is available only if the Review for discounts module has been enabled.

LAYOUT

• Email style: choose the style for this email. Available styles are Woocommerce template, Style #1, Style #2, and Style #3.
• Header colors: (not available for WooCommerce template) choose the colors for the background and text of the email header;
• Body colors: (not available for WooCommerce template) choose the colors for the background, text, link, link hover of the email body;
• Upload logo: (not available for WooCommerce template) drag or upload the logo to show in the email;
• Logo position: (not available for WooCommerce template) choose the position of the logo from Left, Center, or Right.

CONTENT

• Email heading: enter the text to show as the email heading;
• Message: use the built-in editor to create the text of the email message. Available placeholders are:
  • {site_title}: the title of the site;
  • {site_address}: the address of the site;
  • {site_url}: the URL of the site;
  • {customer_name}: the name of the customer;
  • {customer_last_name}: the last name of the customer;
  • {customer_email}: the email address of the customer;
  • {remaining_reviews}: the number of reviews left to achieve the threshold.

CONFIGURATION

• Subject: enter the text for email subject;
• Email type: select the email type: HTML or Multipart;
• Send test email: enter the email address to send a test email then click on Send.

PREVIEW

When configuring the email, you can check a real-time preview on the right side of the screen.

The plugin includes shortcodes, widgets, and blocks that you can use on any page of your site.

1. Show all reviews (shortcode,widget and block)

Classic editor – To print all the reviews posted on your products, use the following shortcode.

[yith_ywar_show_reviews]

Block – To print all the reviews posted on your products, add the block Reviews to the page or widget.

Now leave the Product ID empty and enable/disable the following options as you need:

• Reviews per page: select the number of reviews to show per page;
• Enable pagination: enable to show the pagination;
• Hide action buttons (Edit, Reply, Helpful, Report): enable if you don’t want to show the buttons in the review;
• Hide attachments: enable if you don’t want to show review attachments;
• Hide replies: enable if you don’t want to show the review replies.

2. Show reviews of a certain product (shortcode, widget and block)

Classic editor – To print all the reviews posted on a specific product, use the following shortcode by adding the product ID.

[yith_ywar_show_reviews product_id = 123]

Block – To print all the reviews posted on a specific product, add the block Reviews to the page or widget.

Now enable/disable the following options as you need:

• Product ID: enter the ID of the product;
• Enable pagination: enable to show the pagination;
• Hide action buttons (Edit, Reply, Helpful, Report): enable if you don’t want to show the buttons in the review;
• Hide attachments: enable if you don’t want to show review attachments;
• Hide replies: enable if you don’t want to show the review replies.

3. Show limited number of reviews (only shortcode)

To show a specific number of reviews, use the following shortcode by adding the related value. (Ex. To show two reviews, enter 2 as the parameter).

[yith_ywar_show_reviews reviews_number= 2]

4. Shortcode to display a full reviews section (shortcode, widget and block)

Classic editor – To show the reviews section on the product page, use the following shortcode.

[yith_ywar_show_reviews_form]

If you want to show the reviews section from a specific product outside the product page, for example in a custom landing page, you have to use the next shortcode, including the product ID as a parameter:

[yith_ywar_show_reviews_form product_id="1234"]

Block – To show the reviews section on any page, add the Reviews with form block to the page or widget.

To show the review section for a specific product only, enter the product ID in the related field.

5. Shortcode to show the current user reviews (shortcode,widget and block)

Classic editor – To show a table with the reviews posted by the current user, use the following shortcode:

[yith_ywar_show_current_user_reviews]

Please note: reviews can only be written for products.

Block – To show a table with the reviews posted by the current user, add the Current user reviews block to the page or widget.