=== Raintech Sales Reports & Analytics for WooCommerce === Contributors: raintech357 Tags: woocommerce reports, woocommerce analytics, sales reports, order reports, csv export Requires at least: 6.0 Tested up to: 6.9 Requires PHP: 7.4 Stable tag: 2.1.5 License: GPLv2 or later License URI: https://www.gnu.org/licenses/gpl-2.0.html Real-time WooCommerce order reports and sales analytics dashboard — revenue trends, top products, top customers, refunds, advanced filters, and one-click CSV export. == Description == **RT Advanced Order Reports** turns the default WooCommerce order data into a real-time, filterable analytics dashboard — right inside your WordPress admin, under **WooCommerce > Advanced Reports**. Track revenue, orders, top-selling products, and your best customers without installing a separate analytics service or exporting spreadsheets by hand. The entire dashboard is built with a modern React interface and interactive Recharts charts, so every report loads fast and updates live — no page reloads required. = Why Store Owners Use This Plugin = * See exactly how your store is performing today, this week, this month, or over any custom date range. * Spot your best-selling products and highest-value customers at a glance. * Track refunds and cancellations in one place, with direct links back to the order. * Slice every report by billing email, country, state, payment gateway, shipping method, or tax class. * Export any report to CSV for accounting, spreadsheets, or further analysis. * Keep an eye on today's sales without leaving the WordPress Dashboard, via the built-in dashboard widget. **Key Features** * **Sales Summary** – revenue, order count, average order value, and items sold, plus a daily revenue/orders trend chart * **Orders by Status** – doughnut chart and breakdown table so you can see pending, processing, and completed orders at a glance * **Top Products** – best-selling products ranked by revenue with visual bar meters * **Top Customers** – your highest lifetime-value customers for the selected period * **Refunds & Cancellations** – summary KPIs plus a full order table with direct links back to each order * **Flexible date filters** – Today, Yesterday, This Week, This Month, Last Month, This Year, or a Custom Range * **Advanced filters** – billing email, country and state (billing or shipping), payment gateway, shipping method, and tax class, applied across every report tab and the CSV export * **CSV Export** on every report tab for accounting or further analysis * **Live auto-refresh** every 60 seconds, plus a manual refresh button * **WordPress Dashboard Widget** showing today's sales totals at a glance, without opening the full report == Installation == 1. Upload the `rt-advanced-order-reports` folder to `/wp-content/plugins/` 2. Activate via **Plugins > Installed Plugins** 3. Make sure WooCommerce is installed and active 4. Navigate to **WooCommerce > Advanced Reports** to view your dashboard == Frequently Asked Questions == = Does this plugin require WooCommerce? = Yes. RT Advanced Order Reports requires WooCommerce to be installed and active — it reads directly from your WooCommerce order data. = Does this replace WooCommerce Analytics? = It complements it. This plugin focuses on fast, filterable, real-time reporting with CSV export and a dashboard widget, giving you quicker access to the numbers you check daily. = Can I filter reports by customer location or payment method? = Yes. Use the advanced filter panel to narrow any report by billing email, country, state, payment gateway, shipping method, or tax class. = Can I export report data? = Yes. Every report tab — Sales Summary, Orders by Status, Top Products, Top Customers, and Refunds & Cancellations — has a one-click CSV export. = Will this slow down my WooCommerce store? = No. Reports are generated on demand through admin-ajax.php and only run in the WordPress admin area, so your storefront performance is unaffected. = Does the dashboard update automatically? = Yes. The dashboard auto-refreshes every 60 seconds and shows a live badge, with a manual refresh button available at any time. 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.5 = * Maintenance release: compatibility updates and stability improvements. = 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 == Upgrade Notice == = 2.1.5 = Maintenance release with compatibility and stability improvements. Safe to update from any 2.x version.