=== Weight Products for WooCommerce ===
Contributors: arture
Tags: woocommerce, weight products, price per kg, measurement pricing, grocery
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 8.0
Requires Plugins: woocommerce
WC requires at least: 7.1
WC tested up to: 10.6
Stable tag: 1.0.1
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Sell products by weight in WooCommerce and adjust the final price after weighing. Built as an add-on for Order Picking App, but also works standalone.

== Description ==

=== Sell products where the final weight is determined after picking ===

Weight Products for WooCommerce is designed for webshops that sell products where the exact weight is only known after picking or weighing.

Customers place orders using an estimated quantity (e.g. 1 kg of tomatoes), while the actual weight is determined later during fulfillment. The order can then be updated with the real quantity, and WooCommerce automatically recalculates the price.

Ideal for:
- Fresh produce (fruit & vegetables / AGF)
- Meat, fish and poultry
- Cheese and delicatessen
- Nuts and bulk goods
- Farm shops and local delivery services

=== Designed for Order Picking App ===

This plugin is built as an add-on for Order Picking App, enabling a seamless workflow between:

1. Order placement in WooCommerce
2. Picking and weighing via Order Picking App
3. Updating actual weights
4. Automatic recalculation of order totals

Pickers or backoffice staff can enter the actual measured weight, ensuring accurate pricing.

=== Works standalone with WooCommerce ===

This plugin also works fully standalone.

You can:
- Mark products as weight-based
- Allow decimal quantities (e.g. 1.25 kg)
- Adjust quantities in the WooCommerce order admin
- Automatically recalculate totals after updates

=== Key Features ===

- Weight-based products in WooCommerce
- Custom unit support (kg, g, lb, liter, piece, etc.)
- Default quantity per product
- Decimal quantity support
- Store ordered and actual quantities
- Edit actual weight in order admin
- Automatic recalculation of totals
- Quantity display with units in cart and orders
- Fully compatible with WooCommerce HPOS

=== How it works ===

1. Customer places an order
- Product price is set per unit (e.g. €3.49 per kg)
- Customer orders a quantity (e.g. 1.25 kg)

2. Picking and weighing
- Actual weight is measured (e.g. 1.18 kg)

3. Order update
- Enter actual quantity in admin
- Line item quantity is updated
- WooCommerce recalculates totals

=== Use Case: Grocery & Fresh Products ===

WooCommerce is built around fixed quantities, but real-world fresh products vary in weight.

This plugin allows:
- Estimated ordering
- Real-world weighing
- Accurate final pricing

Perfect for stores selling price-per-kg products with post-order adjustments.

=== Why this plugin? ===

Most measurement pricing plugins only calculate prices before checkout.

This plugin focuses on what matters for fresh products:

Adjusting orders after picking and weighing.

== Installation ==

1. Upload the plugin to /wp-content/plugins/
2. Activate the plugin via WordPress admin
3. Ensure WooCommerce is installed and active

== Usage ==

=== Product setup ===

1. Edit a product
2. Enable "Weight product"
3. Select a unit (kg, g, etc.)
4. Set default quantity (e.g. 1.00)
5. Set price per unit

=== Order workflow ===

1. Customer places order
2. Open order in WooCommerce admin
3. Enter actual quantity
4. Save order
5. Totals are recalculated automatically

== FAQ ==

= Does this plugin support decimal quantities? =
Yes, quantities like 0.75 or 1.23 are supported.

= Can I use this without Order Picking App? =
Yes, it works fully standalone.

= Is it HPOS compatible? =
Yes, fully compatible with WooCommerce High Performance Order Storage.

= Does this plugin handle payments? =
No, payment handling is outside the scope of this plugin.

== Roadmap ==

- API integration with Order Picking App
- Bulk updates from picking interface
- Order item status (e.g. "to weigh", "weighed")
- Notifications for adjusted weights

== Changelog ==

= 0.2.0 =
- Added actual quantity field in order admin
- Automatic recalculation of totals
- HPOS compatibility improvements

== License ==

This plugin is licensed under the GPLv2 or later.