=== Upsell Blast Lite — Upsell & Cross-Sell for WooCommerce ===
Contributors: salesgen
Tags: woocommerce, upsell, cross-sell, side cart, free shipping bar
Requires at least: 6.0
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
WC requires at least: 6.0
WC tested up to: 10.3
Stable tag: 1.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce upsell bundle, cart cross-sell, related products, and a slide-out side cart with free-shipping bar — raise average order value.

== Description ==

Upsell Blast adds an upsell bundle, cart cross-sell, related products, and a slide-out side cart with a free-shipping bar to any WooCommerce store — all from one settings page, no page builder, no external script, nothing to phone home.

* **Upsell bundle** on the product page, sourced straight from WooCommerce's own "Upsells" field (Product data → Linked Products) — check the boxes, add them all to cart in one click.
* **Slide-out side cart** with quantity controls, coupon apply/remove, and a free-shipping progress bar, so customers review their cart without leaving the page.
* **Related products** and **cart-page cross-sell**, sourced from WooCommerce's native "Related" and "Cross-sells" fields — nothing to pick per product.
* **Low-stock message** based on the product's real, current stock quantity.
* **Instant add to cart (optional).** Turn on AJAX add to cart for the product page and the side cart opens the moment a simple product is added — no page reload.
* **Dark-theme ready.** Independent background/text color controls for the bundle, related-products grid, and side cart, so the plugin matches a dark-themed store instead of fighting it.
* **Built for any theme.** Every part of the UI is scoped and !important-hardened against theme stylesheets, so it renders the same on Storefront, Flatsome, Astra, or a custom theme.

= Unlock more with Upsell Blast Pro =

