Reviews

DigiCommerce includes a powerful review management system that allows customers to leave feedback on your products. This guide will walk you through the process of configuring, managing, and customizing the product reviews functionality.

Enabling Product Reviews

To enable reviews for your products:

1. Navigate to the DigiCommerce settings from your WordPress dashboard.
2. Go to the Reviews tab in the settings panel.
3. Check the Enable product reviews option.
4. Configure additional settings as needed:
   • Require login to post reviews: If checked, users must be logged in to submit a review.
   • Automatically approve reviews: When enabled, new reviews will appear immediately without requiring approval. By default, reviews are set to “pending” until approved.
   • Send notification email: Enable this to receive an email notification when a new review is submitted.
5. Click “Save Changes” to apply your settings.

Managing Reviews

Once reviews are enabled, you can manage them from the dedicated reviews management page:

1. Go to DigiCommerce > Reviews in your WordPress admin menu.
2. Here you’ll see a list of all reviews with the following information:
   • Author name and email
   • Product the review is associated with
   • Rating (out of 5 stars)
   • Review content
   • Status (pending, approved, or trash)
   • Date submitted

Review Management Actions

From the reviews list, you can perform several actions:

Bulk Actions

1. Select multiple reviews using the checkboxes.
2. Choose an action from the Bulk Actions dropdown:
   • Approve: Change the status of selected reviews to “approved”.
   • Move to Trash: Send the selected reviews to the trash.
   • Delete Permanently: When viewing trash, this option permanently removes reviews.
   • Restore: When viewing trash, this returns reviews to pending status.
3. Click “Apply” to execute the selected action.

Individual Actions

For each review, you can:

• Edit: Modify any review details including the author information, product association, rating, content, and status.
• Approve/Unapprove: Toggle the review between “approved” and “pending” status.
• Trash: Move the review to trash.
• Restore: When viewing trash, return the review to pending status.
• Delete Permanently: When viewing trash, completely remove the review.

Editing Reviews

To edit a review:

1. Click on the review text or the “Edit” link in the reviews list.
2. On the edit screen, you can modify:
   • Author name and email
   • Product association (dropdown of available products)
   • Rating (1-5 stars)
   • Review content
   • Status (pending, approved, or trash)
3. Click “Update Review” to save your changes.

Filtering and Searching Reviews

The reviews management page includes several tools to help you find specific reviews:

1. Status Filters: Click on “All”, “Pending”, “Approved”, or “Trash” to view reviews with that status.
2. Search: Use the search box to find reviews containing specific text in the author name or review content.
3. Sorting: Click on column headers to sort reviews by that field.

Frontend Review Display

When reviews are enabled, they will appear on product pages in two locations:

1. Product Rating: A star rating summary displays near the product title, showing the average rating and the number of reviews.
2. Reviews Section: At the bottom of the product page, customers will see:
   • Average rating with stars
   • Total number of reviews
   • List of approved reviews
   • Review submission form (if allowed)

Review Submission Form

The review submission form will appear to customers at the bottom of product pages. The form includes:

• Name and email fields (for non-logged-in users, if allowed)
• Star rating selection
• Text area for the review content
• Submit button

If you’ve enabled the “require login” option, non-logged-in users will see a message directing them to log in before leaving a review.

Review Verification

DigiCommerce includes security features to protect your review system:

• reCAPTCHA verification for non-logged-in users (if configured)
• Rate limiting to prevent spam submissions
• Data sanitization to prevent malicious content

Customizing the Review Display

You can customize the appearance of reviews by modifying the template files in your theme. The main template files are:

• reviews/product-rating.php: Controls the display of the rating summary
• reviews/reviews-section.php: Controls the overall reviews section
• reviews/review-form.php: Controls the review submission form

If you’re using a custom theme, you can override these templates by creating corresponding files in your theme directory.

Email Notifications

When a new review is submitted and email notifications are enabled, an email will be sent to the site administrator. The email includes:

• Product title
• Review author information
• Rating and review content
• Link to approve or manage the review

You can customize the email template by modifying the emails/admin-new-review.php template file.

Troubleshooting Reviews

If you’re experiencing issues with the review system:

1. Reviews not displaying: Ensure reviews are enabled in the settings and that the reviews have been approved.
2. Users can’t submit reviews: Check if “require login” is enabled and users are properly logged in.
3. Review form not appearing: Verify that you’re viewing a single product page and that reviews are enabled.
4. Email notifications not working: Check your WordPress email configuration and ensure the notification setting is enabled.

For additional support with the DigiCommerce review system, please refer to our comprehensive documentation or contact our support team.