readme.txt

=== Bundle Builder for WooCommerce ===
Contributors: betatech, adnanshawkat
Tags: woocommerce, bundles, discounts, tiered pricing, analytics
Requires at least: 6.0
Tested up to: 6.9
Requires PHP: 7.4
Stable tag: 1.0.2
License: GPLv2 or later
License URI: http://www.gnu.org/licenses/gpl-2.0.html
WC requires at least: 7.0
WC tested up to: 9.4

Create customizable bundles with tiered discounts, advanced analytics, and reporting. Increase AOV with beautiful bundle builder.

== Description ==

**⚠️ IMPORTANT: This plugin requires WooCommerce to be installed and active.**

**Bundle Builder for WooCommerce** empowers you to create highly customizable product bundles with intelligent tiered discount promotions. Boost your average order value (AOV) by incentivizing customers to purchase more items with attractive quantity-based discounts.

Perfect for WooCommerce stores looking to increase sales through bundle deals, volume discounts, and mix-and-match promotions!

= 🎯 Key Features =

* **📊 Advanced Analytics Dashboard** - NEW! Comprehensive reporting and data visualization
  * Track coupon usage (created vs used vs unused)
  * Monitor bundle performance and popularity
  * View revenue trends over time
  * Analyze cart conversion rates
  * Calculate bundle order rates
  * Date filtering (Last 7 days, 30 days, This Month, Last Month, Quarter, Custom)
  * Beautiful charts powered by Chart.js
* **⚙️ Settings & Diagnostics** - NEW! Complete control and troubleshooting tools
  * Enable/disable debug logging to WooCommerce logs
  * System diagnostics page for troubleshooting
  * Database status checks
  * File permissions verification
* **Unlimited Bundles** - Create as many bundles as you need with custom names and descriptions
* **Tiered Discount System** - Set multiple quantity-based discount tiers (e.g., buy 2 get 10% off, buy 5 get 20% off)
* **Drag-and-Drop Product Ordering** - Visually reorder products with intuitive drag-and-drop interface
* **Dual Selection Modes**
  * **Selection Mode** - Customers choose products with checkboxes
  * **Quantity Mode** - Customers set quantities for each product
* **Variable Product Support** - Full support for WooCommerce variable products with variation dropdowns
* **Real-Time Calculations** - Live price updates and discount calculations as customers build bundles
* **Beautiful UI** - Modern, responsive interface with customizable colors and text
* **Mobile Optimized** - Includes sticky mobile cart footer for enhanced mobile shopping experience
* **Sidecart Integration** - Seamlessly integrates with popular sidecart plugins (FunnelKit, etc.)
* **Easy Shortcodes** - Display bundles anywhere with `[mmb_bundle id="X"]`
* **Design Customization**
  * Customize 5 color schemes (primary, accent, hover states, button text)
  * Customize button text and progress bar titles
  * Control visibility of all frontend elements
* **HPOS Compatible** - Fully compatible with WooCommerce High-Performance Order Storage
* **Translation Ready** - Includes POT file and 28 pre-configured language files
* **Developer Friendly** - Clean, modern code with comprehensive hooks and filters
* **WordPress Standards Compliant** - Passes Plugin Check requirements for WordPress.org

= 🌍 Supported Languages =

The plugin includes translation files for 28 languages:

**European Languages:** French, German, Spanish, Italian, Portuguese, Dutch, Polish, Swedish, Danish, Norwegian, Finnish, Greek, Romanian, Turkish

**American Languages:** Spanish (Mexico), Portuguese (Brazil), English (UK)

**Asian Languages:** Chinese (Simplified/Traditional), Japanese, Korean, Hindi, Arabic, Thai, Vietnamese, Indonesian, Malay, Filipino

= 💡 Perfect For =

* Build-your-own-box promotions
* Mix and match product bundles
* Volume discount campaigns
* Cross-selling related products
* Clearance sale bundles
* Gift box creators
* Sample pack builders
* Product variety packs
* Multi-buy offers
* Bundle and save promotions

= 🚀 How It Works =