Lite covers the core surfaces above. [Upsell Blast Pro](https://salesgen.io/upsell-blast-upsell-machine/) adds the rest of the merchandising toolkit:

* 4 upsell bundle layouts, plus automatic targeting by category, tag, or purchase history — no manual product picking required.
* Add-to-cart popup with Frequently Bought Together suggestions.
* Buy More, Save More tiered quantity pricing.
* Checkout Order Bump.
* Thank-you page cross-sell.
* Announcement bar.
* Sales popups and social proof.
* Automatic coupon after purchase.
* Bulk configuration by product category instead of one product at a time.
* Full per-element styling controls (titles, prices, buttons).

Upgrading keeps every setting — Lite and Pro read the same options, so nothing needs re-configuring.

== Installation ==

1. Upload the plugin to `/wp-content/plugins/upsell-blast-lite`, or install it from **Plugins → Add New** in wp-admin.
2. Activate **Upsell Blast Lite** through the Plugins screen. WooCommerce must already be installed and active.
3. Go to **Upsell Blast** in the wp-admin menu and enable whichever features you want (Upsell Bundle, Related Products, Cart Cross-Sell, Side Cart each have their own on/off switch).
4. For the upsell bundle and cart cross-sell, set each product's "Upsells" / "Cross-sells" fields under **Product data → Linked Products** — the plugin reads those directly, no separate product picker to maintain.

== Frequently Asked Questions ==

= Does this work with any WooCommerce theme? =
Yes. The side cart is added to the page independently of your theme; point "Open-cart CSS selector" in Settings at your theme's existing cart icon/link to open it from there.

= Why isn't the upsell bundle / related products / cross-sell showing up? =
Two things to check: the feature is enabled in Settings (each has its own on/off switch), and the product actually has the data these features read from. The upsell bundle needs at least one product added to that product's own "Upsells" field, and cart cross-sell needs "Cross-sells" — both under Product data → Linked Products. Related Products needs no per-product setup; it uses WooCommerce's own category/tag matching automatically.

= Does this work with the WooCommerce Cart and Checkout blocks? =
The side cart and the checkout process both work fine alongside the block-based Checkout. The one exception is Cart Cross-Sell's "Where to show it" position setting: if your Cart page itself was built with the WooCommerce Cart block instead of the classic cart, there's no classic hook for that position to attach to, and Settings will show a warning about it. Add a Shortcode block to that page with `[sgbl_cart_upsell]` instead — it renders regardless of how the page is built.

= How do I show the free-shipping progress bar? =
It renders inside the side cart, so enable Side Cart in Settings first, then turn on "Enable free-shipping progress bar" under the Side Cart → Free Shipping Bar sub-section and set your threshold.

= Does the upsell bundle work with variable products? =
Yes. A variable product in the bundle gets a "Select Options" picker right there in the box — choose a Size/Color/etc. and it's added along with everything else when "Add All To Cart" is clicked. A grouped product has no price or stock of its own to add to cart with, so WooCommerce doesn't consider it purchasable and it won't appear as an upsell at all, the same as everywhere else in the plugin. The optional AJAX add-to-cart setting (for the main product page form) only speeds up simple products either way; a variable product there still adds to cart normally with a page reload.

= How many products can each block show? =
All three are configurable in Settings — set "Max products shown" to any number (the upsell bundle shows up to that many of the products you've added to that product's "Upsells" field). Related Products and Cart Cross-Sell also have a "Products per row" setting controlling how many appear per row before wrapping to the next.

= Can I match the colors to my theme, including a dark-themed store? =
Yes. The upsell bundle, related/cart cross-sell grid, and side cart each have their own background and text color fields in Settings, independent of one another, plus one shared "Primary" accent color for buttons and prices across all three. Set a dark background with a light text color on any block to match a dark-themed store.

= Is there a premium version? =
Yes — [Upsell Blast Pro](https://salesgen.io/upsell-blast-upsell-machine/) adds automatic category/tag targeting, the add-to-cart popup, Buy More Save More, checkout Order Bump, Sales Popups, and more. See the "Upgrade to Pro" tab in Settings for the full comparison.

= Does upgrading to Pro keep my settings? =
Yes — Lite and Pro use the same option names, so activating Pro carries every setting over automatically.

= Does this plugin phone home or load any external script? =
No. Every asset ships inside the plugin itself. The only outbound link anywhere in the plugin is the "Upgrade to Pro" tab, which is plain text linking to salesgen.io — nothing is fetched from it.

== Screenshots ==

1. Upsell bundle on the product page
2. Slide-out side cart with the free-shipping bar
3. Cross-sell on the cart page
4. Settings page

== Changelog ==

= 1.0.4 =
* The upsell bundle now supports variable products — pick Size/Color/etc. right in the box with a "Select Options" picker, instead of that item being silently left out of "Add All To Cart".
* "Add All To Cart" now catches a variable item that's included but hasn't had its options chosen yet, instead of adding everything else and leaving it out with no explanation.

= 1.0.2 =
* Related Products and Cart Cross-Sell now have a "Products per row" setting, and fixed the grid so it actually respects it instead of an unstyled column count.
* "Max products shown" is no longer capped at 4 for Related Products, Cart Cross-Sell, or the upsell bundle (bundle gets its own new "Max products shown" setting too).
* Product names in the upsell bundle, related/cart cross-sell grid, and side cart now clamp to two lines for a tidier layout.
* Coding standards cleanup (prefixed local template variables) per WordPress.org Plugin Check feedback.

= 1.0.0 =
* Initial release: upsell bundle, related products, cart-page cross-sell, slide-out side cart (quantity controls, coupon apply/remove, free-shipping bar, low-stock message), optional AJAX add to cart, and dark-theme color controls.

== Upgrade Notice ==

= 1.0.4 =
Upsell bundle now handles variable products (Select Options picker) instead of silently dropping them from "Add All To Cart".

= 1.0.2 =
Related/Cart Cross-Sell grids and product-count limits are now fully configurable — review Settings after updating if you rely on the previous 4-item cap.

= 1.0.0 =
Initial release.
