Description
This plugin is an add-on for WooCommerce. It needs WooCommerce installed and active, and does nothing without it.
Shopproof Cart Recommendations looks at which products your customers buy together and shows the best matches in the cart, so shoppers find the filter for their kettle or the case for their phone before they check out.
It learns from your own store’s orders, on your own server. There is no account to create, no outside service, and no order data leaves your site.
What it does
- Learns from your orders. It finds products that the same customers buy, and ranks them for each product in your catalog. Training runs in the background (weekly by default, or daily), in small steps that don’t slow your store down. Your current recommendations stay live until the new ones are ready.
- Recommends in the cart. A compact strip of picks appears above the cart: the product picture, its name, its price and an Add button, in a row on desktops and stacked on phones. When a shopper adds one, the next best pick takes its place.
- Works in side carts too. It can also show a compact strip in mini carts and side carts.
- Fits your theme. The strip uses your theme’s fonts, colors and buttons, on light and dark themes alike. Set your own button color if you like, and the button text stays readable.
- Accessible. Every Add button says which product it adds, results are announced to screen readers, and keyboard focus stays in place when a pick is replaced. Tested against WCAG 2.2 AA.
- Handles new products. Products without order history yet get best sellers from the same brand, then the same category, then the whole store.
- Works with your cart. The classic cart, the WooCommerce Cart block and page builder carts are all supported. Place the strip automatically, at a WooCommerce cart hook, or with the
[shopproof_cart_recommendations]shortcode. - Shows what it earns. Views, adds, add rate, orders and revenue from recommended items, right in the admin.
- Offer prices if you want them. Show the normal WooCommerce price, a price from a custom field, or a percentage off, and optionally charge that price when a product is added from the strip.
- Supports HPOS. It works with WooCommerce’s High-Performance Order Storage and with the older order storage.
- Ready for developers. Filters and actions let you change the picks, the cards, the scoring and the placement, and add tabs to the settings screen.
External services
This plugin does not use any external service by default.
If you enter an External recommendations URL in the settings, the plugin downloads that file once a day (and when you click “Fetch from URL now”) to import recommendations you have trained elsewhere. The request is a plain GET to the address you entered. It sends no order or customer data. Like every request WordPress makes, it includes your site’s address in the User-Agent header. The service at that address is one you choose and run yourself, so its terms and privacy policy are your own or your provider’s. Clear the field to stop the requests.
Privacy
- Training reads paid orders from your own database. To tell customers apart while it counts which products they bought, it stores an MD5 hash of the billing email (or of the customer ID) with the product IDs in a temporary table. The table is emptied when the run ends and is deleted when you uninstall the plugin.
- The model itself only stores product IDs.
- The statistics count views, adds and orders per day. They contain no personal data.
- Items added from the strip are marked in the cart and on the order (hidden order item meta
_smcr_reco), so revenue from recommendations can be counted. - The plugin sets no cookies of its own. It uses the WooCommerce session that the cart already uses.
- Suggested text for your privacy policy is under Settings > Privacy > Policy Guide.
Screenshots




Installation
- Install and activate WooCommerce, if you haven’t already.
- In WordPress, go to Plugins > Add New, search for “Shopproof Cart Recommendations for WooCommerce”, then install and activate it.
- Go to WooCommerce > Cart Recommendations. The first training run starts by itself about a minute after activation. You can also click Train now.
- Add a product to your cart and open the cart page to see the recommendations.
Until the model has learned from enough orders, the strip shows best sellers instead (you can turn this off in the settings).
FAQ
-
Does it work without WooCommerce?
-
No. It is built only for WooCommerce stores and needs WooCommerce to be installed and active.
-
Does it send my data anywhere?
-
No. Training reads your orders inside your own database and saves the results there. The plugin only connects to another server if you enter an external recommendations URL yourself (see External services below).
-
How many orders does it need?
-
By default a pair of products needs at least 3 customers who bought both before it is recommended. Smaller stores can lower this under Model and training. Until then the best seller fallback fills the strip.
-
My store has a very large order history. Will training be slow?
-
Training reads orders in batches of 500 and works through them in the background with Action Scheduler, the task runner that comes with WooCommerce, so pages stay fast. By default it learns from the latest 20,000 paid orders. You can raise or lower this.
-
Can I train the model outside WordPress?
-
Yes. Produce a JSON file that maps each product ID to the IDs to recommend for it, for example
{"12": [34, 56], "34": [12]}, and either upload it under Manual import or enter its address as the external recommendations URL. The plugin then downloads it once a day. -
Where does the strip appear?
-
By default it is placed at the top of the cart. You can choose a WooCommerce cart hook instead, or use the
[shopproof_cart_recommendations]shortcode anywhere on the cart page. If your theme uses an unusual cart layout, enter the CSS selector of its cart container in the settings. -
Does it work with page caching?
-
Yes. The cart page is not cached by WooCommerce compatible caching plugins, and the side cart strip and the Add button fetch what they need fresh.
-
Is it accessible?
-
Yes. The strip is a labelled list with one link and one button per product. Every button says which product it adds, results are announced to screen readers, and keyboard focus stays on the strip when a pick is replaced. Each release is checked in a browser with axe-core against WCAG 2.2 AA on block and classic themes and on a phone screen.
Reviews
There are no reviews for this plugin.
Contributors & Developers
“Shopproof Cart Recommendations for WooCommerce” is open source software. The following people have contributed to this plugin.
ContributorsTranslate “Shopproof Cart Recommendations for WooCommerce” into your language.
Interested in development?
Browse the code, check out the SVN repository, or subscribe to the development log by RSS.
Changelog
1.0.0
- First release on WordPress.org: a model trained in the background from your own orders, best seller fallback for new products, cart and side cart placement, offer prices, statistics, HPOS support, and filters and actions for developers.
