=== Starquill for WooCommerce ===
Contributors: rensike
Tags: woocommerce, product reviews, review moderation, review reply, ratings
Requires at least: 6.1
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
WC requires at least: 7.0
Stable tag: 0.1.1
License: GPLv3 or later
License URI: https://www.gnu.org/licenses/gpl-3.0.html

A review moderation dashboard, reusable reply templates and a star-rating summary widget for WooCommerce.

== Description ==

WooCommerce stores product reviews as comments, so moderating them means digging through the general Comments screen. Starquill gives reviews a screen of their own.

**What you get**

* A dedicated review dashboard: filter by status, star rating, product or keyword
* Bulk approve, unapprove, mark as spam or delete
* One-click replies, with reusable templates and `{product_name}`, `{customer_name}` and `{rating}` placeholders
* A front-end star-rating summary widget with a per-star breakdown bar, via the `[starquill_reviews]` shortcode or the "Review Summary" block
* No limits on the number of reviews, templates or widgets

**Free vs Pro**

Everything above is in this free version, unrestricted — no review limit, no template limit, nothing locked behind a trial. Starquill Pro is a separate, optional upgrade that adds AI review summaries, drafted and automatic replies, sentiment analysis and negative-review interception (bring your own OpenAI-compatible API key). You never need Pro to use the free plugin.

**External services**

This plugin uses the Freemius service to offer that optional upgrade, to activate licences and to deliver updates to paying customers. On activation Freemius asks for your permission before sending anything; if you decline, no data leaves your site and the plugin keeps working. When you opt in, it sends your site URL, WordPress and PHP versions and the administrator email so licences and update notices can be delivered. See the Freemius [terms](https://freemius.com/terms/) and [privacy policy](https://freemius.com/privacy/). The free plugin makes no other outbound requests.

== Installation ==

1. Upload the `starquill` folder to `/wp-content/plugins/`, or install the zip via Plugins → Add New.
2. Activate the plugin. WooCommerce must be installed and active.
3. Open the "Starquill" menu to moderate reviews.
4. Add a widget anywhere with the `[starquill_reviews product="123"]` shortcode or the "Review Summary" block.

== Screenshots ==

1. The Starquill reviews screen: filter by status, rating or product, see star ratings, and reply from one place.
2. Reply templates with placeholders, so common answers are one click away.
3. The storefront rating summary — average score plus a star-by-star breakdown.

== Frequently Asked Questions ==

= Where do I manage reviews? =

A top-level "Starquill" menu is added to the admin. It lists product reviews only, so ordinary blog comments stay where they are.

= Do reply templates support placeholders? =

Yes. `{product_name}`, `{customer_name}` and `{rating}` are filled in when you insert a template into a reply.

= Which products can the widget show? =

Any product id (`product="123"`), or `product="auto"` to use the product currently being viewed.

= What are the shortcode options? =

`product` (id or "auto").

== Changelog ==

= 0.1.1 =
* The product filter field now shows its placeholder instead of a literal 0 when no product is selected.

= 0.1.0 =
* Initial release: review moderation dashboard, bulk actions, reply templates with placeholders, and the star-rating summary widget.
