Zerosoft Upsell Engine for WooCommerce

Zerosoft Upsell Engine for WooCommerce gives store owners two fully independent, fully free tools to show relevant products to shoppers:

1. Campaign Manager (rule-based)

Create manual upsell and cross-sell campaigns that target specific products, categories, or tags. Each campaign lets you hand-pick the recommended products and control exactly where and when they appear.

2. Smart Recommendations (automated)

A separate, standalone recommendation engine that automatically suggests products based on shared categories and tags. It runs independently from the Campaign Manager and is configured through its own dedicated settings page: WooCommerce -> Recommendation in the WordPress admin.

Both features are completely free and fully functional. There are no locked features, no upgrade prompts, and no premium tiers.

Campaign Manager Features

• Create upsell campaigns (suggest higher-value alternatives) and cross-sell campaigns (suggest complementary products)
• Trigger conditions: specific product, product category, or product tag
• Display on product pages and/or the cart page
• Choose the exact WooCommerce hook position for each page (e.g. after add-to-cart form, inside product summary, before/after cart totals)
• Set campaign priority to control display order when multiple campaigns match
• Enable or disable individual campaigns at any time
• Browse and add recommended products by name search or by category

Smart Recommendations Features

Smart Recommendations is a fully independent feature with its own admin settings page (WooCommerce -> Recommendation). It is not part of the Campaign Manager and is configured separately.

• Automatically suggests products based on shared product categories and tags
• Scored relevance algorithm: exact category matches rank higher than related or accessory categories
• Supports two recommendation sources: category-based and tag-based (either or both can be enabled)
• Two display layouts: grid and slider/carousel
• Configurable product limit (1-12 products)
• Enable or disable display on product pages and cart pages independently
• Configure the exact WooCommerce hook position for each page separately from campaign positions
• Results are cached for performance using WordPress transients

Where Recommendations Appear

Both the Campaign Manager and Smart Recommendations support the following display positions:

• Product page: After add-to-cart form (woocommerce_after_add_to_cart_form) or inside product summary (woocommerce_single_product_summary)
• Cart page: Before cart totals (woocommerce_before_cart_totals) or after cart totals (woocommerce_after_cart_totals)

Campaign widgets and Smart Recommendation widgets are rendered separately. If a campaign matches the current page, it is shown first. Smart Recommendations fill in automatically when no matching campaign exists, or alongside campaigns depending on hook position.

Theme Compatibility

All frontend widgets inherit the active WooCommerce theme’s colours, fonts, and button styles where possible. No external stylesheets or scripts from third-party CDNs are loaded.

Source Code & Build

The plugin source code is included in this package.

For admin assets:

• Build artifacts: admin-ui/build/admin-ui/index.js and admin-ui/build/admin-ui/index.css
• Build metadata: admin-ui/build/admin-ui/index.asset.php
• Build entrypoint/bootstrap file: admin-ui/admin-ui.php

For source visibility during review, matching source copies of the admin build assets are included in:

• admin-ui/src/admin-ui/index.js
• admin-ui/src/admin-ui/admin.css
• admin-ui/src/admin-ui/App.js
• admin-ui/src/admin-ui/api.js
• admin-ui/src/admin-ui/components/Campaigns.js

To rebuild the admin UI from source:

1. Install Node.js (18+) and npm.

2. From the admin-ui/ directory, run:

   npm ci
   npm run build

The build command is defined in admin-ui/package.json as:
wp-scripts build src/admin-ui/index.js –output-path=build/admin-ui

Third-Party Libraries

The bundled admin UI is built with the following direct third-party packages, all included under GPL-compatible licenses:

• @wordpress/i18n version 6.18.0 – License: GPL-2.0-or-later – Repository: https://github.com/WordPress/gutenberg/tree/trunk/packages/i18n
• @wordpress/scripts version 31.8.0 – License: GPL-2.0-or-later – Repository: https://github.com/WordPress/gutenberg/tree/trunk/packages/scripts

Inline admin/frontend behaviour has been moved to enqueued assets in:

• assets/css/upsell-smart-settings-admin.css
• assets/js/upsell-smart-settings-admin.js
• assets/js/upsell-frontend.js
• assets/js/widget-bootstrap.js
• assets/js/smart-recommendations.js

This plugin requires WooCommerce to be installed and active.