Skip to content

Configuring Propono

This guide covers all settings in Propono, how the price override interacts with WooCommerce totals, and the technical mechanics behind cart item tagging.

Access the plugin configuration by navigating to WooCommerce > Order Bump (requires the manage_woocommerce capability).

All configuration is saved in the single WordPress option bump_settings:

Setting Key Default Description
Enable order bump enabled 0 (off) Master switch. When disabled, no styles, scripts, or DOM nodes are injected into the checkout.
Bump product product_id 0 (none) Selects the product offered at checkout. Shows up to 200 published, simple, purchasable, in-stock products.
Heading heading “One-time offer” Catchy callout title rendered at the top of the bump box.
Checkbox label checkbox_label “Yes, add this to my order!” Action-oriented text placed directly next to the input checkbox.
Description description empty Explanatory copy describing the product benefits or bundle discount.
Override price bump_price empty Fixed price applied specifically to the bump line item (e.g., 15.00). If empty, the product’s regular store price applies.
Accent colour accent_color #d97706 Hex colour code defining the border, badge, and checkbox highlight.

When a customer checks the order-bump box, Propono overrides the item price dynamically in memory using the woocommerce_before_calculate_totals action hook at priority 20:

  • Decimal handling: You can enter prices using either a period or a comma as the decimal separator (e.g., 19.99 or 19,99). Propono sanitizes and rounds the figure to your store’s configured decimal precision.
  • Taxes: The override price is treated in accordance with your WooCommerce tax settings (inclusive or exclusive of tax based on your store setup). The offer box shows it the way the cart line does, following your shop’s tax display setting, so the price on the offer is the price the cart charges.
  • Cart isolation: If a customer already has the same product in their shopping cart from browsing the catalog, only the specific copy added via the checkout bump receives the discount price. Only the product currently set as the bump gets it: after you switch the bump to another product, a line of the previous bump product still in a cart is charged its normal price.

To prevent accidental price leakage or duplicate item conflicts, Propono tags the added cart item with a private metadata flag:

$cart_item_data['_plogins_bump'] = true;

This private key ensures:

  1. Catalog independence: The bump item generates its own distinct cart hash. A shopper can buy one unit at regular price and another through the checkout bump without the two lines merging.
  2. Deterministic removal: When the shopper unchecks the box, Propono searches specifically for the cart item containing _plogins_bump and deletes only that item, leaving any manually added copies intact.
  3. Receipt cleanliness: The internal flag is strictly programmatic and is not displayed to the shopper in invoice emails or order summaries.

Propono validates the chosen product on every checkout page render:

  • If the selected product is moved to the trash, set to draft, or its price is deleted, the offer hides automatically.
  • If inventory tracking is enabled and the product drops to zero stock (! $product->is_in_stock()), the offer is omitted from the checkout.
  • On the admin settings screen, an invalid product remains selected but displays a warning notice: “Product is not currently purchasable on checkout”, preventing confusion.