=== ShapedRecommend – Create Related Products, Upsells, Cross-Sells, and Product Recommendations for WooCommerce ===
Contributors: shapedplugin, rubel_miah, shamimmiashuhagh, khalilu
Tags: woocommerce, product recommendations, upsell, cross-sell, frequently bought together
Requires at least: 6.6
Tested up to: 7.1
Requires PHP: 7.4
Requires Plugins: woocommerce
Stable tag: 1.0.0
License: GPLv2 or later
License URI: https://www.gnu.org/licenses/gpl-2.0.html

Boost order value with related products, upsells, cross-sells and Frequently Bought Together on WooCommerce product, category, cart pages and more.

== Description ==

**ShapedRecommend** is a complete **WooCommerce product recommendations** plugin that shows the right product at every step of the shopping journey — **upsells**, **cross-sells**, **related products**, **Frequently Bought Together**, **bestsellers**, **trending now**, **top rated**, **new arrivals** and **recently viewed** products — on your product, shop, category, cart, checkout and thank-you pages.

Product recommendations are one of the simplest ways to **increase average order value (AOV)** in WooCommerce. Instead of the same fixed related products on every page, ShapedRecommend lets you decide exactly where a recommendation shows, which products it picks, how they are ranked, how the block looks and when it is allowed to appear — and preview it on desktop and mobile before it goes live.

## Why ShapedRecommend?

* **One plugin for every recommendation type** — related products, "You May Also Like", upsells, cross-sells, Frequently Bought Together, "Customers Also Bought", "Complete Your Order", cart upsells, best sellers, popular products, featured products, on-sale products and more.
* **Never recommends what shoppers can't buy.** In-stock, on-sale and price filters keep sold-out or off-brand products out of every block.
* **Set it once, it adapts to every product.** Each recommendation reads the product being viewed or the items in the cart, so one rule automatically shows relevant picks on every product page — no product-by-product setup.
* **Recommendation Manager** — no repeated products, block limits and session limits so offers never stack.
* **Built-in analytics** — views, clicks, conversions and revenue for every recommendation.
* **Fast and modern-store ready.** Scripts load only where a recommendation shows. Compatible with HPOS and WooCommerce Cart & Checkout blocks.

### Show On — Choose Where Recommendations Run

**Show On** sets the page type a recommendation belongs to. The recommendation always reasons from that page: the product being viewed, the category being browsed or the products in the cart.

* **Product** — recommend anything that fits the product being viewed: similar items, premium alternatives, add-ons, items customers buy together or your own hand-picked products.
* **Category** — showcase any mix of products on category and tag pages: popular, on-sale, featured, in-stock or your own curated picks.
* **Cart** — suggest whatever completes the order: add-ons, accessories, better alternatives or best sellers that pair with what is already in the cart.

**Start faster with ready-made recommendations** — Related Products, Up-sells (You May Also Like), Cross-sells and Frequently Bought Together. Pick one and edit every field afterwards.

### Position On Page — Place Recommendations Exactly Where They Convert

Drop each recommendation into the exact spot it converts, with no theme editing. Placements use native WooCommerce hooks, so they work with most themes.

* **Product page** — before product tabs, after product tabs, after the product summary.
* **Category / tag archives** — before products, after products.
* **Shop page** — before products, after products.
* **Cart page** — before the cart table, after cart totals, on the empty cart page.
* **Shortcode** — `[shapedrecommend id="…"]` anywhere in posts, pages or widgets.

### How Products Are Chosen — Rules

Set your own **Rules** — category, tags, price, stock and more — and ShapedRecommend automatically fetches the products that match them. Or pick products manually.

### Filters — Control Exactly Which Products Appear

Narrow every recommendation with filters. Combine as many as you need.

* **Category** and **Tag** — include or exclude.
* **On sale**, **In stock** and **Featured** products.
* **Price** — under, over or between two prices.
* **AND groups** — every rule in a group must match.

### Sorting — Rank the Best Products First

Sort rules decide which products appear first. Add more than one rule to break ties.

* **Frequently bought together** strength.
* **Popularity** — best sellers over a time window: 7, 14, 30 or 90 days, 6 or 12 months, or all time.
* **Price** — low to high or high to low.

### Pinned Products — Always Show Your Hero Items

Pin your own products to fixed positions — a new launch, a hero product or a high-margin item — and let the rules and sorting fill the rest of the block automatically.

### Analytics — See the Revenue Each Recommendation Earns

