=== BundleCraft ===
Contributors: technicalhimanshu
Tags: woocommerce, product bundles, combo offers, bundle builder, discounts
Requires at least: 5.8
Tested up to: 6.9
Stable tag: 1.2.0
Requires PHP: 7.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create unlimited product bundles or combo offers in WooCommerce with custom discounts, titles, and responsive layouts.

== Description ==

**BundleCraft** makes it easy for WooCommerce store owners to create unlimited product bundles or combo offers with complete flexibility.

Display bundles anywhere using simple shortcodes, customize titles and offer text, and apply discounts to increase sales — all without writing any code.

**Features:**

* Create unlimited product bundles.
* Add custom percentage discounts for bundles.
* Responsive grid display (desktop, tablet, mobile).
* Shortcode support to display bundles anywhere.
* Easy-to-use admin interface with flexible styling options.
* Works seamlessly with WooCommerce products and themes.
* Duplicate bundles quickly using row actions.
* Copy shortcode and Live Preview buttons for faster workflow.
* WooCommerce HPOS (High-Performance Order Storage) compatible.
* Secure AJAX-based add-to-cart flow with nonce validation.
* Improved frontend performance and reduced inline scripts.

**Professional Pricing Engine:**

* Automatic **sale-price aware bundle calculations** (uses sale price when available).
* Transparent **“You Save” pricing display** for customers.
* **Single-discount Model-A logic** prevents double discounts in cart.
* Locks bundle price inside WooCommerce cart totals for accuracy.
* Coupon protection for bundle items to avoid stacked discounts.
* Optimized pricing engine with lightweight caching for performance.

**Why use BundleCraft?**
Boost WooCommerce sales with attractive combo deals, upsells, and promotional bundles presented in a clean, professional, and trustworthy layout.

== Installation ==

1. Upload the plugin files to the `/wp-content/plugins/bundlecraft` directory, or install the plugin through the WordPress Plugins screen.
2. Activate the plugin through the **Plugins** screen in WordPress.
3. Create bundles from **BundleCraft → Add New Bundle**.
4. Use the shortcode `[bundle_craft id="123"]` to display bundles on any page or post.

== Frequently Asked Questions ==

= How do I display a bundle? =
Use the shortcode `[bundle_craft id="123"]` where `123` is the BundleCraft post ID.

= Does BundleCraft support WooCommerce sale prices? =
Yes. BundleCraft automatically uses the **sale price when available**, ensuring accurate bundle totals and honest savings.

= Will discounts apply twice in the cart? =
No. BundleCraft implements **Model-A single-discount logic**, preventing double discounts and locking the correct final bundle price.

= Will it work with my theme? =
Yes. BundleCraft is designed to work with any WooCommerce-compatible theme.

= Can I customize the layout or styles? =
Yes. The plugin includes responsive styling controls. Developers can also override styles from their theme if needed.

== Screenshots ==

1. Plugin installed and activated.
2. All Bundles list screen.
3. Add New Bundle editor.
4. Style & Settings panel.
5. Frontend bundle grid layout.
6. Discount badge and transparent savings display.

== Changelog ==

= 1.2.0 =

* **Security Enhancements**

  * Added secure nonce verification for frontend add-to-cart requests.
  * Strengthened WooCommerce session validation and product sanitization.
  * Improved server-side validation before modifying cart contents.
* **Frontend Improvements**

  * Replaced inline JavaScript with properly enqueued external scripts.
  * Added localized, translatable frontend messages.
  * Improved variation selection handling and error feedback.
* **Performance & Code Quality**

  * Optimized script loading only when shortcode is used.
  * Reduced unnecessary frontend processing.
  * General code cleanup and WordPress coding-standards improvements.
* **Compatibility**

  * Fully backward compatible with previous versions.
  * Tested with latest WordPress and WooCommerce environments.
* **Professional Pricing Engine**

  * Added automatic sale-price detection for bundle calculations.
  * Introduced transparent “You Save” bundle savings display.
  * Implemented Model-A single-discount logic to prevent double discounts.
  * Locked bundle pricing in WooCommerce cart totals for accuracy.
  * Blocked coupons from re-discounting bundle items.
  * Added internal pricing cache for improved performance.

= 1.1.9 =

* **Security & Stability Improvements**

  * Hardened AJAX request handling with improved validation.
  * Additional sanitization and escaping for admin actions.
  * Removed forbidden system files from the plugin package.
* **Maintenance Update**

  * Version consistency fixes.
  * No functional or UI changes.
  * Fully backward compatible and safe to update.

= 1.1.8 =

* **Security & Standards Compliance**

  * Fixed WordPress.org review issues with script enqueuing.
  * Removed inline JavaScript and CSS from PHP templates.
  * Properly enqueued all scripts using WordPress APIs.
  * Added nonce verification and security checks.
* **Performance Improvements**

  * Optimized admin script loading.
  * Cleaner output and reduced inline code.

= 1.1.7 =

* Code quality improvements.
* Improved admin usability and validation.

= 1.1.6 =

* Tested and verified compatibility with WordPress 6.9.
* Updated plugin compatibility headers.

= 1.1.5 =

* Refined JavaScript and CSS structure.
* Improved code organization.

= 1.1.4 =

* Inline shortcode, copy, and preview buttons.
* Smart duplication via row action.
* WooCommerce HPOS compatibility.

= 1.1.3 =

* WordPress.org compliance cleanup.
* Transparent background default.
* Improved admin settings structure.

= 1.1.2 =

* Responsive bundle grid improvements.
* Better alignment across devices.

= 1.1.1 =

* Minor bug fixes and performance improvements.

= 1.1.0 =

* Initial public release.

== Upgrade Notice ==

= 1.2.0 =
Major **pricing accuracy upgrade** with sale-price support, transparent savings, and secure single-discount cart logic.
**Recommended update for all users.**

= 1.1.9 =
Security and maintenance update. Safe to update.

= 1.1.8 =
Important compliance update fixing WordPress.org review issues.

= 1.1.4 =
Feature update with smart duplication, inline admin buttons, and WooCommerce HPOS compatibility.