FAIR

Federated and Independent Repositories

ProfitLatch Coupon Floor for WooCommerce

Plugin Banner

ProfitLatch Coupon Floor for WooCommerce

by moreorange147

Download
Description

ProfitLatch Coupon Floor is a small, focused safety layer for stores that use WooCommerce core coupons but do not want combined coupon discounts to consume the merchandise gross margin on a cart line.

It does not create new discount rules. It works with WooCommerce core percent and fixed-product coupons and uses WooCommerce’s native Cost of Goods Sold data.

Example:
* Product price: $100
* Native WooCommerce COGS: $80
* Required merchandise gross margin: 10%
* Minimum product revenue: $88.89
* Maximum combined coupon discount on that line: $11.11

If several supported coupons are applied, ProfitLatch Coupon Floor tracks discounts already granted to each cart line during the current totals calculation and limits later coupon amounts so the configured product-level gross-margin floor is not crossed.

Important scope:
* Uses the current WooCommerce product price and native WooCommerce COGS.
* Protects merchandise gross margin before shipping cost, payment-gateway fees, taxes, and other order-level expenses.
* If a product has no usable COGS value, ProfitLatch Coupon Floor does not guess a cost and leaves the coupon calculation unchanged.
* Supports WooCommerce core percent and fixed-product coupons in this initial release.
* The hard-floor compatibility promise applies when all discounts affecting a protected line are supported core percent and/or fixed-product coupons.
* Fixed-cart coupons are deliberately left unchanged because WooCommerce has a remainder-allocation path that bypasses the discount filter used by this release. Mixed stacks that include fixed-cart coupons are outside the hard-floor compatibility promise.
* Third-party custom coupon types, dynamic-pricing engines, and mixed stacks that include those discounts are outside the compatibility promise.
* Does not send store, order, product, coupon, or customer data to any external service.
* The guard is disabled by default after installation and changes no coupon amounts until a store manager enables it.

Why this is intentionally narrow:
Many discount plugins focus on creating promotions. ProfitLatch Coupon Floor does not replace them. Its purpose is to add a lightweight native-COGS safety check to WooCommerce core coupon calculations without introducing another pricing engine.

  1. Install and activate WooCommerce 10.3 or newer.
  2. Enable WooCommerce Cost of Goods Sold and enter COGS for the products or variations you want protected.
  3. Upload and activate ProfitLatch Coupon Floor for WooCommerce.
  4. Go to WooCommerce > ProfitLatch Coupon Floor.
  5. Set the minimum merchandise gross margin percentage and enable the guard.
Does this guarantee that an order is profitable?

No. The current version protects a product-level merchandise gross-margin floor using product price and native WooCommerce COGS. It does not include shipping costs, payment-gateway fees, taxes, advertising costs, returns, or other expenses.

What happens if a product has no COGS value?

The plugin fails open for that line: it leaves the WooCommerce coupon amount unchanged rather than inventing a cost.

Which coupons are supported?

WooCommerce core percent and fixed-product coupons. The hard-floor promise applies to stacks made only from those supported coupon types. Fixed-cart coupons, third-party custom coupon types, independent dynamic-pricing engines, and stacks mixed with those unsupported discounts are outside the initial compatibility promise.

What happens when the store allows coupon stacking?

The plugin remembers supported coupon discounts already granted to each cart line during the current totals calculation. Later supported coupons can use only the remaining safe discount capacity.

Does it work when “Calculate coupon discounts sequentially” is off?

The guard is designed around WooCommerce core coupon filters rather than requiring sequential coupon calculation. Compatibility can still vary by WooCommerce version and third-party discount code, so test your own coupon stack before relying on it in production.

Does the plugin send data anywhere?

No. The plugin does not automatically send store, order, product, coupon, or customer data to an external service. The settings page contains an optional link to the ProfitLatch Pro early-access form; data is only submitted if you choose to open and complete that external form.

Is there a Pro version?

ProfitLatch Pro is in pre-release testing and is not available for purchase yet. If product-, variation-, or category-specific margin floors would be useful, join the early-access list: https://formhug.ai/f/uK9b44

How is the margin calculated?

For the protected cart line, required revenue is calculated as COGS divided by (1 – required margin). Coupon discount capacity is the current line price minus that required revenue, after accounting for earlier supported coupon discounts on the same line.

0.1.2

  • Corrected internal version metadata.
  • Clarified testing and external-data wording to avoid overstating validation.
  • Added an optional ProfitLatch Pro early-access interest link.

0.1.1

  • WordPress.org review compliance update: distinctive naming, unique prefixes, and scoped admin notices.

0.1.0

  • Initial testable release candidate.
  • Global merchandise gross-margin floor.
  • Native WooCommerce COGS support.
  • Core percent and fixed-product coupon protection.
  • Fixed-cart coupons deliberately left unchanged until their remainder-allocation path can be guarded end to end.
  • Cumulative protection for supported stacked coupons.
  • Conservative currency-precision rounding.
  • Disabled by default until a store manager explicitly enables the guard.
Back to top