=== Sanestly Coupon Campaign Reports for WooCommerce ===

Contributors: sanestly
Tags: woocommerce, coupons, campaigns, analytics, reports
Requires at least: 6.7
Tested up to: 7.1
Requires PHP: 8.1
Stable tag: 1.0.0
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Group WooCommerce coupons into campaigns and compare orders, revenue, discounts and refunds in one dashboard. HPOS compatible.

== Description ==

Sanestly Coupon Campaign Reports for WooCommerce helps store owners understand which coupon campaigns create sales and which promotions cost more than they return. Group existing WooCommerce coupons into campaigns and view their results in one focused report.

The plugin is designed for teams that run seasonal sales, influencer codes, email offers or other coupon-based promotions. It adds reporting and organization to the coupons you already use. It does not change discounts, checkout or coupon behavior.

**How it works**

1. Create a campaign and assign your existing WooCommerce coupons to it.
2. Choose a reporting period and review orders, gross revenue, discount value, refunds and net revenue.
3. Compare campaigns side by side in wp-admin to see which promotion performed best.

**Features**

* Create, rename and delete coupon campaigns
* Assign existing WooCommerce coupons to a campaign. Each coupon belongs to one campaign, so reports do not double-count orders.
* Review orders, gross revenue, total discount value, refunds and net revenue for every campaign
* Filter reports by preset or custom date range
* Open a campaign to review coupon-level results
* Works with WooCommerce HPOS and legacy order storage
* Uses WooCommerce capabilities for report and campaign access
* Keeps data on uninstall unless you explicitly choose to remove it

== Installation ==

1. Upload the `sanestly-coupon-campaign-reports-for-woocommerce` folder to `/wp-content/plugins/`, or install the ZIP via Plugins -> Add New -> Upload.
2. Activate the plugin. WooCommerce 9.8+ and PHP 8.1+ are required.
3. Open WooCommerce -> Coupon Campaigns to create your first campaign.

== Frequently Asked Questions ==

= Does it work with HPOS? =
Yes. The plugin declares compatibility with custom order tables and reads order data only through the WooCommerce CRUD API.

= Does it change how coupons work? =
No. The plugin provides reporting and campaign grouping only. It never alters coupon behavior, prices or checkout.

= Can one coupon belong to several campaigns? =
Each coupon belongs to one campaign. This keeps campaign totals accurate and prevents an order from being counted twice.

== Screenshots ==

1. Campaign comparison dashboard: orders, gross revenue, discounts, refunds and net revenue per campaign.
2. Campaign list with per-campaign coupon counts and actions.
3. Campaign detail with coupon-level metrics drilldown.
4. Campaign selector metabox on the coupon edit screen.

== Changelog ==

= 1.0.0 =
* Initial release: coupon campaigns via a dedicated taxonomy, order-time campaign snapshots, campaign comparison dashboard with revenue, orders, discounts and refunds, campaign CRUD, coupon metabox, counted-order-status settings and opt-in uninstall cleanup.
