=== QA Cost of Goods & Margins ===
Contributors: quickassortments, cleijsen, shelfplanner
Tags: cost of goods, cost price, margin, markup, net profit, gross profit 
Requires at least: 4.9
Tested up to: 5.9.1
Stable tag: 2.8.0
Requires PHP: 5.6
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Manage cost prices for your products and variations and instantly see the impact on margin, markup and stock value in your store.

== Description ==

Shelf Planner's Cost of Goods & Margins is a free plugin that allows you to track the profit of your store, products and categories. 
This plugin seamlessly integrates with WooCommerce and lets you manage cost prices for your items and instantly see the impact of changes on your margins and markups.

= Benefits =

* Track profitability of your store, products and categories
 
* Understand the impact of markdowns and campaign
 
* Use the powerful margin and profit reports and dashboards to support your decision making
 
* Use variations and bundles with different cost prices


= Main Features =

* Manage Cost Prices, Markup and Margins for products and variations

* Clean and powerful reports to track your gross and net profit

* Bulk Edit all Cost Prices in one go in the plugin's Settings pages.

* Calculate your "net margin", "gross margin" and "markup" for products and categories.

* For variable products costs can be saved for each variation separately or for all variations at once.

* Add (sortable) product/order cost/profit admin columns to the WooCommerce products and orders lists.

* Import and export product costs from and to a CSV file with standard WooCommerce Import and Export tools.

* Included bulk edit costs tool in the settings pages allows you to bulk edit all products costs, prices and stock from a single page.

* Optionally add “Cost Price", "Margin" and "Stock Value" meta box to WooCommerce product pages.

* and many more...


= Why use this plugin? =
 
Whether you produce your own products, drop-ship, or buy through wholesale, you want to track the profitability of your products and your store. 
To do this, you’ll need to manage the cost price of your products.

These Cost Prices (sometimes referred to as ‘direct costs’) are called the Cost of Goods Sold (COGS) and we have integrated dedicated fields to manage these in your WooCommerce product pages. 

= What is COGS and how does it help me? = 
 
COGS is sometimes also referred to as ‘cost of sales’ or ‘cost of merchandise’ but in short it refers to the production or purchase costs for products sold in your store. 

Technically, these costs are an expense of your business, and in the end they reduce the revenue your store makes from selling. 

So far not a big deal, but once your business grows, it might get tricky to keep track of profitability all of your products.

This plugin allows you to plan, simulate and summarise both your costs, stock value and margins in one place in the WooCommerce product pages so you get an instant overview of how your business is doing.


= For Merchants, By Merchants =

All of our plugins are developed *for merchants, by merchants*. With over *25 years* of combined experience in merchandising and retail, we understand what it takes to run a business.

