=== Magic Order Bump for WooCommerce ===
Contributors: magicsoft
Tags: woocommerce, order bump, checkout, upsell, cross-sell
Requires at least: 6.0
Tested up to: 6.9
Stable tag: 1.0.1
Requires PHP: 8.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Adds a beautiful, interactive order bump to the WooCommerce block checkout. One click adds a real product to the order.

== Description ==

Magic Order Bump lets you show a targeted product offer directly on the WooCommerce checkout page. The customer can add it to their order with a single click — no page reload, no cart disruption.

**How it works**

The bump appears below the order summary as an interactive checkbox. When the customer checks it, the product is silently added to their cart and the order total updates in real time. Unchecking it removes it just as cleanly.

**Features**

* Works with the WooCommerce Block Checkout (WC Blocks / Gutenberg)
* Real-time total update — no page reload
* Fully accessible: keyboard navigable, ARIA roles, screen-reader friendly
* Configurable accent color to match your brand
* Custom description or automatic fallback to the product short description
* Display conditions: minimum/maximum cart amount, logged-in vs guest users, required product category in cart
* Rate limiting on the AJAX toggle (20 requests/min per customer)
* Compatible with WooCommerce High-Performance Order Storage (HPOS)
* Clean uninstall — removes all options and transients on deletion

== Installation ==

1. Upload the `magic-order-bump-for-woocommerce` folder to the `/wp-content/plugins/` directory, or install it directly from **Plugins → Add New** in your WordPress dashboard.
2. Activate the plugin through the **Plugins** screen.
3. Go to **WooCommerce → Magic Order Bump** and configure the settings.
4. Enable the bump, choose a product, and save.

== Frequently Asked Questions ==

= Does this work with the classic WooCommerce checkout shortcode? =

The plugin is designed and tested for the WooCommerce Block Checkout (the default in WooCommerce 8.3+). It may not display correctly with the classic `[woocommerce_checkout]` shortcode.

= Can I show the bump only to specific customers? =

Yes. You can restrict visibility to logged-in users only, guests only, or everyone. You can also require a minimum or maximum cart amount, or require a specific product category to be present in the cart.

= Will the bump product appear as a separate line item in the order? =

Yes. The product is added as a real WooCommerce cart item and appears as its own line item in the order. It is also flagged with a hidden `_mobump_item` meta field for traceability.

= What happens if the bump product goes out of stock? =

The bump will automatically stop showing as soon as the product is out of stock or no longer purchasable. If a customer already has it in their cart and the product becomes unavailable before checkout, it will be silently removed.

= Does this plugin store any personal data? =

No personal data is stored. The plugin uses a WooCommerce session variable to remember whether the customer has added the bump product. This is cleared when the session expires.

== Screenshots ==

1. The order bump displayed below the checkout order summary.
2. The bump in its checked (added to cart) state.
3. The plugin settings page under WooCommerce → Magic Order Bump.

== Changelog ==

= 1.0.1 =
* Initial release.

== Upgrade Notice ==

= 1.0.1 =
Initial release.
