Skip to content

About

Frequently bought together, cross-sells and post-purchase offers from embeddings and order history, with A/B tests, revenue attribution and DEV3 AI offer copy.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

DEV3 AI Recommendations & Upsells for WooCommerce

Frequently bought together, cross-sells, order bumps and post-purchase offers from your order history and DEV3 AI similarity, with A/B tests and revenue attribution.

Dashboard: attributed revenue, chart, placements and widgets

Features

DEV3 AI Recommendations & Upsells learns what your customers buy together from your own WooCommerce orders (HPOS-safe), adds semantic similarity from Google AI embeddings, and shows the right products in every place that sells: product pages, cart, checkout (classic and block), the thank-you page and order emails.

Engine

  • Co-purchase statistics with confidence and lift, updated on every paid, cancelled or refunded order; full rebuild as a background job.
  • Semantic similarity from product embeddings (optional), with category/tag similarity as the fallback.
  • 12 strategies: frequently bought together, similar, goes well with (hybrid), upsells, cross-sells, best sellers, trending, new, on sale, top rated, recently viewed, pinned.
  • Per-product pins, exclusions and "hide widgets"; in-stock, category and already-bought filters; blend weights.
  • Precomputed neighbour lists and a fragment cache: no AI call and no heavy query on page load.

Placements

  • Product page bundle box (checkboxes, live total, optional bundle discount), grid, list or carousel.
  • Cart widgets (classic and block) and order bumps in the classic checkout and the block checkout summary.
  • Thank-you page post-purchase offer with countdown: add to the existing order (offline payments) or express second checkout, with signed single-use tokens.
  • "You may also like" in WooCommerce customer emails.
  • Gutenberg block and [dev3ru_recommendations] shortcode.

Grow with data

  • A/B tests per widget (strategy, layout, copy, count, discount) with z-test significance and one-click winner.
  • Revenue attribution: widget adds, click-through window, order item source, counted when paid and reversed on refunds.
  • Dashboard with attributed revenue, CTR, add rate, revenue per 1,000 views, per placement and per widget.

DEV3 AI (optional, your own Google AI key)

  • Offer copy writer with alternative angles in your brand voice.
  • Complementary picks for products without order history (single product or background job), drafts you pin.
  • Bundle pitch and a performance insights report.
  • Every AI result is a draft you accept, edit or reject. The plugin is fully usable without AI.

Requirements

  • WordPress 6.0 or newer (tested up to 6.8)
  • PHP 7.4 or newer
  • WooCommerce 8.0 or newer (required)
  • Optional: your own Google AI API key (from Google AI Studio) to switch on the DEV3 AI features. The rest of the plugin works without one.

Installation

From the release zip

  1. Download dev3-ai-recommendations-for-woocommerce.zip from the latest release.
  2. In WordPress, go to Plugins → Add New → Upload Plugin, choose the zip and click Install Now.
  3. Click Activate.

Build from source

git clone https://github.com/dev3tech/dev3-ai-recommendations-for-woocommerce.git
cd dev3-ai-recommendations-for-woocommerce
composer install --no-dev
npm ci
npm run build

Then copy the dev3-ai-recommendations-for-woocommerce folder into wp-content/plugins/ and activate it.

Getting started

  1. Upload the zip in Plugins > Add New > Upload Plugin and activate (WooCommerce 8.0+ required).
  2. Open "DEV3 AI Recommendations & Upsells for WooCommerce" in the admin menu.
  3. Engine > Rebuild stats. Starter widgets are already active.
  4. Optional: API Config > add a Google AI API key, then Engine > Build index.

Full documentation: docs/index.html in the download package.

FAQ

Do I need an API key?

No. Order history, cross-sells, categories and popularity power every placement. The key adds semantic similarity and AI writing tools.

Does it work with the block checkout and HPOS?

Yes, both are declared compatible and tested.

Does the storefront call the AI?

Never. All AI runs in the admin or in background jobs.

Privacy

This plugin can send product data (names, descriptions, categories, prices) and aggregate widget statistics to Google AI when you use DEV3 AI features or build the similarity index. No customer data is sent. Storefront tracking stores anonymous daily counters and uses two first-party cookies (dev3ru_vid for A/B assignment, dev3ru_clk for click attribution).

Documentation

The full HTML guide (installation, settings, hooks and FAQ) is in docs/index.html. Open it in a browser after cloning or downloading the repository.

Changelog

1.0.0

  • Initial release.

Licence

Released under the GNU General Public License v2.0 or later (GPL-2.0-or-later). See LICENSE.

More from DEV3

About

Frequently bought together, cross-sells and post-purchase offers from embeddings and order history, with A/B tests, revenue attribution and DEV3 AI offer copy.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages