=== PickPair - Product Bundles, Frequently Bought Together, Cart Upsell & Checkout Order Bump for WooCommerce ===
Contributors: ysinnovations
Donate link: https://ysplugins.com/pickpair/
Tags: product bundles, frequently bought together, woocommerce upsell, order bump, cross sell
Requires at least: 5.3
Tested up to: 7.1.4
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 2.0.4
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

WooCommerce product bundles, Frequently Bought Together, cart upsell, cross sell, and checkout order bump plugin with post-purchase offers.

== Description ==

**Increase your Average Order Value (AOV) with targeted product bundles, Frequently Bought Together recommendations, cart upsells, and one-click checkout order bumps.**

When shoppers buy a camera, a skincare cleanser, or a laptop from your store, they rarely browse your catalog a second time to hunt for the matching memory card, moisturizer, or protective sleeve. If you present those complementary items at the right moment in their buying journey, a single-item order turns into a multi-item purchase automatically.

**PickPair – Product Bundles, Frequently Bought Together, Cart Upsell & Checkout Order Bump for WooCommerce** is an all-in-one WooCommerce upsell and cross sell plugin. It lets you display Amazon-style **Frequently Bought Together** boxes, discounted **product bundles**, one-click **product add-ons**, add-to-cart popup offers, in-cart cross sells, **checkout order bumps**, and Thank You page **post-purchase upsell** coupons from one lightweight dashboard.