1. **Create Bundle** - Navigate to Bundle Builder in WordPress admin
2. **Select Products** - Choose which products customers can bundle
3. **Reorder Products** - NEW! Drag and drop products to control display order on frontend
4. **Set Discount Tiers** - Configure quantity-based discounts (e.g., 2 items = 10% off, 3 items = 15% off)
5. **Customize Design** - Match colors to your brand and customize text
6. **Add to Page** - Use shortcode `[mmb_bundle id="X"]` on any page
7. **Customers Shop** - They select products, see real-time discounts, and add bundles to cart
8. **Automatic Discounts** - Discounts apply automatically at checkout

= 📱 Mobile Experience =

* Responsive design works perfectly on all devices
* Sticky mobile cart footer keeps bundle summary visible
* Touch-friendly interface optimized for mobile shopping
* Fast loading with optimized vanilla JavaScript

= 🎨 Design Customization =

* **5 Color Options** - Primary, Button Text, Accent, Hover Background, Hover Accent
* **Custom Text** - Modify all frontend text to match your brand voice
* **Visibility Controls** - Show/hide title, description, heading, hint, and progress text
* **Progress Display** - Beautiful tier progress with checkmarks showing unlocked discounts
* **Cart Behavior** - Choose between sidecart popup or cart page redirect

= 🔧 Technical Features =

* Clean, modern vanilla JavaScript (no jQuery dependencies)
* Professional CSS with variables for easy customization
* AJAX-powered for smooth user experience
* Nonce verification for security
* Sanitized inputs and escaped outputs
* WordPress coding standards compliant
* Extensive inline documentation
* Developer hooks and filters available

= 📊 Increase Your Revenue =

* **Higher AOV** - Customers buy more to unlock better discounts
* **Improved Conversion** - Bundle deals reduce decision fatigue
* **Cross-Selling** - Naturally promote complementary products
* **Customer Satisfaction** - Transparent savings build trust
* **Inventory Management** - Move products faster with bundles

== Installation ==

= Automatic Installation =

1. Log into your WordPress admin panel
2. Go to **Plugins** > **Add New**
3. Search for "Bundle Builder"
4. Click **Install Now** and then **Activate**
5. Navigate to **Bundle Builder** in the admin menu
6. Create your first bundle!

= Manual Installation =

1. Download the plugin ZIP file
2. Log into WordPress admin panel
3. Go to **Plugins** > **Add New** > **Upload Plugin**
4. Choose the ZIP file and click **Install Now**
5. Click **Activate Plugin**
6. Navigate to **Mix & Match** in the admin menu

= After Activation =

1. Go to **Bundle Builder** in your WordPress admin menu
2. Click **Add New Bundle** or create one inline
3. Enter bundle name and description
4. Search and select products to include
5. Add discount tiers (quantity and discount percentage)
6. Customize colors and text (optional)
7. Save the bundle
8. Copy the shortcode (e.g., `[mmb_bundle id="1"]`)
9. Paste shortcode on any page or post
10. Preview and test your bundle!

== Frequently Asked Questions ==

= Does this plugin require WooCommerce? =

Yes! This plugin is an extension for WooCommerce and will not work without it. WooCommerce must be installed and active before you can use Bundle Builder. If you try to activate the plugin without WooCommerce, you'll see an error message with a link to install WooCommerce.

= Does this work with variable products? =

Yes! The plugin fully supports WooCommerce variable products. Customers can select specific variations using dropdown menus before adding to their bundle.

= Can I create multiple bundles? =

Absolutely! Create unlimited bundles with different products, discount structures, and designs. Each bundle gets its own unique shortcode.

= How do I display a bundle on my site? =

Use the shortcode `[mmb_bundle id="X"]` where X is your bundle ID. You can find the shortcode with a copy button in the admin bundle list.

= Can I customize the appearance? =

Yes! Customize 5 color schemes, button text, progress bar title, and control which elements are visible. The plugin also uses CSS variables for advanced customization.

= Does the discount apply automatically? =

Yes! Discounts are calculated in real-time as customers select products and applied automatically when they add the bundle to their cart.

= Is this compatible with my theme? =

Yes! The plugin is designed to work with any properly coded WordPress theme. It uses standard WooCommerce styles and modern CSS practices.

= Will this work with my sidecart plugin? =

