Pricing handbook / Developer boundaries and change notes

HS Dynamic Pricing & Discount Rules · 0.1.0-alpha.3

Developer boundaries and change notes

Understand the alpha’s integration boundaries, saved order information and recent fixes.

No stable public integration API yet

The alpha does not expose a public rule-management REST endpoint or stable PHP API. Schema, Engine, Store, Cart, Admin and hs_dynamic_pricing_rules_v 1 are experimental internal details. Do not write the rules option directly in production. No AI rule-configuration integration is implemented.

Runtime behavior

The plugin consumes woocommerce_before_calculate_totals at priority 100 to adjust cloned product objects in memory. woocommerce_get_item_data adds promotion names, whole-line savings before coupons and a rounded average when needed. woocommerce_checkout_create_order_line_item copies applied-rule information through native order CRUD. HPOS order data is not written with custom SQL.

A display-only extension on the native Store API cart item exposes internal adjusted/averaged boolean flags under hs-dynamic-pricing. The native cartItemClass filter scopes the Blocks presentation. These flags are not a stable external contract. No telemetry or remote licensing call is performed.

0.1.0-alpha.3

  • Added automatic gifts, campaign unit quotas and selected-method free-shipping promotions.
  • Expanded targeting, required coupon codes, selective coupon handling and campaign reports.
  • Extended the simulator with actual coupon calculations, customer and shipping context, and supported Min/Max quantity and amount checks.
  • Added product quantity examples and monetary threshold checks. These examples are not a complete table of every price range.

0.1.0-alpha.2

  • Fixed repeated BOGO discounts when WooCommerce normalized a repeating decimal price during checkout.
  • Corrected promotion savings calculated from rounded unit displays. Whole-line totals remain authoritative.
  • Preserved accessible labels after adding simulator rows.
  • Expanded local browser and integration checks.

0.1.0-alpha.1

Initial engine, editor, simulator, revision protection and cart/order integration. No public release or compatibility matrix was established by that milestone.

Reproduce an issue

Record plugin/WP/Woo/PHP versions, rule type, selected products and prices, quantities, strategy, customer role, coupons and tax settings. Compare cart, checkout and saved order; omit personal customer data. Use synthetic examples on staging. A numeric engine test alone is not proof of the full purchase flow.

Choose another guide →