=== Profitrics - Profit, COGS and Expense Tracker for WooCommerce ===
Contributors: camerce
Tags: profit, cogs, cost of goods sold, profit margin, woocommerce
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
WC requires at least: 9.5
WC tested up to: 11.0.1
Stable tag: 1.2.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

See your store's real profit, not just revenue: product COGS, gateway and shipping costs, expenses, and order-level margin.

== Description ==
Revenue tells you what came in. It does not tell you what you kept.

Profitrics subtracts what an order actually costs you — product cost, payment gateway fees, shipping, and your own operating expenses — so every order, product and date range shows a real net profit and margin figure.

Costs are written to WooCommerce's own native Cost of Goods Sold field, so your cost data lives in the platform rather than being locked inside a plugin. If you ever remove Profitrics, your product costs stay where they are.

= What you get, free =
* Profit dashboard with revenue, total cost, net profit and margin.
* Order-level profit snapshots you can filter and sort.
* Cost of Goods Sold per product and per variation.
* Payment gateway fee rules, fixed plus percentage, with no limit on how many.
* Shipping cost rules, so shipping is priced into every order's margin.
* Business expenses, one-off or recurring, folded into your net profit.
* Margin alerts and in-dashboard notifications, including negative-margin warnings.
* Product profitability table with CSV export.
* Your full order history, with no date cap.

= Who it is for =
* Merchants who need real net-profit visibility, not just gross sales.
* Operations and finance teams tracking margin health day to day.
* Agencies reviewing store performance for clients.

= Tabs in the free edition =
* Dashboard
* Products
* Orders
* Gateway Fees
* Shipping
* Expenses
* Export
* Settings

== Upgrade to Pro ==
The Pro edition adds the automation and reporting layers on top of everything above:

* Ad Spend and POAS: record what you spend per channel and see profit after ads.
* Customer profitability and lifetime value, including your most and least profitable buyers.
* Inventory valuation: capital tied up in stock, dead stock, and margin at risk.
* Profit goals with pace tracking, plus period-over-period and year-over-year comparison.
* Trends: daily performance and top-product profit contribution.
* COGS Manager: bulk editing, CSV import and export, and rules that derive cost from price.
* Scheduled profit reports delivered by email, daily, weekly or monthly.
* REST API access and outbound webhooks with signed payloads.
* Full CSV and PDF export across orders, expenses and rules.

Get the Pro edition: https://woocommerce.com/products/profitsync/

Pro reads the same options, database tables and product meta as Lite, so upgrading needs no migration and no data re-entry. Installing Pro automatically stands Lite down so the two never run at once.

== Installation ==
1. Install from Plugins > Add New, or upload the `profitsync-lite` folder to `/wp-content/plugins/`.
2. Activate the plugin through the WordPress Plugins screen.
3. Open `WooCommerce > Profitrics`.
4. Set your gateway fee and shipping defaults in the `Settings` tab.
5. Enter product costs in each product's Cost of goods field.
6. Review performance in the `Dashboard` tab.

== Frequently Asked Questions ==
= Does this plugin require WooCommerce? =
Yes. WooCommerce must be installed and active.

= Where is my cost data stored? =
Product costs are written to WooCommerce's native Cost of Goods Sold field. Order profit snapshots are cached in a plugin table so reports stay fast on large stores.

= Does the free edition track expenses? =
Yes. You can record both one-off and recurring costs, and they are folded into your net profit. Dedicated ad spend tracking with POAS reporting is a Pro feature.

= Can I set COGS in bulk? =
Bulk COGS editing, CSV import and export, and price-based COGS rules are Pro features. The free edition lets you set cost per product and per variation.

= What happens if I install the Pro edition later? =
Nothing needs migrating. Pro reads the same data, and Lite deactivates itself automatically so both editions never load in the same request.

= Can I export data? =
Yes. Product profitability can be exported to CSV from the Export tab.

= Does this plugin send my data anywhere? =
No. Profitrics makes no external requests. All calculation happens on your own server.

== Screenshots ==

1. Profit dashboard: net profit, revenue, total costs and margin, with revenue against profit over time and a breakdown of where the costs went.
2. Top products by profit, and how profit is distributed across your categories.
3. Margin notifications, quick stats, and payment gateways detected automatically from your store.
4. Product profitability: COGS coverage, margin per product, and which products fall below your margin threshold.
5. Order profitability, including applying your current costs and fees back over past orders.
6. Per-gateway fee rules, so each order is charged its real payment processing cost.
7. Shipping cost rules by method, shipping class and currency.
8. Settings: currency, rounding, which order statuses count toward profit, and margin alerts.
9. Business expenses, one-off or recurring, subtracted from net profit.

== Changelog ==
= 1.1.7 =
* First public release of the free edition.
* Profit dashboard, product COGS, and order-level margin snapshots.
* Gateway fee and shipping cost defaults.
* Expense tracking, one-off and recurring.
* Product profitability CSV export.
* Version numbering is kept in step with the Pro edition, so both editions always report the same release.

== Upgrade Notice ==
= 1.1.7 =
First public release of Profitrics.
