MarginBeacon – Promotion Margin Risk Checker
| 开发者 | pluginkayvandra |
|---|---|
| 更新时间 | 2026年11月7日 18:14 |
| PHP版本: | 7.4 及以上 |
| WordPress版本: | 7.1 |
| 版权: | GPLv2 or later |
| 版权网址: | 版权信息 |
详情介绍:
- Product cost setup and coverage: Use WooCommerce native Cost of Goods Sold (COGS) when available, or MarginBeacon Cost, with an optional global assumed-cost fallback. Coverage is sampled from supported catalog items, not a full-catalog guarantee.
- Selected-coupon preflight: Evaluate one native WooCommerce percentage, fixed-product, or fixed-cart coupon at a time against a bounded set of eligible products.
- Sale-price awareness: Use a product's current regular or active sale price as the selected-coupon price basis. There is no standalone sale-price preflight. Supported sale-price evidence can also appear on promotional orders.
- Explainable risk classifications: Review severity, reason, affected product, cost source, and suggested remediation instead of a pass/fail result alone.
- Safe handling of incomplete evidence: Missing, stale, unsupported, or indeterminate data is reported as Unknown, never silently treated as Safe.
- Promotion-related order monitoring: See Promo Risk badges in WooCommerce Orders and open order-level risk details. Unpaid orders may first receive a preliminary result and be evaluated again after payment.
- Recent Orders Preview: Optionally evaluate up to 30 days or the latest 100 qualifying orders, whichever limit is reached first, to establish useful initial coverage.
- Global thresholds and basic health tools: Configure one store-wide threshold profile and review operational status and recovery guidance.
- Set up product costs. Open WooCommerce > MarginBeacon > Cost Setup, choose the active cost source, and review cost coverage.
- Evaluate a supported promotion. Open Preflight, select one published native WooCommerce coupon, and run the evaluation.
- Review risk. Read preflight findings, then use Findings / Order Risks and Promo Risk badges in WooCommerce Orders to review supported promotional orders.
- MarginBeacon never changes storefront prices, coupons, cart totals, checkout behavior, or original order data.
- Checkout remains non-blocking. Version 1.0 is watch-only and does not enforce or block discounts.
- Coupon inventory covers native WooCommerce coupons. Third-party promotion engines are not claimed as complete or supported inventory.
- No promotion signal, unavailable Pro functionality, incomplete evidence, a processing failure, or stale data ever results in a Safe classification.
- MarginBeacon estimates gross product profit and gross product margin. It does not calculate net profit and is not financial or accounting advice.
- WordPress 6.4 or later
- PHP 7.4 or later
- WooCommerce 8.0 or later
- PHP BCMath extension
安装:
- Install and activate WooCommerce.
- Confirm that the site meets the WordPress, WooCommerce, and PHP versions listed above, and ask your host to enable PHP BCMath if needed.
- In WordPress, open Plugins > Add Plugin, search for "MarginBeacon", and select Install Now. You can also upload the MarginBeacon ZIP from Plugins > Add Plugin > Upload Plugin.
- Activate MarginBeacon from the Plugins screen.
- Open WooCommerce > MarginBeacon > Cost Setup. Choose WooCommerce COGS or MarginBeacon Cost as the active source, then add costs and review coverage.
- Open Settings to review the global margin thresholds.
- Open Preflight, select one published native WooCommerce coupon, and run your first evaluation.
- Review the result in Preflight and Findings / Order Risks. Promo Risk badges also appear for supported promotional orders in WooCommerce Orders.
屏幕截图:
常见问题:
Does MarginBeacon block checkout?
No. MarginBeacon is watch-only. It does not create, edit, apply, disable, or enforce coupons, and it does not change cart totals or block checkout.
Why do I see Unknown?
Unknown means MarginBeacon does not have enough reliable evidence to classify the result as Safe, Warning, High, or Critical. Common causes include missing cost, incomplete currency or totals data, uncertain sale-price provenance, stale evidence, unsupported scenarios, or processing problems. Incomplete evidence is never labelled Safe.
How does Cost / COGS work?
One canonical cost source is active at a time: WooCommerce native COGS when available, or MarginBeacon Cost. You can also enable an optional global assumed-cost fallback. Missing cost is never treated as zero. Migration to WooCommerce COGS copies only empty WooCommerce cost fields and switches only after a verified catalog pass.
What does MarginBeacon actually do?
It estimates gross product margin risk for supported WooCommerce promotion scenarios. You can preflight a selected native coupon before launch and review risk evidence on supported promotional orders, including preliminary results before payment is confirmed.
Can I use MarginBeacon for free?
Yes. MarginBeacon Free includes cost setup and coverage, manual selected-coupon preflight, promotion-related order risk, a bounded Recent Orders Preview, global thresholds, and basic health tools. Pro is an optional companion for deeper automation and analysis.
What happens when product cost data is missing?
Missing cost is never treated as zero. Depending on the available evidence and configured fallback, the result remains Unknown rather than being labelled Safe.
Why is a stored cost of 0 different from a missing cost?
An explicit stored cost of 0 is a real merchant-entered value, for example a free sample. A missing cost means no reliable cost evidence exists. Only the missing case stays Unknown. A proven zero cost can produce a 100% gross product margin when revenue is positive.
Can it calculate net profit?
No. MarginBeacon calculates gross product profit and gross product margin estimates. It is not a net-profit, cash-flow, tax, fulfillment-cost, or accounting system.
Which discount scenarios are supported?
Free manually evaluates one selected native WooCommerce percentage, fixed-product, or fixed-cart coupon at a time against a bounded set of eligible products at quantity 1. Fixed-cart coverage is single-line, not a representative multi-line basket. There is no standalone sale-price preflight. An active sale price is used only as the current price basis for that selected coupon. Supported order evaluation can use verified native coupon and sale-price evidence. Unsupported or ambiguous promotion mechanisms are not presented as Safe.
Does it work with variable products?
Yes, supported preflight scenarios evaluate purchasable variations individually. Each relevant variation still needs resolvable cost and price evidence. External or affiliate products, bundles, composites, add-ons, and subscription renewals are not claimed as supported without a specific integration.
What does Recent Orders Preview cover?
It is an optional first-look at recent promotional orders so Promo Risk is not empty after install. It evaluates up to 30 days or the latest 100 qualifying promoted orders, whichever limit is reached first. It is not a full historical backfill of every past order.
Why is a free-shipping coupon not simply Safe?
A free-shipping coupon does not reduce merchandise revenue, so product-margin math can look Safe while shipping cost is still unmeasured. MarginBeacon may label that as product margin Safe with shipping cost excluded. That result is not a claim that the whole promotion is safe.
Why is a subscription renewal Unsupported?
Recurring renewals use pricing and eligibility rules outside the current WooCommerce native coupon and sale-price contract. MarginBeacon marks those orders Unsupported instead of guessing a Safe or at-risk result.
What is the difference between Free and Pro?
Free provides manual preflight and core promotion-risk monitoring. Pro adds automated and targeted scans, representative multi-line fixed-cart baskets, category-level controls, advanced evidence and reporting, baseline-order monitoring, advanced recalculation, and Price History.
更新日志:
- Publish the current Free package as the stable 1.0.1 download so the prior stable release remains available. No calculation, checkout, coupon, price, or stored order data behavior changes.
- First public release of MarginBeacon Free.
- Product cost setup with MarginBeacon Cost or WooCommerce native COGS, including admin list/edit fallbacks when the native COGS UI is unavailable.
- Selected native-coupon preflight for campaign margin risk before launch.
- Asynchronous Promo Risk badges on orders, with preliminary evaluation before payment confirmation and confirmed evaluation after payment.
- Global margin thresholds, freshness tracking, acknowledgement, and operational health tools.
- Hardened admin notice scoping and explicit native WooCommerce nonce validation for product and bulk COGS edits.