=== Alpha Insights - Advanced Analytics, Sales Reporting & COGS for WooCommerce ===
Contributors: wpdavies
Tags: woocommerce analytics, woocommerce reporting, woocommerce analytics plugin, woocommerce cost of goods, woocommerce profit
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
Stable tag: 1.8.0
Requires Plugins: woocommerce
License: GPL-2.0-or-later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Advanced WooCommerce analytics plugin for profit reporting, traffic insights, cost of goods (COGS), and custom sales reports.

== Description ==

Alpha Insights is an advanced WooCommerce analytics plugin built for accurate profit reporting, Google Analytics-style store traffic analysis, cost of goods (COGS) management, and custom sales reports.

Go beyond default WooCommerce analytics and basic sales reports with a complete view of your store’s performance. Alpha Insights combines revenue, product costs, payment gateway fees, shipping costs, ad spend, and business expenses in one place — helping you track profit & loss, margins, ROI, customer behavior, product performance, and marketing attribution with confidence.

With our intuitive drag & drop WooCommerce report builder, you can create custom sales reports and fully interactive analytics dashboards in seconds — without spreadsheets, complicated exports, or disconnected tools.

Built specifically for serious WooCommerce store owners who want real financial and performance clarity, Alpha Insights replaces manual reporting with a single WooCommerce analytics and profit reporting system focused on true profitability — not just revenue numbers.

---

== Advanced WooCommerce Analytics & Reporting Features ==

**Advanced WooCommerce Sales Reporting**  
Track revenue, gross profit, net profit, margins, refunds, and order-level profitability with powerful filtering and comparisons.

**WooCommerce Cost of Goods (COGS) Tracking**  
Easily add and manage product costs directly inside WooCommerce. Track profit margins per product, variation, and order. Fully compatible with the native WooCommerce Cost of Goods feature.

**Profit & Loss Reporting for WooCommerce**  
Understand your real profitability by combining revenue, cost of goods, payment fees, shipping, and custom order costs.

**WooCommerce Analytics for Traffic & Marketing Performance**  
Alpha Insights works like a Google Analytics style plugin for WooCommerce, showing traffic sources, landing pages, referral URLs, device types, and campaign performance directly inside your store dashboard.

**Drag & Drop WooCommerce Analytics Dashboards & Custom Sales Reports**  
Build custom WooCommerce analytics dashboards and sales reports with an intuitive drag & drop builder. Create flexible reports in seconds without spreadsheets, exports, or disconnected analytics tools.

**Custom Order Costs**  
Add commissions, handling fees, transaction costs, or other order-specific expenses.

**Time Series Comparisons & Date Filtering**  
Filter by custom or preset date ranges. Compare year-over-year or previous periods to measure growth.

**Multi-Currency Support**  
Track revenue and costs across multiple currencies with automatic conversion handling.

**Performance Optimized for High-Volume Stores**  
Built for speed with optimized queries and caching for stores with thousands of orders.

---

== PRO Features ==

Upgrade to Alpha Insights Pro to unlock:

**Full Expense Management**  
Track rent, software subscriptions, salaries, utilities, and recurring expenses with categorization.

**Google Ads & Meta Ads Integration**  
Automatically sync ad spend and match WooCommerce orders to campaigns for accurate ROI and profit tracking.

**Advanced Filtering & Segmentation**  
Filter reports by products, customers, traffic sources, campaigns, expenses and more.

**Export to PDF & CSV**  
Export any WooCommerce report for sharing with your team or accountant.

**Third-Party Integrations**
Automatically sync shipping costs, payment gateway fees, and advertising spend for accurate WooCommerce profit and ROI tracking.

**Realtime WooCommerce Analytics Dashboards**  
Monitor live visitor activity and performance metrics as they happen.

