=== NC Custom Product Bundles for WooCommerce ===
Contributors: Nayden4o
Tags: woocommerce, bundles, product bundles, csv import, csv export
Requires at least: 6.2
Tested up to: 6.9.4
Requires PHP: 8.1
Requires Plugins: woocommerce
Stable tag: 1.1.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create WooCommerce bundles with fixed or optional components, dynamic pricing, quantity rules, visual selection, and CSV import/export.

== Description ==

**NC Custom Product Bundles for WooCommerce** helps you sell kits, sets, packs, and grouped product combinations with a cleaner admin workflow and a more visual customer experience.

You can create a custom **Bundle** product type, choose whether the bundle is fixed or customer-selectable, define how pricing is calculated, and manage bundle settings in bulk using CSV files.

== Main Features ==

- Custom `Bundle` product type for WooCommerce.
- Dedicated `Bundle` tab inside WooCommerce product data.
- Optional bundles where customers choose the components they want.
- Fixed bundles with predefined included products.
- Pricing modes for fixed bundles:
- `Fixed price`
- `Sum of components`
- `Sum of components - percentage discount`
- Pricing modes for optional bundles:
- `Sum of selected components`
- `Quantity discount rules`
- Real-time price updates on the product page.
- Front-end cards for optional bundle components with image, title, price, and direct product link.
- Price range display before any optional component is selected.
- Discount progress messaging such as applied discount and next quantity threshold.
- Fixed bundle summary carousel showing included products.
- Bundle settings export/import by SKU through CSV.
- Translation-ready architecture with English language files included.

== Typical Use Cases ==

- Sell complete aero kits with all components included.
- Let customers build their own kit from a predefined list of parts.
- Apply discounts based on how many optional parts the customer selects.
- Maintain large bundle catalogs through CSV instead of editing products one by one.

== Demo Examples ==

= Optional bundle with sum pricing =
[Kit Tuning Volkswagen Golf Mk8 Facelift](https://taller-flash.es/producto/kit-tuning-volkswagen-golf-mk8-facelift)

= Optional bundle with sum pricing and minimum selection =
[Kit Tuning Volkswagen Tiguan R-Line Mk3](https://taller-flash.es/producto/kit-tuning-volkswagen-tiguan-r-line-mk3)

= Optional bundle with quantity rules =
[Kit Tuning Volkswagen Touareg R-Line Mk3 Facelift](https://taller-flash.es/producto/kit-tuning-volkswagen-touareg-r-line-mk3-facelift)

= Optional bundle with quantity rules and higher minimum selection =
[Kit Tuning Volkswagen Golf R Variant Mk8 Facelift](https://taller-flash.es/producto/kit-tuning-volkswagen-golf-r-variant-mk8-facelift)

= Fixed bundle with fixed price =
[Kit Tuning V.1 Volkswagen Golf R Hatchback Mk8 Facelift](https://taller-flash.es/producto/kit-tuning-v-1-volkswagen-golf-r-hatchback-mk8-facelift)

= Fixed bundle with sum of components =
[Kit Tuning V.2 Volkswagen Golf R Hatchback Mk8 Facelift](https://taller-flash.es/producto/kit-tuning-v-2-volkswagen-golf-r-hatchback-mk8-facelift)

= Fixed bundle with percentage discount pricing =
[Kit Tuning V.3 Volkswagen Golf R Hatchback Mk8 Facelift](https://taller-flash.es/producto/kit-tuning-v-3-volkswagen-golf-r-hatchback-mk8-facelift)

== Video Demo ==

[Watch the plugin video demo on YouTube](https://www.youtube.com/watch?v=8UuIKgSbdNs)

== CSV Import / Export ==

The plugin includes a **Products > Bundle CSV** screen for bulk management.

Exported/imported columns:

- `sku`
- `bundle_type`
- `pricing_mode`
- `component_skus`
- `min_select`
- `fixed_discount_percent`
- `optional_rules_json`
- `url`

Notes:

- `component_skus` uses `|` as separator.
- `optional_rules_json` stores quantity discount rules in JSON format.
- A downloadable CSV template is included in the admin screen to help users start quickly.

== Installation ==

1. Upload the plugin folder to `/wp-content/plugins/`.
2. Activate it from *Plugins > Installed Plugins*.
3. Create or edit a WooCommerce product and select **Bundle** as product type.
4. Open the **Bundle** tab inside product data.
5. Configure bundle type, pricing mode, components, discounts, and optional rules.

== Screenshots ==

1. Product editor with the dedicated `Bundle` tab for fixed bundles and percentage discount pricing.
2. Product editor with optional bundle quantity rules and minimum component selection.
3. Optional bundle front-end with price range before selection and product cards.
4. Optional bundle front-end with applied quantity discount and live price recalculation.
5. Fixed bundle front-end showing the included products summary carousel.
6. Bundle CSV admin screen for export, template download, and bulk import.

== Frequently Asked Questions ==

= Does it require WooCommerce? =
Yes. WooCommerce must be installed and active.

= Can I create fixed and optional bundles? =
Yes. The plugin supports both modes and exposes them in the Bundle tab of the product editor.

= Can I apply discounts based on selected quantity? =
Yes. Optional bundles can use quantity rules such as `1 = 0%`, `2 = 5%`, `3-4 = 10%`.

= Can customers open each component product directly from the bundle? =
Yes. Optional bundle cards can include direct product links in the front end.

= Can I manage bundles in bulk? =
Yes. Use *Products > Bundle CSV* to export existing bundle settings, download a template, or import bundle data by SKU.

= Is it translation ready? =
Yes. The plugin loads its own text domain and includes English language files. Additional languages can be added through `.po` and `.mo` files.

== Changelog ==

= 1.1.5 =
- Added front-end variation selection for variable products inside optional bundles.
- Improved optional bundle price recalculation when changing bundle variation selections.
- Clarified admin guidance for using concrete variations in fixed bundles.

= 1.1.4 =
- Fixed Bundle admin interactions and restored quantity-rule row controls.
- Improved Bundle editor layout in WooCommerce product data.

= 1.1.3 =
- Added CSV delimiter auto-detection for imports so templates using `;` or `,` work correctly.

= 1.1.2 =
- Dedicated Bundle tab in product data.
- Improved front-end optional bundle UI with product cards, images, and direct links.
- Live quantity-discount messaging and real-time price recalculation.
- Optional bundle price range shown before any selection is made.
- Fixed bundle included-products carousel.
- Bundle CSV import, export, and template download.
- Translation-ready improvements and English language files.

= 1.1.1 =
- WordPress.org listing fixes for readme, demos, screenshots, icon, and banner.

= 1.1.0 =
- Initial WordPress.org release.
