=== Product Recommendations for WooCommerce – Upsells, Cross-sells, Related Products & Frequently Bought Together ===
Contributors: pluginshift
Tags: product recommendations, woocommerce upsell, cross-sell, related products, frequently bought together
Requires at least: 5.0
Tested up to: 7.0
Requires PHP: 7.4
WC requires at least: 5.0
WC tested up to: 9.5
Stable tag: 1.0.7
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html

The smartest product recommendations plugin for WooCommerce. Boost sales with upsells, cross-sells, related products & frequently bought together.

== Description ==

**Product Recommendations** is a powerful, data-driven recommendation engine for WooCommerce that helps you **sell more to every shopper**. Show the right product, to the right customer, at the right place — automatically.

Just like the recommendation engines that power the world's biggest stores, this plugin studies what your customers view and buy, then surfaces smart **product recommendations** across your store: **upsells, cross-sells, related products, frequently bought together, best sellers, recently viewed, new arrivals**, and more. The result is a higher **average order value**, better conversions, and a shopping experience your customers love.

Best of all, everything runs **locally on your own server**. No external cloud, no per-recommendation fees, no sharing your customer data with third parties. Your store's data stays yours.

= Why You'll Love Product Recommendations =

* **18+ recommendation engines** out of the box — from simple related products to AI-blended personalization.
* **Show recommendations anywhere** — product page, cart, checkout, shop, category, thank-you page, my account, and more.
* **Modern React-powered admin** — build widgets, campaigns, and popups with a fast, intuitive dashboard.
* **Built-in analytics** — track impressions, clicks, conversions, and revenue for every recommendation.
* **Privacy-first & local** — all tracking and data processing happens on your WordPress site.
* **Developer-friendly** — REST API, shortcodes, a Gutenberg block, Elementor widget, and dozens of hooks.


= Powerful Recommendation Engines =

Choose the strategy that fits each part of your store. Product Recommendations ships with engines across every major recommendation category:

**Behavioral & Collaborative**

* **Frequently Bought Together** — products customers commonly purchase together.
* **Customers Also Bought** — popular companion products from real orders.
* **Customers Also Viewed** — products browsed together in the same sessions.

**Personalized History**

* **Recently Viewed** — remind shoppers of products they just looked at.
* **Recently Purchased** — surface items a customer bought before.
* **Buy Again** — perfect for consumables and repeat purchases.

**Popularity Based**

* **Best Sellers** — your top-selling products by units sold.
* **Trending Products** — what's rising in views and sales right now.
* **New Arrivals** — showcase your latest catalog additions.
* **Seasonal Products** — timely, season-aware picks.

**Catalog & Taxonomy**

* **Related Products** — same category and tag matches.
* **Category Recommendations** — more from the same category.
* **Tag Recommendations** — products sharing the same tags.
* **Brand Recommendations** — more from the same brand.
* **Complete The Look** — curated items that go together.

**WooCommerce Native**

* **Upsells** — higher-value alternatives from your WooCommerce upsell lists.
* **Cross-sells** — complementary products from your WooCommerce cross-sell lists.
* **Bundles** — grouped product bundles.

**Manual & AI**

* **Custom Recommendations** — hand-pick exactly what to show.
* **AI Personalized** — a smart per-shopper blend of viewing history, co-purchases, related products, and best sellers.
* **Hybrid Recommendations** — combine multiple engines with tunable weights.

= Display Recommendations Everywhere =

Place recommendations exactly where they convert best. Product Recommendations integrates with WooCommerce on every key page:

✅ **Single Product Page** — above the title, below price, after add to cart, before tabs, or after related products.
✅ **Cart Page** — above the cart, below items, near totals, or below the cart.
✅ **Checkout Page** — before or after the order review and form.
✅ **Shop & Category Pages** — above, below, or around the product loop.
✅ **Thank You / Order Confirmation** — recommend a perfect follow-up purchase.
✅ **My Account Dashboard** — keep returning customers engaged.
✅ **Homepage** — feature top picks at the top of the page or before the footer.
✅ **Mini Cart** — suggest add-ons right inside the cart drawer.

= Modern React-Powered Admin =

Everything is managed from a fast, modern dashboard built with React:

✅ **Widget Builder** — pick an engine, layout, and display options, then drop it anywhere.
✅ **Campaign Manager** — run targeted recommendation campaigns with scheduling and rules.
✅ **Display Locations Manager** — assign widgets to page placements visually.
✅ **Popups Manager** — add-to-cart, exit-intent, checkout, time-delay, scroll, and cart-recovery popups.
✅ **Customer Segments** — target shoppers by purchase behavior, spend, location, device, and more.
✅ **Rules Builder** — show or hide recommendations using cart, customer, location, time, and context conditions.
✅ **A/B Testing** — test engines and layouts, track results, and declare a winner.
✅ **Analytics Dashboard** — impressions, clicks, conversions, CTR, conversion rate, and revenue over time.
✅ **AI Insights** — automatic suggestions and store-health scoring to improve performance.

= Flexible Layouts =

Match any theme with multiple display layouts:

* Grid (responsive, configurable columns)
* Carousel
* Slider
* List
* Bundle Box
* Floating Card
* Order Bump

Show or hide ratings, price, badges, quick view, and add-to-cart buttons per widget, and set your own custom heading.

= Built for Performance =

* **HPOS compatible** — fully supports WooCommerce High-Performance Order Storage.
* **Precomputed affinity matrix** — co-purchase data is calculated in the background, so the storefront stays fast.
* **Daily analytics rollups** — fast reports without scanning your order history.
* **Smart caching** — recommendation results are cached with a configurable TTL and support external object caches (Redis, Memcached).
* **Optimized for large catalogs.**

