=== PickPair: Product Bundles, Upsells and Cross Sells for WooCommerce ===
Contributors: ysinnovations
Donate link: https://ysplugins.com/pickpair/
Tags: upsell, cross sell, product bundles, order bump, product recommendations
Requires at least: 5.3
Tested up to: 7.1.3
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 2.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Create product bundles, Frequently Bought Together offers, cart upsells, checkout order bumps and post purchase offers in WooCommerce.

== Description ==

PickPair helps WooCommerce store owners recommend complementary products and offer additional items throughout the shopping journey. Create product bundles, Frequently Bought Together offers, cart upsells, checkout order bumps, product add ons and post purchase offers from one plugin.

Choose the products you want to recommend, configure offer prices and discounts, set targeting conditions and control where offers appear in your store.

For example, recommend a phone case and charger alongside a mobile phone, suggest matching accessories in the cart, or offer gift wrapping before checkout. You can also display an additional offer after an order has been placed.

PickPair includes campaign reporting to help you review offer views, clicks, sales and additional revenue.

PickPair is available in free and Pro versions. Visit the [PickPair features page](https://ysplugins.com/pickpair/features/) and [pricing page](https://ysplugins.com/pickpair/pricing/) for details.

== Features ==

= Frequently Bought Together =

Display complementary products together on product pages. Customers can select the products they want and add them to the cart in one action. Choose which products appear together and configure bundle pricing where supported.

= Product Bundles =

Group products into a bundle and offer a percentage discount, a fixed amount discount or a single price for the complete bundle.

= Product Add Ons =

Offer optional extras for an individual product, such as accessories, gift wrapping or other items that complement the main purchase.

= Cart Add Ons =

Offer additional options for the cart, such as gift wrapping for the entire order.

= Cart Upsells and Cross Sells =

Recommend complementary products while customers review their cart. Use targeting conditions to control which offers appear and when they are displayed.

= Checkout Order Bumps =

Present an additional product or service during checkout so customers can add it to their order before completing payment.

= Pop Up Offers =

Display product offers when a customer adds an item to the cart. Recommend relevant products while the customer continues shopping.

= Post Purchase Offers =

Display an additional offer on the Thank You page after an order has been placed.

= Next Order Coupons =

Create a coupon for a customer's next purchase. Configure the expiry date and supported conditions to encourage repeat purchases.

= Offer Pricing and Discounts =

Configure percentage discounts, fixed amount discounts and bundle prices where supported. For Frequently Bought Together offers, choose whether a discount applies to the main products, additional products or both. Select regular price or sale price for supported offers.

= Targeting Conditions =

Control offer display using supported conditions for products, categories, cart totals, customer types, login status and previous orders. Configure the offer position on supported pages.

= Campaign Reports =

Review campaign performance, including offer views, clicks, sales and additional revenue.

= WooCommerce Compatibility =

PickPair supports classic WooCommerce cart and checkout pages and WooCommerce Cart and Checkout Blocks. It also includes support for supported multi currency plugins.

= Responsive Display =

Offer layouts are designed for mobile phones, tablets and desktop screens.

== How It Works ==

1. Open PickPair in your WordPress dashboard.
2. Create a campaign and select the offer type.
3. Choose the products you want to recommend.
4. Configure the offer price, discounts and targeting conditions.
5. Choose where the offer should appear and publish the campaign.
6. Review campaign performance in the reports section.

For a Frequently Bought Together offer, customers can select the recommended products and add them to the cart together. The final price depends on the selected products and the campaign settings.

== Example Use Cases ==

= Electronics Stores =

Recommend a phone case and charger with a mobile phone. Offer a suitable accessory or warranty during checkout.

= Clothing Stores =

Suggest a matching belt, bag or accessory when a customer adds a jacket to the cart.

= Beauty Stores =

Bundle complementary products, such as face wash and moisturiser, with a combined price or discount.

= Pet Stores =

Recommend treats or toys when a customer adds pet food to the cart.

= Online Course Stores =

Offer a workbook or additional learning material after a customer completes an order.

= Repeat Purchases =

Provide a coupon for a future purchase to encourage customers to return to your store.

== Installation ==

PickPair requires WooCommerce to be installed and active. Your WordPress and PHP versions must also meet the plugin requirements.

1. Log in to your WordPress dashboard.
2. Go to Plugins > Add New Plugin.
3. Search for PickPair.
4. Click Install Now and then Activate.
5. Open PickPair from the dashboard.
6. Create your first offer, configure its settings and publish it.

You can also install PickPair by uploading the plugin ZIP file. Go to Plugins > Add New Plugin > Upload Plugin, select the ZIP file and click Install Now. Activate the plugin after installation.

== Frequently Asked Questions ==

= Does PickPair require WooCommerce? =

Yes. PickPair is designed for WooCommerce and requires WooCommerce to be installed and active.

= Is PickPair free? =

PickPair has a free version and Pro plans. Visit the [pricing page](https://ysplugins.com/pickpair/pricing/) to compare available features.

= Can I create Frequently Bought Together offers? =

Yes. Select complementary products, display them together on product pages and allow customers to add their selected products to the cart in one action.

= Can I offer discounts on product bundles? =

Yes. Supported offers can use a percentage discount, a fixed amount discount or a single bundle price.

= Can I control which products appear in an offer? =

Yes. You can select products or categories and configure supported targeting conditions.

= Can I target customers based on previous orders? =

Yes. PickPair includes targeting conditions based on whether a customer has ordered before, along with other supported cart and customer conditions.

= Can I offer extras such as gift wrapping? =

Yes. Product Add Ons are used for extras associated with an individual product, while Cart Add Ons are used for extras associated with the cart. Checkout order bumps can present additional offers before payment.

= Can I display an offer after checkout? =

Yes. You can configure a post purchase offer to appear on the Thank You page after an order has been placed.

= Can I create a coupon for a customer's next purchase? =

Yes. The Next Order Coupon feature lets you configure a coupon with an expiry date and supported conditions.

= Can I track the performance of my offers? =

Yes. The reports page displays offer views, clicks, sales and additional revenue.

= Does PickPair support WooCommerce Cart and Checkout Blocks? =

Yes. PickPair supports classic WooCommerce cart and checkout pages as well as WooCommerce Cart and Checkout Blocks.

= Does PickPair support multi currency plugins? =

PickPair supports selected currency conversion plugins. Refer to the [features page](https://ysplugins.com/pickpair/features/) for compatibility details.

= Is PickPair compatible with caching plugins? =

PickPair is designed to work with caching plugins such as WP Rocket and LiteSpeed Cache. Test your store after configuring caching and offer display settings.

= Can I choose between regular and sale prices? =

Yes. PickPair includes a setting to select regular or sale prices for supported offers.

= Where can I get support? =

You can ask questions in the PickPair support forum on WordPress.org or visit the [PickPair website](https://ysplugins.com/pickpair/).

== Screenshots ==

1. PickPair dashboard with campaign statistics.
2. Frequently Bought Together offer on a product page.
3. Product bundle and add on settings.
4. Cart upsell offer and free shipping bar.
5. Checkout order bump.
6. Campaign targeting conditions.
7. Campaign reports showing offer performance.

== Privacy ==

PickPair uses WooCommerce store data to determine which offers to display. Depending on the conditions configured by the store administrator, the plugin may check cart contents, cart totals, customer login status and previous orders.

The campaign reports feature records offer views, clicks and sales. The Next Order Coupon feature creates a coupon for a customer's next purchase after an order is placed.

Store administrators are responsible for reviewing their site's data collection and processing practices, maintaining an appropriate privacy policy and complying with applicable privacy requirements.

== Upgrade Notice ==

= 2.0.0 =
Major release featuring a completely revamped admin dashboard and navigation, modernized tabbed campaign editors, improved product variation handling, and UI/UX performance optimizations.

= 1.1.3 =
Includes important fixes for fixed discount calculations across all offers, in-cart popup product filtering, and widget display improvements. Updating is recommended.

== Changelog ==

= 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 =
* New: Discount targeting option for Frequently Bought Together bundles. Apply discounts to trigger products, add-on products, or both.
* Security: Fixed unauthorized bundle discount application.
* Security: Improved bundle product validation.
* Improved: Hardened campaign validation.

= 1.1.1 - September 4, 2026 =
* New: Multi-currency support for supported currency conversion plugins.
* Fixed: Product add-on totals now use the current sale price for the main product and show regular prices in the original total.
* Fixed: Add-on discounts now calculate consistently with the selected sale or regular price setting.

= 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: Added Free and Pro plan features.

= 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.