[Visit Official Website](https://ysplugins.com/pickpair/) | [Explore All Features](https://ysplugins.com/pickpair/features/) | [Pricing & Plans](https://ysplugins.com/pickpair/pricing/) | [Get Support](https://ysplugins.com/support/)

= ⚡ How PickPair Boosts WooCommerce Order Value in 4 Steps =

1. **Choose Your Offer Type:** Select a campaign for any stage of your store funnel—Product Bundles, Frequently Bought Together, Cart Upsell, Checkout Order Bump, or Next Order Coupon.
2. **Select Trigger & Recommended Products:** Pick which items or categories trigger the offer, choose the add-on products to recommend, and set your discount rules.
3. **Target the Right Shoppers:** Filter offers by cart subtotal, items in cart, customer role, login status, or past purchase history.
4. **Publish & Track Extra Revenue:** Launch your campaign in one click and monitor views, clicks, conversion rates, and exact extra sales in your built-in reports dashboard.

= 🌟 Core Capabilities of PickPair WooCommerce Upsell & Bundle Plugin =

- **WooCommerce Product Bundles & Kits:** Group two or more related products into a fixed package deal with a percentage discount, fixed amount off, or flat bundle price.
- **Amazon-Style Frequently Bought Together:** Show customizable checkbox recommendations on product pages with one-click AJAX cart additions and flexible discount targeting.
- **One-Click Checkout Order Bumps:** Add a high-converting order bump box right before payment on the WooCommerce checkout page.
- **In-Cart Upsells, Cross Sells & Add-to-Cart Popups:** Recommend matching accessories or upgrades inside the cart page, cart drawer, or via an instant popup when a shopper clicks "Add to Cart."
- **Product Add-ons & Cart Add-ons:** Offer one-click extras such as gift wrapping, extended warranties, rush processing, or custom engraving.
- **Free Shipping Progress Bar:** Motivate shoppers to add one more cross sell item to their cart by showing how close they are to unlocking free shipping.
- **Thank You Page Offers & Next Order Coupons:** Present post-purchase upsell deals on the order confirmation page and generate automatic discount coupons for the buyer's next order.
- **WooCommerce Cart & Checkout Blocks Ready:** Works seamlessly with both classic WooCommerce shortcodes and modern WooCommerce Cart and Checkout Gutenberg Blocks.
- **Built-In Conversion & Revenue Analytics:** Measure impressions, clicks, orders, and exact WooCommerce revenue generated by every product bundle and order bump.

= 🛍️ Full-Funnel Upsell, Cross Sell & Bundle Campaigns =

Guide shoppers from product discovery to repeat purchase by placing relevant offers at every step of your WooCommerce checkout funnel:

**1. Product Page: Frequently Bought Together, Product Bundles & Add-ons**

- **Frequently Bought Together Boxes:** Display an interactive recommendation widget on WooCommerce product pages where buyers can check or uncheck add-on items and add everything to their cart in one click without reloading the page.
- **Discounted Product Bundles:** Package complementary products together (such as a 3-step skincare kit or starter pack) at a flat bundle price, percentage discount, or fixed discount.
- **One-Click Product Page Add-ons:** Let customers attach optional upgrades—like gift packaging, assembly, or protection plans—right above the Add to Cart button.

**2. Add-to-Cart Action: Instant Cross Sell Popups**

- **Add-to-Cart Popup Upsells:** Trigger a clean, mobile-friendly popup the moment a shopper adds an item to their cart, suggesting a matching cross sell accessory or bundle upgrade while buying intent is highest.

**3. Cart Page & Cart Drawer: Cart Upsells, Add-ons & Free Shipping Bar**

- **Cart Upsell & Cross Sell Recommendations:** Display targeted product recommendations inside the WooCommerce cart based on the exact items and categories the buyer has selected.
- **Whole-Order Cart Add-ons:** Offer one-click order upgrades like priority handling, shipping insurance, or gift notes directly inside the cart.
- **Dynamic Free Shipping Bar:** Automatically calculate and display the remaining spend needed for free shipping so shoppers add another item before heading to checkout.

**4. Checkout Page: One-Click Checkout Order Bumps**

- **Checkout Order Bump Offers:** Place an impulse-friendly order bump widget right beside the payment section on your WooCommerce checkout page. Shoppers tick a single checkbox to add the offer to their order via AJAX without leaving checkout.

**5. Thank You Page: Post-Purchase Upsells & Next Order Coupons**

- **Thank You Page Post-Purchase Offers:** Display an exclusive offer on the order confirmation screen immediately after checkout is completed.
- **Automated Next Order Coupons:** Generate and display a personalized WooCommerce discount coupon on the Thank You page—complete with custom expiry dates, brand colors, and minimum spend conditions—to turn first-time buyers into repeat customers.

= 🧮 Smart Bundle Pricing, Stock Protection & Multi-Currency Controls =

Protect your profit margins and catalog inventory with store-grade pricing and stock rules:

- **Flexible Frequently Bought Together Discount Targeting:** Choose whether your bundle discount applies only to the main trigger product, only to the recommended add-on items, or to the entire bundle.
- **Sale Price vs. Regular Price Calculation:** Decide whether campaign discounts calculate from a product's regular WooCommerce price or its active sale price.
- **Out-of-Stock Bundle Protection:** Automatically prevent a product bundle from being purchased when any required item inside the bundle goes out of stock.
- **Automatic Self-Exclusion:** PickPair automatically excludes the product a shopper is currently viewing (or already has in their cart) from appearing as its own recommended add-on.
- **Multi-Currency Compatibility:** Works smoothly with supported WooCommerce multi-currency switcher plugins for international stores.

= 🎯 Precision Targeting & Display Rules for WooCommerce =

Show offers only to the shoppers most likely to convert using granular targeting conditions:

- **Product & Category Triggers:** Display specific product bundles, cart upsells, or order bumps based on the exact products or categories being viewed or held in the cart.
- **Cart Subtotal Conditions:** Trigger offers only when the WooCommerce cart total is above, below, or within a specific price range.
- **Customer Role & Login Targeting:** Tailor separate offers for guest visitors, logged-in buyers, wholesale user roles, or VIP members.
- **Past Purchase History Rules:** Recommend cross sells based on a customer's previous WooCommerce orders, or display a welcome bundle exclusively to first-time shoppers.
- **Customizable Widget Placement:** Select the exact hook position on your product, cart, and checkout pages so every widget blends cleanly with your WordPress theme.

= 📊 Revenue Attribution & Campaign Performance Reports =

Track the exact ROI of your WooCommerce upsell plugin right inside your WordPress admin dashboard:

- **Storewide Extra Revenue Tracking:** View total additional revenue, orders, and conversion lifts generated across all active campaigns.
- **Campaign-Level Breakdown:** Compare views, clicks, conversion rates, and revenue earned for individual product bundles, Frequently Bought Together boxes, cart upsells, and checkout order bumps.
- **Fast Search, Filtering & Sorting:** Filter your campaigns by status, offer type, or revenue performance, all while loading frontend scripts conditionally only on pages with active offers.

= Privacy =

PickPair uses your WooCommerce store's existing product, cart, and order data on your own server to determine which offers to show. Depending on the targeting rules you configure, the plugin checks the items in the cart, the cart subtotal, whether the visitor is logged in, and whether they have ordered before.

The internal reports screen records views, clicks, and conversions for your campaigns. When enabled, the Next Order Coupon feature creates a standard WooCommerce coupon code after an order is placed. No customer data is sold or transmitted to external servers.

== Installation ==

1. Log in to your WordPress admin dashboard and navigate to **Plugins > Add New**.
2. Search for **PickPair**, click **Install Now**, and click **Activate**.
3. Open **PickPair > Campaigns** from your left-hand WordPress menu and click to create a new campaign.
4. Select **Frequently Bought Together**, **Product Bundles**, **Cart Upsell**, or **Checkout Order Bump**, choose your trigger and recommended products, set your discount, and click **Publish**.
5. Visit **PickPair > Reports** anytime to monitor your campaign views, clicks, conversions, and extra WooCommerce revenue.

== Frequently Asked Questions ==

= How do I create Amazon-style Frequently Bought Together bundles in WooCommerce? =

Open **PickPair > Campaigns**, create a new **Frequently Bought Together** campaign, select your main trigger product, and pick the complementary products to recommend alongside it. You can offer them at regular price or apply a percentage, fixed, or flat discount. Shoppers can tick the items they want and add them all to the cart in one click.

= Can I apply Frequently Bought Together discounts only to the add-on items? =

Yes. PickPair lets you choose whether a Frequently Bought Together discount applies to the trigger product only, the recommended add-on products only, or both the trigger and add-on items.

= What is the difference between Product Bundles and Frequently Bought Together? =

**Product Bundles** package two or more items together as a combined deal (shoppers buy the complete set to unlock the bundle discount). **Frequently Bought Together** lets shoppers customize their purchase by checking or unchecking individual recommended add-on items before clicking "Add Selected to Cart." PickPair includes both campaign types.

= How do one-click checkout order bumps work in WooCommerce? =

When you create a **Checkout Order Bump** campaign, PickPair displays a compact offer box right on the WooCommerce checkout page before payment. Shoppers simply check a single box to add the recommended product, warranty, or service to their order via AJAX without leaving or refreshing the checkout page.

= Does PickPair support the new WooCommerce Cart and Checkout Gutenberg Blocks? =

Yes. PickPair is fully compatible with both classic WooCommerce `[woocommerce_cart]` and `[woocommerce_checkout]` shortcodes and the modern WooCommerce Cart and Checkout Blocks.

= Can I show cart upsells and cross sells based on cart value or past orders? =

Yes. Every campaign supports targeting rules based on specific products in the cart, product categories, minimum or maximum cart subtotals, user roles, login status, and customer purchase history.

= What happens if an item inside a WooCommerce product bundle goes out of stock? =

PickPair includes built-in stock protection that automatically prevents a product bundle from being purchased if any required product inside the bundle runs out of stock.

= Does this WooCommerce upsell plugin support multi-currency stores? =

Yes. PickPair supports multi-currency conversion plugins for WooCommerce and lets you choose whether campaign discounts calculate from a product's regular price or active sale price.

= Will PickPair slow down my WooCommerce storefront or checkout? =

No. PickPair loads its frontend scripts and styles only on pages where an active product bundle, upsell, or order bump campaign is running, and works smoothly with caching plugins like WP Rocket and LiteSpeed Cache.

== Screenshots ==

1. Revenue & Conversion Dashboard — Track total extra WooCommerce revenue, campaign conversions, and sales performance at a glance.
2. Frequently Bought Together Widget — Amazon-style product page bundle box with customizable checkboxes and one-click AJAX add to cart.
3. Campaign & Product Bundle Editor — Configure trigger products, recommended add-ons, discount targeting, and pricing rules in minutes.
4. Cart Upsell, Cross Sell & Free Shipping Bar — Recommend matching items in the cart while motivating buyers to unlock free shipping.
5. One-Click Checkout Order Bump — High-converting impulse offer placed right before payment on the WooCommerce checkout page.
6. Precision Targeting Rules — Filter who sees each upsell or bundle by product, category, cart subtotal, user role, and past orders.
7. Detailed Campaign Analytics Reports — Measure views, clicks, conversion rates, orders, and extra revenue for every offer.

== Changelog ==

= 2.0.4 - November 13, 2026 =
* New: Automated Product Affinity Engine — self-learning co-purchase algorithm that automatically pairs top frequently bought together products from completed orders.
* New: Real-time out-of-stock and visibility exclusion at render time, ensuring customers only see immediately purchasable items.

= 2.0.3 - November 5, 2026 =
* New: Advanced Targeting & Condition Engine with recursive Rule Groups, nested AND/OR condition logic, and Root Group Arbitration across campaigns.
* New: Cross-Page Anti-Cannibalization control to automatically suppress redundant checkout offers if a product has already been added to the cart during the customer session.
* New: Product Presentation controls for multi-item offers: choose between displaying all selected items or rotating 1 product at random with optional fallback pool support.
* New: CampaignOrchestrator service for centralized offer orchestration, session state evaluation, and anti-fatigue frequency management.
* Improved: Server-side ConditionEvaluator with comprehensive evaluation of customer lifetime spend, order history, cart totals, and user roles.

= 2.0.2 - October 30, 2026 =
* New: A/B testing support for campaigns to test variants and compare performance.
* New: High-performance bulk campaign operations via WordPress AJAX (bulk activate, pause, delete, and quick inline rename).

= 2.0.1 - October 17, 2026 =
* New: Interactive Widget Position Preview modal and trigger button for all campaign editors (Frequently Bought Together, Product Add-ons, Cart Upsell, Cart Add-ons, Checkout Upsell, Thank You Upsell, Next Order Coupon).
* Improved: Real-time automatic position preview reflection when selecting options from the position dropdown.
* Fixed: Order tracking and analytics recording reliability.

= 2.0.0 - October 9, 2026 =
* New: Completely redesigned admin user interface with a modern dashboard layout, collapsible sidebar, and breadcrumb navigation.
* New: Unified tabbed workflow (Product, Design, Behavior) across all campaign editors for faster offer configuration and live preview simulation.
* Improved: Product variation handling, custom attribute selection, and stock checks for Cart and Thank You Page upsell offers.
* Improved: Added impression view count limits and refined targeting behavior for Cart Upsell and Product Add-on campaigns.
* Improved: Modernized revenue analytics with interactive revenue trend charts, conversion breakdowns, and top performing categories.

= 1.1.3 September 23, 2026 =
* Fixed: Fixed Amount discounts now correctly subtract the discount from the product price across all campaign types.
* Fixed: Products already in the cart are no longer shown in the Upsell Popup.
* Fixed: Upsell Popup now triggers correctly when adding products from single product pages.
* Fixed: Lengthy product titles in the Cart Upsell widget now wrap cleanly without breaking the layout.
* Fixed: FBT bundle variation selections and total savings calculations.
* Improved: Live preview price calculations in all campaign editors now accurately match storefront pricing.

= 1.1.2 - September 10, 2026 =
* Feature: Added flexible discount targeting for Frequently Bought Together bundles—apply discounts to trigger products, add-on products, or both.
* Security: Fixed unauthorized bundle discount application and strengthened bundle product validation.
* Improvement: Hardened campaign validation rules across the plugin.

= 1.1.1 - September 4, 2026 =
- Feature: Added multi-currency support for compatible WooCommerce currency switcher plugins.
- Fix: Updated Product Add-on totals to use the active sale price for the main product while displaying regular prices in the original total.
- Fix: Standardized add-on discount calculations across sale price and regular price settings.

= 1.1.0 - August 28, 2026 =
* New: Next Order Coupon offer with a custom expiry date, colors, and conditions.

= 1.0.6 - August 20, 2026 =
* New: Cart Add-on and Product Add-on offers.
* Improved: Offers can now be shown based on a customer's past orders.

= 1.0.5 - August 13, 2026 =
* New: Pop-up offer shown when a product is added to the cart.

= 1.0.4 - August 7, 2026 =
* New: Special offer on the Thank You page after checkout.

= 1.0.3 - July 31, 2026 =
* New: Setting to choose sale price or regular price for offers.
* Improved: Offer prices now follow the selected price type.
* Improved: Updated plan feature management.

= 1.0.2 - July 24, 2026 =
* Fixed: A product could no longer be shown as its own add-on.
* Fixed: Product positions and product selection in the campaign editor.
* Fixed: Labels and styling for Product Add-ons, and dropdown and card display on the offer list page.
* Improved: Layout and styling across the editor pages.

= 1.0.1 - July 17, 2026 =
* New: Reports page with revenue, sales, and offer performance.
* New: PickPair icon in the admin menu.
* Improved: Search, filters, and sorting on the offer list page, with views and revenue shown for each offer.
* Improved: Rebuilt the admin area and sped up the admin dashboard.

= 1.0.0 - July 13, 2026 =
* First public release.
* Frequently Bought Together offers, Product Bundles, Product Page Add-ons, Cart Recommendations and Cart Upsells, and Checkout Recommendations.
* Rules and conditions: target by products, categories, cart total, customer type, and past orders.
* Campaign reports.
* Support for WooCommerce Cart & Checkout Blocks.
* No-reload cart updates and a mobile-friendly design.
* Stock checks for bundled products.

== Upgrade Notice ==

= 2.0.4 =
Upgrade to 2.0.4 for the Automated Product Affinity Engine (self-learning co-purchase bundles), advanced condition targeting, cross-page anti-cannibalization controls, and real-time stock protection.