= Developer Friendly =

* **REST API** — every feature is available under `/wp-json/upsellsmart/v1/` for headless and custom builds.
* **Shortcode** — `[upsellsmart engine="related" count="5" columns="4" layout="grid"]`.
* **Gutenberg Block** — the `upsellsmart/recommendations` server-rendered block.
* **Elementor Widget** — drop recommendations into any Elementor layout.
* **Dozens of hooks & filters** — register custom engines, locations, weights, design tokens, capability checks, and more.
* **JSON import/export** — move widgets, campaigns, segments, rules, and A/B tests between sites.

= Privacy First =

Product Recommendations stores all behavioral data (product views, add-to-cart, purchases, impressions, and clicks) in your own WordPress database. No customer data is sent to any external service for core functionality, so you stay in full control of your store's data.

== Installation ==

= Minimum Requirements =

* WordPress 5.0 or greater
* WooCommerce 5.0 or greater
* PHP version 7.4 or greater

= Automatic Installation =

1. Log in to your WordPress dashboard and navigate to **Plugins > Add New**.
2. Search for **Product Recommendations**.
3. Click **Install Now**, then **Activate**.

= Manual Installation =

1. Download the plugin ZIP file.
2. Go to **Plugins > Add New > Upload Plugin** in your WordPress dashboard.
3. Choose the ZIP file and click **Install Now**.
4. Click **Activate Plugin**.

= Manual Installation via FTP =

1. Unzip the plugin file.
2. Upload the `upsellsmart-product-recommendations` folder to the `/wp-content/plugins/` directory.
3. Activate the plugin through the **Plugins** screen in WordPress.

After activation, open the **Product Recommendations** menu in your WordPress admin to build your first widget.

== Frequently Asked Questions ==

= Do I need WooCommerce to use this plugin? =

Yes. Product Recommendations is built for WooCommerce stores and requires WooCommerce 5.0 or higher to be installed and active.

= Where can I display product recommendations? =

Anywhere that matters — the single product page, cart, checkout, shop and category pages, the thank-you page, the my-account dashboard, the homepage, and the mini cart. You can also place them manually using the shortcode, the Gutenberg block, or the Elementor widget.

= What kinds of recommendations can I show? =

The plugin includes 18+ engines, including frequently bought together, related products, upsells, cross-sells, best sellers, recently viewed, new arrivals, trending products, brand recommendations, custom hand-picked products, and AI-personalized recommendations.

= Is my customer data sent to an external server? =

No. All behavioral tracking and recommendation processing happens locally on your own WordPress server. Your store's data stays with you.

= Is it compatible with WooCommerce HPOS (High-Performance Order Storage)? =

Yes. The plugin declares full compatibility with WooCommerce High-Performance Order Storage.

= Does it work with the block-based Cart and Checkout? =

Yes. Recommendations render correctly alongside the classic and block-based WooCommerce Cart and Checkout pages.

= Can I use a shortcode to show recommendations? =

Yes. Use `[upsellsmart engine="related" count="5" columns="4" layout="grid"]` and adjust the attributes to fit your needs. You can also use the `ids` attribute to display hand-picked products.

= Can I track how well my recommendations perform? =

Absolutely. The built-in analytics dashboard tracks impressions, clicks, conversions, click-through rate, conversion rate, and revenue for every widget and campaign — including A/B test results.

= Is the plugin translation ready? =

Yes. The plugin is fully translation ready and ships with the `upsellsmart-product-recommendations` text domain and a `/languages` folder.

== Screenshots ==

1. Dashboard – overview of recommendation performance and AI insights.
2. Widget Builder – choose an engine, layout, and display options.
3. Recommendations on the single product page.
4. Frequently Bought Together on the cart page.
5. Display Locations Manager – assign widgets to placements.
6. Campaign Manager – schedule and target recommendation campaigns.
7. Customer Segments builder.
8. Rules Builder – conditional display rules.
9. A/B Testing – compare variants and track results.
10. Analytics dashboard – impressions, clicks, conversions, and revenue.
11. Popups Manager – add-to-cart, exit-intent, and cart-recovery popups.

== Changelog ==

= 1.0.7 - 29/07/2026 =

* Added: Few minor bug fixes & improvements


= 1.0.5 - 24/06/2026 =

* Added: Initial public release.
* Added: Introduced 18+ recommendation engines, including Frequently Bought Together, Related Products, Upsells, Cross-sells, Best Sellers, Recently Viewed, New Arrivals, Trending, Brand, Custom, AI Personalized, and more.
* Added: React-powered admin interface with Widget Builder, Campaigns, Popups, Segments, Rules, A/B Testing, and Analytics.
* Added: Storefront placement support for Product, Cart, Checkout, Shop, Category, Thank You, My Account, Homepage, and Mini Cart pages.
* Added: Shortcode, Gutenberg Block, and Elementor Widget integration.
* Added: Privacy-first behavioral tracking with daily analytics rollups and precomputed product affinity.
* Added: Full compatibility with WooCommerce High-Performance Order Storage (HPOS).

= 1.0.4 - 14/05/2026 =

* Added: Initial public release of Product Recommendations for WooCommerce.

= 1.0.3 - 08/02/2026 =

* Added: Content-based recommendation engine
* Added: Association-based recommendation engine

= 1.0.1 - 02/02/2026 =

* Added: Initial release

== Upgrade Notice ==