* **KPI tiles** — gross sales, net sales, items sold and orders.
* **Sales chart** with comparison to the previous period.
* **Per-recommendation table** — views, click-through rate, conversions and revenue.

### Recommendation Manager — No Stacked or Repeated Offers

When several recommendations can show on the same page, the Recommendation Manager keeps your store clean and fast.

* **No repeated products** — a product never appears in two blocks on one page.
* **Limit blocks per page** and **products per block**.
* **Limit recommendations per session** — avoid recommendation fatigue.

### Display Styles & Device Targeting — Grid, List and Carousel

* **Grid** — product cards in rows.
* **List** — compact rows, perfect for the cart.
* **Carousel** — a swipeable product slider with arrows.
* **Per-device columns** — set columns for desktop, tablet and mobile separately.
* **Device display rule** — turn on **Display Conditions** to show a recommendation only on desktop, tablet or mobile.

## Perfect For

* **Fashion and apparel stores** — "Complete the look" cross-sells and size-ready upsells.
* **Electronics and gadget stores** — accessories, chargers and cases as Frequently Bought Together.
* **Beauty and cosmetics** — routines and refills that customers buy together.
* **Grocery and food stores** — basket fillers and best sellers in the cart.
* **Home, furniture and decor** — matching items and premium alternatives.
* **Any WooCommerce store** that wants a higher average order value without more ad spend.


== Installation ==

= Minimum requirements =

* WordPress 6.6 or later
* WooCommerce 7.0 or later
* PHP 7.4 or later

= Automatic installation =

1. In your WordPress admin, go to **Plugins → Add New**.
2. Search for **ShapedRecommend**.
3. Click **Install Now**, then **Activate**.
4. Open **Recommend** in the admin menu and click **Create a Recommendation**.

= Manual installation =

1. Download the plugin zip file.
2. Go to **Plugins → Add New → Upload Plugin** and upload the zip.
3. Activate the plugin.
4. Open **Recommend** in the admin menu to create your first recommendation.

== Frequently Asked Questions ==

= Does it work with my theme? =

Yes. Recommendations are placed on standard WooCommerce hooks, so they work with most WooCommerce-compatible themes. For any other spot, use the shortcode or the Gutenberg block.

= Is Frequently Bought Together really free? =

Yes. Frequently Bought Together recommendations and sorting are fully included. Show them as a Grid, List or Carousel on the product page or in the cart.

= Will product recommendations actually increase my sales? =

Well-placed upsells, cross-sells and Frequently Bought Together suggestions help shoppers discover products they would otherwise miss, which raises average order value. The built-in analytics show the views, clicks, conversions and revenue of every recommendation so you can see the impact.

= Do I have to replace WooCommerce's built-in related products? =

No. You can run ShapedRecommend alongside the default related products, upsells and cross-sells, or place your recommendations in the same slots.

= Can I show recommendations on the cart page? =

Yes. Place recommendations before the cart table, after cart totals or on the empty cart page.

= How does the Recommendation Manager prevent too many offers? =

It removes products that already appear in another block on the page and limits how many blocks show per page, how many products each block shows and how many recommendations a shopper sees per session.

= Can I show a recommendation only on mobile? =

Yes. Turn on Display Conditions and add a Device condition.

= Can I place a recommendation anywhere? =

Yes. Every recommendation has a shortcode, `[shapedrecommend id="…"]`, and you can also add the "ShapedRecommend" block in the block editor.

= Will it slow down my store? =

Recommendations are resolved efficiently and scripts load only where a recommendation is shown.

= What data does the plugin store? Is it GDPR friendly? =

ShapedRecommend stores recommendation settings and anonymous view and click events on your own site to power analytics. It does not send store or customer data to third-party services. It integrates with the WordPress personal data export and erasure tools.

= What happens to my data if I delete the plugin? =

Your data is kept by default. If you want everything removed, turn on **Clean-up Data on Deletion** in **Recommend → Settings → Advanced** before deleting the plugin.


== Screenshots ==


== Source code and build ==

The JavaScript and CSS under `assets/build` are compiled. Their human-readable source ships with the plugin in `assets/src`, together with the build tools: `package.json`, `package-lock.json` and `webpack.config.js`.

To rebuild the compiled files, run these from the plugin folder with Node.js 18 or newer:

1. `npm ci`
2. `npm run build`

The build uses `@wordpress/scripts` and writes the three bundles — the admin app, the storefront script and the editor block — to `assets/build`.

== Changelog ==

= 1.0.0 =
* Initial release.