**Upgrade to Pro:**
If you're running paid ads or managing serious revenue, Pro unlocks the true financial picture of your store.
[Upgrade to Alpha Insights Pro](https://wpdavies.dev/plugins/alpha-insights/pricing/?utm_source=wordpress&utm_medium=readme&utm_campaign=free_version_upgrade)

---

== Perfect For Store Owners Who Want ==

• Accurate WooCommerce profit tracking  
• Built-in WooCommerce cost of goods management  
• Advanced WooCommerce sales reports  
• True WooCommerce profit and loss reporting  
• Ad spend and ROI tracking (Pro)
• Custom WooCommerce analytics dashboards  

---

== Installation ==

**Automatic Installation**

1. Log in to your WordPress admin panel  
2. Navigate to Plugins → Add New  
3. Search for "Alpha Insights"  
4. Click Install Now  
5. Click Activate  
6. Navigate to Alpha Insights → Settings  

**Manual Installation**

1. Download the plugin zip file  
2. Navigate to Plugins → Add New  
3. Click Upload Plugin  
4. Select the zip file  
5. Click Install Now  
6. Click Activate  

After installation:

1. Configure your product costs in the Cost of Goods Manager  
2. Set up payment gateway costs in Settings  
3. Review optional settings  
4. Start building reports  

---

== Frequently Asked Questions ==

= Do I need to manually add costs for each product? =

You can add product costs individually or set default costs and override them per order if required.

= Can I export my reports? =

Yes. Reports can be exported as PDF or CSV in the Pro version.

= Does this work with High-Performance Order Storage (HPOS)? =

Yes. Alpha Insights is fully compatible with WooCommerce High-Performance Order Storage (HPOS).

= Can I create custom reports? =

Yes. Pro users can create unlimited reports. Free users can modify the pre-installed reports.

= What WooCommerce metrics can I track? =

Revenue, cost of goods (COGS), gross profit, net profit, margins, expenses, ad spend, ROI, customer performance, product performance, refunds, and traffic analytics.

= Is my data secure? =

All data is stored in your WordPress database. Alpha Insights follows WordPress coding standards and security best practices.

= Can I migrate from another cost of goods plugin? =

Yes. A built-in migration and CSV import/export tool is available in the Cost of Goods Manager.

= Does Alpha Insights integrate with WooCommerce Cost of Goods? =

Yes. If you use the native WooCommerce Cost of Goods feature, Alpha Insights will automatically detect and use those values.

= How is this different from default WooCommerce reports? =

Default WooCommerce reports focus primarily on revenue. Alpha Insights adds cost of goods tracking, profit & loss reporting, expense management, ad spend attribution, and advanced filtering to show your true store profitability.

---

== Screenshots ==

1. WooCommerce Sales Report Example  
2. Profit & Loss Analytics Dashboard  
3. Drag & Drop Report Builder  
4. Report Manager  
5. Building a Custom Report  
6. Widget Configuration  

---

== Changelog ==

= 1.8.0 =
* Add - Beta version of cache safe analytics tracking - analytics v2.
* Add - Include common cost of goods plugin's meta keys as fallback for cost of goods value - filterable

= 1.7.0 =
* Add - Filter added for overriding line item COGS _wpd_ai_line_item_cost_per_unit_meta_key.
* Add - Filter added for overriding total product cost of goods -> _wpd_ai_override_total_product_cost
* Tweak - Report page now doesn't load heavy filters by default, must be enabled via a filter
* Tweak - Compatability upgrade

= 1.6.0 =
* Add - Optimize report filter options so that we don't load in thousands of records if the user has a lot of products.</li>
* Add - Include date created in product analytics data table as well as SKU & pretty badge</li>
* Fix - Bugfix empty date warnings in private get_date_from_gmt</li>
* Add - Include date created in product reporting data table</li>
* Fix - Bugfix error with multiple querey param values or keys in sales reporting</li>

= 1.5.0 =
* Include translation support for react report builder and expense management module
* Update datawarehouse to support the exclusion of refunds in reporting

= 1.4.0 =
* Implement integration with PPOM For WooCommerce - add cost inputs to track costs for product add ons
* Fix order calculator considering "free" orders as refunded, therefore implementing the refund cost rules where it shouldn't
* Update various docs in the docs helper

= 1.3.0 =
* Cleanup a few more broken links
* Implement pro menu items with pro feature list for visibility

= 1.2.0 =
* Fixed a few broken docs links
* Cleaned up integrations page & got rid of undefined array error on webhooks page
* Added about us page
* Implemented reviews system

= 1.1.0 =
* Rebuild the refund system to apply movements in net sales & GP according to the refund date, not the original order date
* Refunds report added
* Order attribution (ref and landing page url) are decoupled from the session, with a customizable timeout setting added
* COGS manager uses the actual sell price to calculate profit rather than RRP
* Mobile optimizations added to dashboard on order page

= 1.0.0 =
* Initial release of Alpha Insights free version

---

== Upgrade Notice ==

---

== Credits ==

Developed by WP Davies  
https://wpdavies.dev/