=== OrderFloor – Minimum Order & Quantity Limits for WooCommerce ===
Contributors: pluginsshop
Tags: woocommerce, minimum order, min max, minimum quantity, product quantity
Requires at least: 6.5
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.13.16
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Set WooCommerce minimum order amounts, min/max quantities and pack sizes. Test cart rules and show clear checkout messages. Free, no signup.

== Description ==

OrderFloor is a free WooCommerce plugin for minimum order amounts, minimum and maximum quantities, and product pack sizes. Set storewide order limits or product quantity rules, test a sample cart, then review and save your changes.

= Watch the introduction =

**OrderFloor — Free WooCommerce Order & Quantity Limits**

https://www.youtube.com/watch?v=qAsPrCRf93I

Free works locally without an account, payment, licence or external connection. Its features never expire; optional sharing and email choices start unchecked.

= Minimum and maximum order limits =

* Set a minimum order amount or maximum cart subtotal, before or after coupons.
* Set minimum and maximum total units per order, including repeated products.
* Exclude selected products from restrictions and from counted amounts and units.
* Show shoppers the qualifying amount or quantity still needed to meet a limit.

For example, a €35 qualifying cart needs €15 more to meet a €50 minimum. A separate three-unit rule counts eligible product quantities across the cart. Amounts use your store currency.

= Product quantities and pack sizes =

Set minimum/maximum quantities, quantity multiples and starting quantities for simple products and variations. Sell products in packs of 6, 12, 18 and so on. Use store defaults, variable-parent defaults and variation overrides: blank inherits; zero disables.

Free checks each variation separately. It supports stock-aware quantity controls and server-side validation in Classic and Blocks cart/checkout. Pack dropdowns are optional on Classic product forms; Blocks use native controls.

= Preview rules and explain checkout corrections =

Try spend, quantity and pack examples in a draft. Use Cart preview with catalogue products, compare before-and-after values, then confirm the save. Edit six plain-text notices for minimum/maximum spend and units, pack multiples and whole units. Supported product forms also explain when stock cannot satisfy a pack.

