=== MarginMinds – Analytics for WooCommerce ===
Contributors: qubenza
Tags: woocommerce analytics, woocommerce reports, profit tracking, roas, ad spend
Requires at least: 6.4
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.0.0
Requires Plugins: woocommerce
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce profit dashboard — revenue, estimated profit, ad spend ROAS, and store insights. Free forever.

== Description ==

Most WooCommerce store owners know their revenue. Almost none know their real profit.

MarginMinds Analytics fixes that. It gives you a clean, fast analytics dashboard inside WP Admin that shows not just what you earned — but what you actually kept after costs and ad spend.

No third-party accounts. No monthly SaaS fees. Just clear numbers, inside WordPress, where they belong.

== Source Code ==
The full source code is available at: https://github.com/Qubenza/marginminds-analytics

**Free Features:**

* Total revenue, orders count, and average order value
* New customers count for today, this week, and this month
* Revenue line chart — last 30 days
* Orders bar chart — last 30 days
* Order status donut chart
* Top 5 products by revenue and by quantity
* Recent 10 orders list
* Estimated profit using a simple margin percentage
* Best selling day and peak hour insight
* Low stock alert widget
* Manual weekly ad spend entry with basic ROAS calculation
* Date filter: today, this week, this month
* Community support

**Pro — $49/year:**

Everything in Free, plus:

* WP Admin dashboard widget
* Customer lifetime value (CLV)
* Refund rate and net profit tracking
* Repeat vs new customer ratio
* Month over month comparison
* Custom date range picker
* Revenue by product category
* Revenue vs orders composed chart
* Customer growth chart
* Top 10 customers by spend
* Abandoned cart count and lost value
* Cart recovery rate tracking
* Google Ads OAuth connect
* Google Ads daily spend auto-sync
* Google ROAS chart and cost per order
* True profit after Google Ads spend
* CSV export for all reports
* Weekly email report to admin
* Priority email support

**Pro Plus — $99/year:**

Everything in Pro, plus:

* 3 site licenses
* Geolocation revenue by country
* Meta Ads sync — Facebook and Instagram
* TikTok Ads sync
* Pinterest Ads sync
* Side by side ROAS comparison across all platforms
* Best performing channel — auto detected weekly
* True net profit — revenue minus refunds minus all ad spend
* Cost per order per platform
* Monthly email report auto-sent
* Priority support and early access to new features

== Installation ==

1. Upload the `marginminds-analytics` folder to the `/wp-content/plugins/` directory, or install directly through the WordPress Plugins screen.
2. Activate the plugin through the **Plugins** menu in WordPress.
3. Ensure WooCommerce is installed and active.
4. Go to **MM Analytics > Dashboard** to view your store analytics.
5. Go to **MM Analytics > Settings** to configure your margin percentage and preferences.

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes. WooCommerce must be installed and active for this plugin to work. MarginMinds Analytics reads your existing WooCommerce order data to generate reports.

= Is this plugin free? =

The core plugin is completely free with no time limit. A Pro version is available at marginminds.com for advanced features including Google Ads sync and customer lifetime value.

= Will this plugin slow down my store? =

No. MarginMinds Analytics only loads on your WP Admin pages — never on your storefront. All queries are optimised and only run when you visit the analytics dashboard.

= Does this plugin work with WooCommerce HPOS? =

Yes. MarginMinds Analytics is compatible with WooCommerce High Performance Order Storage (HPOS) and will automatically detect and use the correct database structure.

= How is estimated profit calculated? =

Estimated profit is calculated using a simple margin percentage that you set in Settings. For example, if your revenue is $10,000 and your margin is 30%, the estimated profit shown is $3,000. You can adjust this percentage any time in Settings > Profit.

= Does the plugin store my order data externally? =

No. MarginMinds Analytics only reads your existing WooCommerce order data stored in your own database. It does not send any data to external servers unless you optionally connect a paid ad platform in Pro or Pro Plus. Ad platform connections use official OAuth — your credentials are never stored by MarginMinds.

= Where can I report bugs or request features? =

Please use the support forum on WordPress.org. We aim to respond within 48 hours. Pro and Pro Plus customers receive priority email support at support@marginminds.com.

= Where can I upgrade to Pro? =

Visit https://marginminds.com/pricing to view Pro and Pro Plus plans.

== Screenshots ==

1. Dashboard — overview cards showing revenue, orders, AOV, new customers and estimated profit.
2. Charts — revenue line chart and orders bar chart for the last 30 days.
3. Products — top 5 products by revenue and by quantity sold.
4. Recent orders — latest 10 orders with status, total and customer name.
5. Insights — best selling day and peak hour cards.
6. Ad Spend — manual spend entry with ROAS calculation.
7. Settings — tabbed settings page with general, profit, dashboard, and notification options.

== Changelog ==

= 1.0.0 =
* Initial release.

== Upgrade Notice ==

= 1.0.0 =
Initial release of MarginMinds Analytics.