=== Zelevation Custom Box Builder for WooCommerce ===
Contributors: zelevation
Tags: woocommerce, custom box, box builder, product bundle, subscriptions
Requires at least: 5.6
Tested up to: 7.0
Stable tag: 1.2.1
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Quiz-style custom product box builder for WooCommerce. Create step-by-step product bundles, gift sets, and subscription boxes with ease.

== Description ==

🚀 **[Live Demo](https://plugin-demo.zelevation.com/)**

Zelevation Custom Box Builder is a powerful WooCommerce extension designed to help store owners increase average order value (AOV) by allowing customers to build their own custom product boxes, gift sets, or cosmetic kits.

With a modern, responsive, quiz-style step-by-step layout, customers are guided through a sleek selection process. Perfect for cosmetics, gift boxes, meal kits, custom packs, and subscription boxes.

=== Features ===
* **Step-by-Step Box Builder:** Guide customers through selection steps (e.g. Step 1: Choose Cleanser, Step 2: Choose Makeup).
* **Flat Rate or Dynamic Pricing:** Charge a fixed price for the entire box or calculate the price dynamically based on selected items.
* **WooCommerce Subscriptions Compatibility:** Allow customers to subscribe to their custom boxes (requires WooCommerce Subscriptions).
* **Elegant Visual Sidebar:** Real-time visual slots matching selected items and real-time box price summary.
* **AJAX Add to Cart & Shipping:** Fast, seamless user experience without page reloads.
* **Fully Responsive:** Beautifully adapts to mobile, tablet, and desktop screens.
* **Custom Step Limits:** Set minimum and maximum selection constraints for each step.

✉️ **[Request Customization & Custom Development](https://zelevation.com/contact/)**

== Installation ==

1. Upload the entire `zelevation-custom-box-builder-for-woocommerce` folder to the `/wp-content/plugins/` directory, or upload the ZIP file via **Plugins** -> **Add New** -> **Upload Plugin**.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Go to any WooCommerce Product page, select the **Custom Box Builder** tab, enable the builder, and configure your steps.

== Frequently Asked Questions ==

= Does this plugin work with variable products? =
Yes, WooCommerce Custom Box Builder fully supports variable products. If you select a variable product for a step, it will automatically list its individual variations as choices.

= Does it support WooCommerce Subscriptions? =
Yes! If you enable subscriptions, it integrates natively with the official WooCommerce Subscriptions extension.

= Can I use it with any WordPress theme? =
Yes, the plugin enqueues modern styles designed to work with all major themes (including Astra, Divi, OceanWP, and default WooCommerce themes).

== Screenshots ==

1. Quiz-style step-by-step custom box builder layout on the WooCommerce product page.
2. Real-time checkout sidebar showing selected products, pricing summary, and subscription options.
3. Admin panel under WooCommerce Product Data to easily configure custom steps and limits.

== Changelog ==

= 1.2.1 =
* Fix order line items detail page not showing selected product names (save selections directly as simple strings).
* Fix checkout subscription creation bypassing custom renewal frequency intervals by hooking into subscription creation lifecycle.

= 1.2.0 =
* Add Subscription Mode settings to allow store owners to choose between "Both (One-Time & Subscription)" or "Subscription Only".
* Enforce subscription-only selection on frontend by hiding the "One-Time Purchase" option.
* Enforce backend cart validation to secure subscription-only products.

= 1.1.1 =
* Convert status messages to floating fixed toast notifications to guarantee visibility at all screen scroll positions.
* Smooth entry slide-down animation for alerts.

= 1.1.0 =
* Add dynamic Global Box Capacity limit to enforce maximum total selected items across all steps combined.
* Prevent selections exceeding global box capacity on frontend with alert notice banner.
* Add server-side AJAX cart validation matching product capacity settings.

= 1.0.0 =
* Initial Release.
