=== RT Advance Order Reporting ===
Contributors: rtao
Tags: woocommerce, reports, orders, analytics, reporting
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 2.1.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Real-time advanced order reporting dashboard for WooCommerce, with a React interface.

== Description ==

RT Advance Order Reporting adds a powerful reporting section under WooCommerce in the WordPress admin. Version 2.0 rebuilds the dashboard interface in React (charts via Recharts) while keeping the same server-side data layer and AJAX endpoints.

**Features**

* Sales Summary – revenue, order count, AOV, items sold + daily revenue/orders chart
* Orders by Status – doughnut chart + breakdown table
* Top Products – ranked by revenue with visual bar meters
* Top Customers – ranked by lifetime value in the selected period
* Refunds & Cancellations – summary KPIs + full order table with direct admin links
* Period filters: Today, Yesterday, This Week, This Month, Last Month, This Year, Custom Range
* Advanced filters: billing email, country & state (billing or shipping scope), payment gateway, shipping method, and tax class — applied across every report tab and the CSV export
* CSV Export for every report tab
* Auto-refreshes every 60 seconds (live badge) + manual refresh
* WordPress Dashboard Widget showing today's totals at a glance

== Installation ==

1. Upload the `rt-advanced-order-reports` folder to `/wp-content/plugins/`
2. Activate via **Plugins > Installed Plugins**
3. Navigate to **WooCommerce > Advanced Reports**

The plugin ships with a pre-built React bundle (`assets/js/dashboard.js`) and
its styles (`assets/css/dashboard.css`), so no build step is required to use it.

== For developers ==

The React source lives in `src/`. To rebuild the bundle after editing it:

    npm install
    npm run build        # builds assets/css/dashboard.css (Sass) + assets/js/dashboard.js (esbuild)
    npm run watch:js     # rebuild JS on change
    npm run watch:css    # rebuild CSS on change

Build tooling: esbuild (JS bundling) + Dart Sass (styles). Styles are authored
in src/dashboard.scss as hand-written, custom CSS — no utility framework — with
every rule scoped under `.rtao-aor-app` so wp-admin styling is never affected.
React, ReactDOM, Recharts and icons are bundled into a single self-contained
file, so the script declares no WordPress JS dependencies.

The data contract is unchanged from 1.x: the React app POSTs to admin-ajax.php
(`action=rtao_aor_data`) and reads `window.rtaoAOR` (ajaxurl, nonce, currency).
CSV export reuses `action=rtao_aor_export`.

== Changelog ==

= 2.1.0 =
* Added an advanced filter panel: billing email, country, state (billing/shipping scope), payment gateway, shipping method and tax class.
* Filters apply to all five report tabs and to CSV export; active filters shown as removable chips.
* New AJAX endpoint (rtao_aor_filter_options) populates dropdowns from live WooCommerce data.

= 2.0.0 =
* Rebuilt the reporting dashboard front end in React.
* Charts migrated from Chart.js to Recharts.
* Added manual refresh control alongside the 60s auto-refresh.
* Custom hand-written SCSS (no utility framework), scoped to the dashboard so it never affects the rest of wp-admin.
* Server-side data layer, AJAX endpoints and CSV export unchanged.

= 1.0.0 =
* Initial release