=== PickPair – Upsell, Cross Sell & Frequently Bought Together for WooCommerce ===

Contributors: ysinnovations
Tags: woocommerce upsell, frequently bought together, woocommerce cross sell, order bump, product bundles
Requires at least: 5.3
Tested up to: 7.0.4
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.5
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Boost AOV with upsell offers, Frequently Bought Together bundles, cart cross-sells, order bumps, and checkout recommendations for WooCommerce.

== Description ==

Boost your store's Average Order Value (AOV) with **PickPair** – the all-in-one upsell, cross sell, and Frequently Bought Together plugin for WooCommerce. 

PickPair is a complete revenue optimization and sales funnel suite designed to create high-converting WooCommerce product bundles, cart upsells, checkout order bumps, and product recommendations without slowing down your site.

Whether you want Amazon-style Frequently Bought Together bundles, dynamic free shipping progress bars, or seamless 1-click checkout order bumps, PickPair gives you total control over your WooCommerce sales strategy.

Fully compatible with Classic WooCommerce Templates as well as modern WooCommerce Cart & Checkout Blocks.

=== Key Features to Increase Average Order Value (AOV) ===

* **Frequently Bought Together (Amazon-Style):** Display complementary items on product pages with automatic bundle discounts and 1-click add to cart.
* **Smart Cart Upsell & Cross Sell:** Surface targeted offers inside the WooCommerce cart based on subtotal thresholds, cart items, or categories.
* **Checkout Offers & Order Bumps:** Present high-converting checkout upsells and order bumps (gift wrapping, extended warranties, priority dispatch) directly on the checkout screen.
* **Product Bundles & Add-ons:** Create custom product bundles, starter kits, and promotional sets with dynamic pricing rules for WooCommerce.
* **Cart Progress Bar (Free Shipping & Discounts):** Motivate customers to add extra items to their cart with dynamic subtotal progress trackers.
* **Targeted Conditional Rules:** Display product recommendations by cart value, specific product tags, customer roles, or login status.
* **Built-in Revenue Analytics:** Track impressions, click-through rates (CTR), conversions, and exact revenue generated by each campaign.

=== Real-World Store Examples & Campaign Ideas ===

PickPair adapts seamlessly across various WooCommerce store niches:

* **Electronics & Tech:** Offer a *Laptop + Wireless Mouse + Sleeve* as a Frequently Bought Together bundle, or add an *Extended 2-Year Warranty* as a checkout order bump.
* **Fashion & Apparel:** Trigger cross sell suggestions like *Belts, Socks, or Scarves* when a customer views an apparel item.
* **Beauty & Cosmetics:** Create product bundles like *Cleanser + Toner + Moisturizer* at a 15% promotional discount.
* **Home Decor & Furniture:** Offer optional *Assembly Services* or *Protective Coatings* as product add-ons directly above the Add-to-Cart button.
* **Sports & Fitness:** Display a cart progress bar encouraging buyers to *"Add $15 more to unlock Free Express Shipping!"*

=== Product Page Recommendations ===

Present high-converting upsell and cross sell offers for WooCommerce on your highest-intent conversion points:

* **Frequently Bought Together Widgets:** Automatically bundle main products with necessary accessories using percentage or fixed discounts.
* **Product Add-ons & Service Options:** Offer optional warranties, gift packaging, setup assistance, or priority handling directly on product pages.
* **Smart Related Displays:** Highlight best-sellers, recently viewed items, or manually curated complementary items.

=== Cart & Checkout Recommendations ===

Capture additional revenue at the final stages of the customer's journey:

* **Cart Subtotal Boosters:** Trigger targeted cart recommendations based on what is currently inside the customer's basket.
* **Checkout Block Recommendations:** Integrate frictionless checkout order bumps directly into native WooCommerce Checkout Blocks.
* **Dynamic Cart Rules:** Automatically adjust upsell recommendations based on total cart volume or item count.

=== Lightweight & Built for Speed ===

PickPair is engineered strictly adhering to WordPress standards:

* Non-blocking asset loading for lightning-fast page load times.
* Optimized SQL database queries engineered for high-traffic WooCommerce stores.
* 100% compatible with caching tools including WP Rocket, LiteSpeed Cache, Cloudflare, and major hosting environments.