Yes! The plugin integrates with popular sidecart plugins like FunnelKit, WooCommerce Side Cart, and most theme-based sidecarts. You can also configure it to redirect to the cart page if preferred.

= Is it compatible with HPOS? =

Yes! The plugin fully supports WooCommerce High-Performance Order Storage (HPOS/Custom Order Tables) for better performance.

= Can I translate the plugin? =

Yes! The plugin is fully internationalized with 28 pre-configured language files. You can translate using Poedit, Loco Translate, or any gettext editor.

= Does it work on mobile devices? =

Yes! The plugin is fully responsive and includes a special sticky mobile cart footer for an optimal mobile shopping experience.

= How are discounts calculated? =

Discounts are based on the total quantity of items in the bundle. If you set a tier for 3 items at 15% off, customers get 15% off their entire bundle when they select 3 or more items.

= Can I use this with subscription products? =

The plugin works with simple and variable products. Subscription product support depends on your subscription plugin's cart integration.

= What happens if I deactivate the plugin? =

Bundles created with the plugin will no longer display, but your products remain unaffected. Bundle-related data is safely stored and restored if you reactivate.

= Can I control the order products appear on the frontend? =

Yes! NEW FEATURE: We've added an intuitive drag-and-drop interface. After selecting products, they appear in a "Selected Products" section where you can drag them up or down to reorder. Products will display on the frontend in exactly the order you set. This is perfect for featuring bestsellers first or arranging products strategically!

= Can I limit product quantities? =

Currently, customers can select any quantity in Quantity Mode. Selection Mode limits to one of each product. Quantity limits per product are on the roadmap.

= Is there a premium version? =

This is a full-featured plugin. We may release additional features based on user feedback. Follow us for updates!

== Screenshots ==

1. **Admin Bundle Editor** - Create and manage bundles with an intuitive interface
2. **Product Selection** - Easy search and select products with real-time filtering
3. **Discount Tiers** - Set up quantity-based discount tiers visually
4. **Design Customization** - Customize colors, text, and visibility options
5. **Frontend Bundle Display** - Beautiful, modern bundle interface for customers
6. **Product Grid** - Clean product cards with images, prices, and selection
7. **Bundle Summary** - Live bundle summary showing selected items and discounts
8. **Discount Progress** - Visual tier progress with checkmarks for unlocked discounts
9. **Mobile View** - Sticky mobile cart footer for enhanced mobile experience
10. **Shortcode Management** - Easy copy shortcodes from bundle list

== Changelog ==

= 1.0.2 - 2024-12-03 =
**🎉 Analytics, Settings & Enhanced Stability**

**NEW FEATURES**
* 📊 **Analytics Dashboard** - Comprehensive reporting with charts and graphs
  - Coupon usage tracking (created, used, unused, abandoned)
  - Bundle performance metrics and popularity rankings
  - Purchase analytics with revenue tracking
  - Cart conversion analytics
  - Bundle order rate calculations
  - Flexible date filtering (7 days, 30 days, monthly, quarterly, custom)
  - CSV export for all analytics data
  - Real-time Chart.js visualizations
  - Fully responsive design
* ⚙️ **Settings Page** - Control plugin behavior from one place
  - Enable/disable debug logging
  - Direct link to WooCommerce logs viewer
  - Logging status indicators
* 🔧 **Diagnostics Page** - Troubleshooting and system info

**BUG FIXES & IMPROVEMENTS**
* Fixed price calculation issues with product quantities in bundle totals
* Fixed 500 errors for logged-in users during cart operations
* Fixed coupon application for non-logged-in users
* Fixed variable product variations not being added to cart properly
* Fixed bundle coupon error messages appearing on non-bundle pages
* Fixed Chart.js loading issues in analytics dashboard
* Fixed console errors in admin.js when elements don't exist
* Improved session initialization for all user types
* Enhanced error handling and logging throughout the plugin
* Replaced error_log() calls with proper mmb_debug_log() function
* Improved null checks and element existence validation
  - Database table status checks
  - Required functions verification
  - File permissions checker
  - System information display

