Repository navigation
README
Practical tools for your FluentCart shop. The Cart Rules module provides single-item carts, minimum quantities and merchandise value, maximum quantities, and quantity steps.
Version 0.9.1 · WordPress 7.1.2+ · PHP 8.2+ · FluentCart 1.7.x
Contents
About · At a Glance · Installation · Features · FAQ · Changelog · Project · Security and support · License
- Cart Rules is the first module in the Tools series.
- Five presets with adjustable values.
- Combine total and per-product quantity rules in custom mode.
- Single-item mode replaces the previous product and hides quantity controls.
- Checkout validation uses server-side cart data.
- Site-specific settings, including Multisite.
- English source, German informal and formal translations.
Upload the installable ZIP under Plugins → Add Plugin → Upload Plugin. Open FluentCart → Tools for FluentCart, choose a preset, review the values, save and enable rules. Both older single-item add-ons must be deactivated. Rules are disabled on a fresh installation. Without FluentCart, Cart Rules stays paused and a notice appears inside the admin. Tools settings are then under Settings → Tools for FluentCart. Installing and activating FluentCart restores the shop-menu location. While the module is paused, saved rules remain visible and read-only; direct save requests cannot change them. The independent uninstall preference remains available.
Exactly one product variation with quantity one. A newly added item replaces the previous item. Existing editable carts are reduced to their last row when next loaded. Removing the item remains possible.
Choose a minimum total number of units and/or a minimum per product variation. Different products may contribute to the total minimum.
Use the shop currency. Count merchandise after discounts, excluding shipping and fees. Tax inclusion follows FluentCart product pricing. A free product does not satisfy a positive minimum value.
Limit total units and/or units per product variation. Customers can adjust their cart freely; invalid carts cannot be ordered.
Each selected product variation must have a quantity divisible by the configured step. A step of 6 accepts 6, 12 or 18, rather than 1, 7 or 13. Limits are checked together so contradictory settings cannot be saved.
Single-item mode adjusts editable carts automatically. All other rules are checked at checkout. Rule guidance appears in the standard cart and checkout views.
Presets fill the fields as a starting point. Use custom rules to combine limits. Single-item mode is exclusive and clears the other limits on save.
Each product variation counts separately. A bundle counts as one cart row; its components are not individually limited.
No. Rules apply to each cart, without customer history or account limits.
Settings belong to each website. Network activation introduces no shared order rule. New websites start with rules disabled. Known upstream limitation in FluentCart 1.7.0: When creating a new website in a Multisite network, the FluentCart scheduler can report database errors because the required tables are not yet available. This issue originates in the parent plugin FluentCart 1.7.0. Tools for FluentCart documents the limitation and does not modify FluentCart to address it.
This release requires WordPress 7.1.2+, PHP 8.2+ and FluentCart 1.7.x. Other FluentCart minor versions leave the adapter inactive. Test subscriptions, order bumps, bundles, custom storefronts and other cart-changing add-ons before production use. Tools can be activated without FluentCart; the module stays paused until a supported version is active.
Settings are retained by default. Each website can opt to delete only its Cart Rules settings. Temporary updater and final-host Library caches are cleaned according to their scopes. FluentCart products, orders and carts are never deleted.
- Improved: Updated shared Library and updater integration; protected paused rule settings and improved admin notices, save confirmations and changelog dialog reliability.
- New: Cart Rules with single-item carts, minimum quantities and order value, quantity limits and steps.
- Misc: Development and test versions; not publicly released.
Developed by David Decker – DECKERWEB. Part of the Tools series. Cart Rules is the first module.
Report vulnerabilities privately through the plugin repository’s Security → Report a vulnerability workflow. Include plugin, FluentCart, WordPress and PHP versions, reproduction steps and impact, without passwords or customer data. Ordinary issues may be reported in Issues. Do not publish security details in public issues.
Questions and ordinary bugs: repository Issues. Confidential reports: Security. Support: https://ko-fi.com/deckerweb, https://buymeacoffee.com/daveshine, https://paypal.me/deckerweb.
Copyright © 2026 David Decker – DECKERWEB. GPL v2 or later; SPDX: GPL-2.0-or-later. Embedded deckerweb Plugin Library 1.1.0 and deckerweb Updater 2.2.1 are by the same author, GPL-2.0-or-later. Their stable runtime sources are copied unchanged; host adapters and translation catalogs are separate. No FluentCart implementation or premium code is distributed in this plugin.