== Installation ==

1. Go to **Plugins > Add New** in your WordPress dashboard.
2. Search for `PickPair`.
3. Click **Install Now** and then **Activate**.
4. Navigate to the **PickPair** menu in your WordPress sidebar.
5. Create your first Frequently Bought Together offer or Cart Upsell campaign!

== Frequently Asked Questions ==

= Does PickPair work with WooCommerce Cart & Checkout Blocks? =

Yes! PickPair natively supports both Classic WooCommerce templates and modern WooCommerce Cart & Checkout Blocks.

= Can I create different upsell campaigns for specific product categories? =

Yes. You can configure granular targeting rules based on individual products, specific categories, cart subtotals, customer roles, or cart item counts.

= How does Frequently Bought Together work? =

PickPair displays bundled product recommendations directly on product pages. Customers can select optional items and add the entire bundle to their cart with a single click.

= Can I offer percentage or fixed discounts on product bundles? =

Yes. PickPair lets you apply custom percentage discounts, fixed dollar discounts, or custom bundle pricing to incentivize larger purchases.

= Will PickPair slow down my WooCommerce store? =

No. PickPair is engineered specifically for speed, loading lightweight scripts and executing minimal queries only on active recommendation pages.

= Can I track how much revenue my upsell offers generate? =

Yes. PickPair features a built-in analytics dashboard displaying campaign views, clicks, conversions, and total revenue earned from upsell offers.

== Screenshots ==

1. PickPair main dashboard showing total upsell revenue, conversion rates, and campaign performance.

2. Frequently Bought Together widget layout on a WooCommerce product page.

3. Product Bundle and Add-on configuration settings in admin panel.

4. Cart Upsell offer and free shipping progress bar displayed in the shopping cart.

5. Checkout Recommendations integrated into WooCommerce Checkout Blocks.

6. Smart Rules Engine showing category, subtotal, and cart filters.

7. Built-in Analytics and Conversion Tracking overview.

== Changelog ==

= 1.0.5 August 13, 2026 =

* Added Upsell Popup feature.

= 1.0.4 August 7, 2026 =

* Added Thank you page Upsell.

= 1.0.3 July 31, 2026 =

* Added a new price type setting to choose between sale price and regular price.
* Updated product price retrieval to respect the selected price type across recommendations and campaigns.
* Introduced Free and PRO feature gating.

= 1.0.2 July 24, 2026 =

* Fixed: prevent adding a product as its own add-on and filter add-ons accordingly.
* Fixed: update product display positions and improve product selection handling in campaign editors.
* Fixed: update product add-ons label for clarity and adjust container style.
* Fixed: update trigger type to "all" across components for consistency.
* Fixed: adjust placement of the plugin configuration message on the Settings page.
* Fixed: dropdown overflow while editing on the listing page and card overflow issues.
* Updated: layout and styling for editor pages, including overflow handling.
* Updated: display location for bundles and upsells to "top" across components.

= 1.0.1 July 17, 2026 =

* Added a deactivation feedback survey on the Plugins screen.
* Added dashboard analytics REST API with revenue, conversion, and campaign performance stats.
* Improved campaign list API with pagination, search, multi-type filters, sorting, and status counts.
* Added per-campaign views and revenue stats in the admin campaign list.
* Added a custom PickPair admin menu icon.
* Improved admin asset loading with hashed bundle support and cache-busting.
* Rebuilt the React admin UI with dashboard, campaign pages, shared layout, and editor components.
* Expanded and clarified the WordPress.org plugin readme and FAQ content.

= 1.0.0 July 13, 2026 =

* Initial public release.
* Added Frequently Bought Together campaigns.
* Added Product Bundles.
* Added Product Page Add-ons.
* Added Cart Recommendations.
* Added Cart Upsells.
* Added Checkout Recommendations.
* Added Rules & Conditions.
* Added campaign targeting by products, categories, cart subtotal, customer roles, and previous orders.
* Added Campaign Analytics.
* Added WooCommerce Cart & Checkout Blocks support.
* Added AJAX-powered cart interactions.
* Added responsive frontend layouts.
* Added stock validation for bundled products.
* Added parent-child cart relationships.

== Upgrade Notice ==

= 1.0.5 =

Added New Campaign Upsell popup.