> Check out our other add-ons on [our website](https://shelfplanner.com/) if you are interested in additional reporting and sales forecasting extensions.

If you want to know more about merchandise planning or assortment planning, don’t hesitate to check out our [Merchant Support](https://shelfplanner.com/) pages
Here you find lots of information on anything related to merchandising and retail.


== Screenshots ==

1. Simply manage cost price per product in the WooCommerce Easy Edit pages.
2. Our plugin seamlessly integrates with the WooCommerce Product Pages.
3. Track stock value, margins and markup for all your products in the WooCommerce product pages.
4. Easily manage *Product Bundles* and *Product Variation*.
5. Change the settings for KPI’s and measures to display in the product pages in our *Shelf Planner* menu.
6. Change settings for the charts and leaderboards in the 'Retail Insight Settings' in our *Shelf Planner* menu. 
7. Review the performance of your store in our Retail Insights reports.
8. Easily navigate between categories, products or different time ranges.
9. Review profitability of your individual products.
10. Track your top performers in terms of Net Revenue and Profitability in the product leaderboards.

== Installation ==

Installing this plugin is very easy and no prior set up is needed. You just need *WooCommerce* installed. And you can install and configure this plugin by following these below steps-

1. Upload the plugin files to the `/wp-content/plugins/qa-cost-of-goods-margins` directory, or install the plugin through the WordPress plugins screen directly.
2. Activate the plugin through the 'Plugins' screen in WordPress
3. Use the *Shelf Planner >> Cost of Goods >> Cost of Goods Settings* screen to configure the plugin
4. Use the product backend fields for setting the cost and seeing the profit margins data
5. You can update the cost data from *Quick Edit* for single product too


== Frequently Asked Questions ==

= I would like to see more history in my charts, is this possible? =

Yes! We are working on an automatic import of all historic data and this will be part of a future release.
The way we calculate margin and profitability is slightly different from how some of the standard calculations are done in WooCommerce. If you want to see historical reports, please check out our Shelf Planner plugin with lots more features, including historical profitability reports. 

= Is this plugin compatible with other third party plugins and themes? =

Yes! Good news is, this plugin has it's own API and it has no interaction with frontend or theme. Moreover, every part of this plugin is modular and hookable. Thus data coming from this plugin is mutable through its API at any stage. And as no frontend interaction this plugin is 100% compatible with any theme.

= Can a user request any new feature? =
Yes! Obviously you can. Either here at this support forum or at our dedicated Jira Support repository you can leave a request. 
You'll find the support pages under 'Support' on our website. From there you'll be directed to our Atlassian support portal and can create change request, report bugs or create a support ticket.

= Can we contribute with code or translation? =
Sure! We'll be more than happy to accept your contribution here.

= What is your future plan with this? Can we rely on you that you'll support this plugin in the future? =
We have a long list of other very cool plugins related to e-commerce business, merchandising and forecasting which are now cooking in the kitchen. These will be released within the next few months. This plugin will work as a base platform for all these plugins. We guarantee to maintain this plugin and update it on a regular basis with new features and cool functionality.

We also have a dedicated team for support and we'll try our best to answer any questions or solve any problem you encounter. We're friendly people, so don't hesitate to reach out to us and ask for support, or if you have any idea on how we can make our products better.

== Changelog ==

= VERSION 2.8.0 | 26-FEB-2022 =
[UPDATE]

* Added Cost of Goods Sold to the reports in our Retail Insights tab.

= VERSION 2.7.0 | 05-JAN-2022 =
[UPDATE]

* Added feature that allows mass upload of cost prices by excel files.

= VERSION 2.6.0 | 15-DEC-2021 =
[UPDATE]

* Added feature that allows bulk edit of cost prices for all products.

= VERSION 2.5.1 | 30-NOV-2021 =
[UPDATE]

* Naming Convention, code documentation fix

= VERSION 2.5.0 | 12-OCT-2020 =
[FEATURE]

* **PW WooCommerce Bulk Edit** and **PW WooCommerce Bulk Edit Pro** integrated, means now you can bulk edit cost price with these plugins.

= VERSION 2.4.0 | 03-SEP-2020 =
[FIX]

* Sanitization fix for some POST input

= VERSION 2.3.1 | 26-AUG-2020 =
[FIX]

* Early sanitized a POST input WordPress.org folks suggested

= VERSION 2.3.0 | 25-AUG-2020 =
[FIX]

* Sanitized some POST and GET input

[UPDATE]

* Switched to PSR2 coding standard

= VERSION 2.2.2 | 10-MAY-2020 =
[FIX]

* Fix for https://wordpress.org/support/topic/cost-price-field-is-not-saved/
* Code formation fixed

[UPDATE]

* Menu rearranged
* CSS/JS and other assets reorganized

= VERSION 2.2.1 | 26-APR-2020 =
[FIX]

* Mark up column decimal issue fixed

[UPDATE]

* CSS, JS and SCSS assets relocated

= VERSION 2.2.0 | 19-APR-2020 =
[FIX]

* Compatibility fix for WooCommerce 4.0+
* Compatibility fix for WordPress 5.4+

= VERSION 2.1.0 | 14-FEB-2020 =
[FIX]

* Coding style fix
* Code documentation fix

[UPDATE]

* New class for helper methods introduced
* New helper method introduced to product or variation cost

[FEATURE]

* For variable product, a new generic cost field introduced to add generic cost to variations

= VERSION 2.0.1 | 04-JAN-2020 =
[FIX]

* Cost price input issue fixed. ISSUE: COGM-52.
* Variation backend design CSS fixed.

[UPDATE]

* `readme.txt` updated.

= VERSION 2.0.0 | 24-DEC-2019 =
[FEATURE]

* Introduced React JS based dashboard.
* Historical data collection support added.
* Introduced D3.js charts for historical data.
* Data storing functionality added


[UPDATE]

* File organization changed.
* Separate DB class added.

[FIX]

* Way of module class calling and instantiating fixed.
* Product dashboard fields CSS alignment fixed.
* PHP class file top unicode header fixed.


= VERSION 1.1.0 | 08-OCT-2019 =
[FEATURE]

* **Margin with including and excluding tax** feature added.


[UPDATE]

* WP version updated to 5.2.3.
* Turned the checkboxes(tick-boxes) into toggle switch at settings page. 

[FIX]

* Made *Changelog* month name uppercase.

= VERSION 1.0.1 | 24-MAY-2019 =
[UPDATE]

* WP version updated to 5.2.1.
* Added 'final' for each class to make the class un-extensible.

[FIX]

* PHPDoc updated for each class and method

= VERSION 1.0.0 | 22-APR-2019 =
* Initial release.