[Try the Free demo](https://orderfloor.com/demo/?edition=free) | [Setup guides](https://orderfloor.com/docs.html) | [Get support](https://orderfloor.com/help/)

= Optional OrderFloor Pro add-on =

The separate paid Pro plugin adds rules for existing customer/wholesale roles, product spending limits, category requirements, mixed cases of one parent's variations and visual progress. It also adds CSV tools, reviewed bulk edits, mapped transfers, resumable jobs, test suites, schedules and handover reports.

Pro editing/tools require initial online licence activation; Multisite activation is not supported. Free's Explore Pro area contains labelled local examples. The Pro previews switch hides optional suggestions for your account; Explore Pro remains available.

[Compare Free and Pro](https://orderfloor.com/compare.html)

= Requirements and supported checkout scope =

Requires WooCommerce 8.3+, WordPress 6.5+ and 64-bit PHP 7.4+. Supports Classic/Blocks cart and checkout and HPOS. Product rules use the classic Inventory and Variations editors, not the block product editor. Edit grouped-product children individually; grouped-parent rules do not pass to children. External products have no local checkout rules.

Whole units only. Fractional quantities, bundles/composites, subscription renewals, third-party quick-order flows and currency-conversion plugins are unsupported. Direct admin/REST orders and existing-order payment pages are outside enforcement. Complex or split-line carts may use ordinary controls with server validation.

Tax, shipping and fees do not count toward subtotal limits. Currency changes do not convert saved amounts. Cart preview does not apply coupon codes or simulate stock, shipping, payments or every extension. Check passing and blocked storefront carts with your theme and checkout extensions.

While enabled, rules block negative qualifying product amounts; excluded products and negative fees do not count. Paused rules stay paused. Unreadable saved settings or 32-bit PHP block checkout with recovery guidance; damaged settings are not replaced with defaults.

= Step-by-step video tutorials =

**Minimum order amount** — [Written guide](https://orderfloor.com/minimum-order.html)

https://www.youtube.com/watch?v=vQHdIfvJxUY

**Minimum order quantity** — [Written guide](https://orderfloor.com/minimum-quantity.html)

https://www.youtube.com/watch?v=N9jsM9Wxzko

**Sell in packs** — [Written guide](https://orderfloor.com/sell-in-packs.html)

https://www.youtube.com/watch?v=3hRHkQYV9Tg

OrderFloor is made by Plugins.shop. [Explore the optional plugin collection](https://plugins.shop/); none is required to use OrderFloor.

== Installation ==

1. Activate WooCommerce 8.3 or later, then install and activate OrderFloor from Plugins > Add New Plugin or upload the individual Free ZIP.
2. Open WooCommerce > OrderFloor. Set a limit, try Cart preview, then Review changes and save.
3. For product quantities, open Products > Edit > Inventory > OrderFloor quantity rules; use Variations for overrides.
4. Test storefront carts, coupons and variations before going live.

Blank or 0 disables a storewide limit; product rules can still apply. Back up before updating. For an existing Free/Pro pair, update Pro to 1.13.16 first, then Free to 1.13.16, without uninstalling. For a new site, install Free before Pro. Free uses standard WordPress updates; see Tools & testing > Support & updates.

== Frequently Asked Questions ==

= Does a minimum order quantity mean different products? =

Free counts eligible units, including repeated products. Five units of one product can meet a five-unit minimum. A minimum number of distinct products requires Pro.

= Can I set a minimum for one product or variation? =

Free supports product/variation quantity limits and packs. A product-specific monetary minimum requires Pro; Free spending rules cover the qualifying cart.

= Can customers mix variations to make a pack? =

Free checks each variation separately. Pro can combine variations of one variable parent into a mixed case; individual product rules still apply.

= Does a minimum of five and a pack size of six allow 5, 11 and 17? =

No. Valid multiples are 6, 12, 18 and so on. The minimum sets the floor, not the sequence origin.

= Can I customize the minimum order message? =

Yes. Store rules > Messages supports {label}, {target}, {current} and {remaining}. Blank uses standard wording. Remaining-amount notices are Free; visual progress is Pro.

= Does Free require signup or a licence? =

No. There is no required account or trial expiry. Welcome sharing/email choices are optional. Pro previews can be hidden without changing saved rules or individual dismissals.

= What happens when I deactivate or delete OrderFloor? =

Deactivation keeps settings and stops reports. Deletion removes local welcome choices, credentials and temporary forms. Enable Delete data on uninstall to remove settings, revisions and product-rule fields too. Pro has its own deletion preference; products/orders remain. Drafts expire within an hour. Clear browser copies, exports and backups separately; disconnect sharing before deletion and unsubscribe confirmed email through its email link.

== Screenshots ==

1. Set a minimum beside a real sample-cart result.
2. Show shoppers the amount still needed to meet the minimum.
3. Test saved settings or a draft without saving changes.
4. Set product quantities and pack sizes in Inventory.
5. Review the before-and-after values before saving.
6. Generate and inspect a redacted support report.
7. Explore clearly labelled examples of the separately installed Pro add-on.

== Privacy and external service ==

Rules run locally; no shopper profiling or customer/order data is sent. Local storage: settings, ten revisions with editor ID/time (no timed expiry), and one-hour recovery drafts. Browser preferences remain until cleared. Support reports contain versions, plugin names and redacted rules; review them before sharing. They are not sent automatically.

**Optional welcome service:** two independent unchecked choices. Skip, close or save neither to send no welcome request. Updates do not broaden earlier permissions.

* Compatibility sharing sends the site domain, WordPress/PHP versions and site language.
* Email signup sends your editable email and Free/Pro edition; confirmation is required. New subscriptions start with tips, releases, weekly blog articles, offers and all current interests selected. Email preferences control topics, frequency and unsubscribe; existing choices stay unchanged. Purchase-history personalization and link tracking start off. Offers require consent and a recent Free report.

Selected data goes by verified HTTPS to `https://orderfloor.com/newsletter-api/v1/plugin-welcome/` with a random connection ID, protected credential and consent version. The service receives the network address and stores credential hashes and consent/report times. Email-only signup sends no site domain. No customer data, orders, names, rules or plugin lists are included.

Reports refresh weekly, with edition-change reports/retries as needed; WP-Cron depends on traffic. Manage welcome choices to stop either scope or retry failed removal. Site-address changes pause reporting. Stopping email sharing cancels pending signup and removes the edition report; confirmed subscriptions require the email unsubscribe link. Uninstall removes local credentials without contacting the service.

Retention: inactive report/control data 90 days; pending signup 48 hours; confirmed subscriptions at most 730 days; consent/suppression 180 days. Cleanup/backups can delay deletion. WordPress privacy tools cover local email choices; a keyed retry fingerprint remains until remote removal succeeds.

**Previous installation sharing:** older consented connections send daily HTTPS reports to `https://orderfloor.com/installation-api/v1/`: hostname, random installation ID, edition/plugin versions and consent version for statistics/support. Stop/delete them in Previous installation sharing. Records expire after 90 inactive days; deletion retries last up to 90 days. A pseudonymous revocation fingerprint has no expiry to prevent recreation. No email, customer, order, visitor or settings data is reported.

[Privacy policy and retention details](https://orderfloor.com/privacy.html) | [Pro purchase terms](https://orderfloor.com/checkout/terms)

The Pro previews choice, individual suggestion dismissals and chosen setup goal are stored locally for each WordPress user on this site until changed or removed on uninstall. They are not sent to Plugins.shop or OrderFloor. More Plugins uses bundled descriptions and logos; product websites open only when you follow their links.

Readable source included; no build step or external asset CDN.

== Changelog ==

= 1.13.16 =
* Refresh the genuine Free screenshots and bundled Pro examples for the matching 1.13.16 releases.
* Update screenshot captions and visual documentation; saved rules and checkout behavior are unchanged.

Older notes: changelog.txt or [release history](https://orderfloor.com/changelog.html).

== Upgrade Notice ==

= 1.13.16 =
Refreshes screenshots and visual documentation. Update Pro to 1.13.16 first, then Free to 1.13.16, without uninstalling. Saved settings and checkout rules are unchanged.