**IMPROVEMENTS**
* ✅ Enhanced session handling for logged-out users - bundles now work perfectly for guest checkout
* ✅ Optimized database queries with proper caching and prepared statements
* ✅ Improved analytics data accuracy for revenue and conversion tracking
* ✅ Better asset management with cache busting (no more stale CSS/JS)
* ✅ Scoped CSS to prevent conflicts with other admin pages
* ✅ Enhanced error handling throughout the plugin
* ✅ WordPress Coding Standards compliance (passes Plugin Check)
* ✅ Proper internationalization (i18n) implementation
* ✅ Integrated WooCommerce logger for better debugging

**BUG FIXES**
* 🐛 Fixed bundle addition not working for logged-out users
* 🐛 Fixed coupon application failing for guest checkout
* 🐛 Fixed analytics showing incorrect or missing data
* 🐛 Fixed JavaScript errors from missing DOM elements
* 🐛 Fixed PHP count() errors with null values
* 🐛 Fixed menu icons displaying incorrectly on non-plugin pages
* 🐛 Fixed CSS conflicts with WordPress admin dashboard
* 🐛 Fixed date range filters not applying correctly
* 🐛 Fixed revenue calculations showing $0 despite completed orders

**TECHNICAL**
* Updated minimum WordPress version to 6.0
* Updated minimum WooCommerce version to 7.0
* Tested with WordPress 6.7.1
* Tested with WooCommerce 9.4
* Enhanced security with proper nonce verification
* Improved code documentation
* Better error messages for debugging

= 1.0.1 - 2024-11-26 =
* Added native support for FunnelKit, WooCommerce default, and WooCommerce Blocks sidecarts
* Synced bundle discount markup into Woo fragments and AJAX payloads
* Removed development logging/debug helpers flagged by Plugin Check
* Updated translation template/files

= 1.0.0 - 2024-11-14 =
* 🎉 Initial release
* Bundle creation and management interface
* Unlimited bundles with products
* Tiered discount system
* Variable product support
* Real-time calculations
* Beautiful responsive design
* Mobile-optimized interface
* Sidecart integration
* Translation ready

== Upgrade Notice ==

= 1.0.2 =
Important update! New analytics dashboard with comprehensive reporting, settings page with logging controls, enhanced guest checkout support, and WordPress Coding Standards compliance. Fixes multiple bugs and improves performance. Database tables will update automatically. Clear cache after upgrade.

= 1.0.1 =
Sidecart integration improvements and bug fixes.

= 1.0.0 =
Initial release of Bundle Builder for WooCommerce. Create beautiful product bundles with tiered discounts today!

== Support ==

= Need Help? =

* **Documentation:** Visit [https://betatech.co/docs/bundle-builder](https://betatech.co/docs/bundle-builder)
* **Support Forum:** [https://betatech.co/support](https://betatech.co/support)
* **Email:** support@betatech.co
* **Response Time:** Within 24-48 hours on business days

= Feature Requests =

We love hearing from our users! If you have ideas for new features, please share them on our support forum.

= Report Bugs =

Found a bug? Please report it via:
* **GitHub Issues:** [https://github.com/ashawkat/mix-match-bundle-for-woocommerce](https://github.com/ashawkat/mix-match-bundle-for-woocommerce)
* **Support Forum:** [https://betatech.co/support](https://betatech.co/support)

== Privacy Policy ==

Bundle Builder for WooCommerce does not:
* Track users
* Collect personal data
* Use cookies
* Send data to external servers
* Store any information beyond WordPress database

All bundle and product data is stored locally in your WordPress database.

== Contributing ==

We welcome contributions! The plugin is developed on GitHub:
**Repository:** [https://github.com/ashawkat/mix-match-bundle-for-woocommerce](https://github.com/ashawkat/mix-match-bundle-for-woocommerce)

= How to Contribute =
* Submit bug reports and feature requests on GitHub Issues
* Submit pull requests for improvements
* Help translate the plugin
* Share the plugin with others
* Leave a review if you love it!

== Credits ==

= Development =
* **Betatech** - [https://betatech.co](https://betatech.co)
* **Adnan Shawkat** - Lead Developer

= Special Thanks =
* WooCommerce team for an amazing platform
* WordPress community for continuous inspiration
* All our beta testers and early users

= Translation Contributors =
Want to see your name here? Help us translate the plugin into your language!

---

**Building better eCommerce solutions, one plugin at a time.**