=== ReviewModo - Review Manager & Analytics for WooCommerce ===
Contributors: DevAura
Tags: woocommerce, reviews, analytics, reports, dashboard
Requires at least: 6.0
Tested up to: 7.0
Requires PHP: 8.0
WC requires at least: 8.0
WC tested up to: 10.9
Stable tag: 1.0.0
License: GPLv2 or later
Donate link: https://www.paypal.com/ncp/payment/ZFNMZNJUQJR7Q


A free WooCommerce plugin that helps store owners analyze product reviews with powerful filtering, searching, and reporting.

== Description ==

ReviewModo - Review Manager & Analytics for WooCommerce is a lightweight, secure, and production-quality admin reporting tool for WooCommerce product reviews. It is designed to work efficiently on shops with thousands of reviews by leveraging optimized SQL queries, caching transients, and lazy loading.

**Features include:**
* **Dashboard Summary:** View total reviews, average rating, star breakdown (1-5★), pending/approved stats, and recent activities.
* **Analytical Graphs:** Powered by a bundled Chart.js package showing monthly reviews frequency, average ratings trend line, star distribution doughnut chart, and top/bottom rated/reviewed products.
* **Custom Moderation Table:** Filter, search, and sort reviews with bulk actions (approve, unapprove, trash, and delete) on a custom-designed WordPress admin layout.
* **Advanced Filters:** Filter reviews by ratings, products, product categories, date range (Start/End), status (Approved/Pending/Spam/Trash), purchase verification, and minimum/maximum review length.
* **Keyword Matching:** Auto-highlight matching terms inside review contents.
* **Keyword Analytics Report:** View aggregated top keywords used by your buyers (excluding standard stop words) with one-click redirection to reviews matching that keyword.
* **Product Catalog Analytics:** Detail listing of review statistics across all product pages.
* **Single Product Insights:** Drill-down into specific products to inspect rating trends, top keywords, longest/shortest reviews, and recent history.
* **Excel-friendly Export:** Download filtered reviews direct into standard or Excel-compatible UTF-8 BOM CSVs.

This plugin is developer-friendly, translation-ready, and follows secure coding practices.

== Installation ==

1. Upload the `reviewmodo` directory to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Access the reports by navigating to the **WooCommerce > ReviewModo** submenu.

== Frequently Asked Questions ==

= Does this plugin work with custom review plugins? =
ReviewModo works with standard WooCommerce product reviews. If your custom review plugin stores reviews as standard WordPress comments with comment_type 'review', they will be parsed and displayed correctly.

= Does this plugin affect store performance? =
No, ReviewModo uses cached transients and optimized SQL queries to compile analytics reports, ensuring zero impact on your front-end store performance.

= How do I export reviews? =
Navigate to WooCommerce > ReviewModo > Moderation, apply your desired filters, and click the "Export to CSV" button.

== Screenshots ==

1. The ReviewModo Admin Dashboard showing summary stats, star distribution, and rating trends.
2. The Review Moderation page with advanced filters, search, and bulk actions.
3. The Products Page listing all catalog products with aggregated review counts and average ratings.
4. The Product Detail Page displaying drill-down insights, rating trends, and top keywords for a specific product.
5. The Export Page allowing store owners to filter and export product reviews to an Excel-friendly CSV.
6. The Settings Page for configuring options like default date range, page size, and graph visibility.

== Developer Documentation ==

ReviewModo - Review Manager & Analytics for WooCommerce exposes hooks and filters allowing other plugins to extend its features:

=== Filters ===

* `reviewmodo_stop_words` (array)
  Allows developers to modify the list of ignored keywords (stop words) filtered out of the keyword analyzer.
  *Example:*
  `add_filter( 'reviewmodo_stop_words', function( $stop_words ) {
      $stop_words[] = 'awesome';
      return $stop_words;
  } );`

* `reviewmodo_reviews_per_page` (int)
  Allows filtering the maximum number of items printed per page in the list tables.
  *Example:*
  `add_filter( 'reviewmodo_reviews_per_page', function( $count ) {
      return 50; // override reviews count to 50
  } );`

=== Actions ===

* Developers can hook standard WordPress actions like comment updates to flush custom dashboard metrics since the query cache is hooked directly into `wp_set_comment_status` and `comment_post`.

== Upgrade Notice ==

= 1.0.0 =
This is the initial release of ReviewModo. Install this version to start managing and analyzing your reviews.

== Changelog ==

= 1.0.0 =
* Initial release. Stable, fully optimized core database queries, custom list tables, settings pages, and Chart.js integrations.
