
=== WowRecommend - AI-Powered Product Recommendations for WooCommerce ===
Contributors: wpxpo
Tags: upsell, cross sell, product recommendations, woocommerce recommendations, bought together
Requires at least: 6.9
Tested up to: 7.1
Requires PHP: 7.4
Stable tag: 1.0.5
WC requires at least: 6.0
WC tested up to: 9.8
License: GPLv3
License URI: http://www.gnu.org/licenses/gpl-3.0.html

Create smart product recommendations for WooCommerce with AI rule builder, advanced filters, sorting, popup upsells, checkout order bumps, and more.
 
== Description ==

Turn every customer visit into higher-value orders with **WowRecommend**, an AI-powered WooCommerce product recommendation plugin built for smarter upsells, cross-sells, and personalized product suggestions.

Create smart recommendation rules with AI, utilize **32+ advanced filters**, control where products appear, and increase conversion with smart sorting and display conditions.

💪 Build recommendation rules with simple AI prompts
☑️ Recommend right products using advanced filters
🛒 Show recommendations, popup upsells, and checkout order bumps
📈 Track analytics driven from the recommendations

🔥[WowRecommend Pro](https://www.wpxpo.com/product/wowrecommend/) | 📃[Documentation](https://www.wpxpo.com/docs/wowrecommend/)

== AI-Powered Product Recommendations, Upsells & Cross-Sells for WooCommerce ==

[youtube https://www.youtube.com/watch?v=OWDb7n7gxjU]


WooCommerce gives you basic related product, upsell, and cross-sell options. But recommending the right products becomes difficult when your store has hundreds of items.

WowRecommend helps optimize this process. You can create **smarter product recommendations** based on your product catalog, customer behavior, sales performance, product relationships, and more – with the help of advanced filters, sorting, and AI-powered rules.

== Key Features: ==

* Create product recommendations faster using AI-powered rule creation.
* Choose from 32+ product, behavior, sales, and relationship-based filters.
* Build and preview recommendations with an interactive live rule builder.
* Show recommendations on product, shop, cart, checkout, and thank-you pages.
* Create personalized recommendations using customer browsing and purchase behavior.
* Recommend related products, upsells, cross-sells, best sellers, recently viewed products, and more.
* Create Frequently Bought Together recommendations based on real order data.
* Sort recommended products by popularity, conversion, rating, freshness, price, and more.
* Stack multiple sorting methods in priority order.
* Start quickly with premade recommendation templates.
* Customize product cards, layouts, buttons, columns, colors, and displayed elements.
* Schedule recommendations for specific dates or campaigns.
* Create targeted popup upsells for better engagement.
* Add one-click checkout order bumps.
* Track recommendation-driven orders and completed-order revenue.


== Create Product Recommendations More Efficiently ==

[youtube https://www.youtube.com/watch?v=rAai1rlZIwA]

WowRecommend makes setting up product recommendations faster with an [AI-powered rule builder](https://www.wpxpo.com/docs/wowrecommend/ai-rule-builder/). 

Instead of configuring every condition manually, describe the recommendation you want and let AI create the initial rule.

* **Use Your Preferred AI Provider**: Connect a supported AI provider through WordPress Connectors and use it inside WowRecommend for recommendation rule creation.
* **Plain-English Rule Creation**: Describe your recommendation requirements in plain English. For example: “Recommend best-selling products on the product page before the Add to Cart button.” WowRecommend uses AI to turn that request into a working recommendation rule. You can then review it – adjust filters or sorting, customize the design, and publish it.
* **Conversational Refinement**: Continue the conversation with AI to modify the rule. For example, ask AI to exclude out-of-stock products, change the placement, add another filter, or modify the sorting.


**You can also build recommendations manually without using AI.**

## 32+ Advanced Filters for Accurate Product Recommendations ##

WowRecommend includes [32+ recommendation filters](https://www.wpxpo.com/docs/wowrecommend/recommendation-filters/customer-behavior-filters/) so you are not limited to manually selecting a few related products. 

Combine filters to create recommendation strategies based on products, store performance, and buying behavior.

[Product Filters](https://www.wpxpo.com/docs/wowrecommend/recommendation-filters/product-filters/)

Recommend products based on your WooCommerce products’ catalog.
✔ Specific Products
✔ Product Categories
✔ Product Attributes
✔ Product Tags
✔ Brand
✔ Current Product’s Category
✔ Current Product’s Tag
✔ Current Product’s Attribute
✔ Product Price
✔ Stock Status
✔ Relative Price
✔ Newest Products

For example, you can recommend products from the same category, show accessories from a specific brand, or exclude out-of-stock products.

[Sales & Performance Filters](https://www.wpxpo.com/docs/wowrecommend/recommendation-filters/sales-performance-filters/)

Recommend products using actual store performance.

✔ Best-Selling Products
✔ High-Revenue Products
✔ Low-Selling Products
✔ High Conversion Products
✔ On Sale Products
✔ Featured Products
✔ High Click-through Products

You can use these filters to highlight proven sellers, push slow-moving inventory, or prioritize products that convert well.

[Customer Behavior Filters](https://www.wpxpo.com/docs/wowrecommend/recommendation-filters/customer-behavior-filters/)

Use customer activity to create more personalized WooCommerce product recommendations.

✔ Products Viewed
✔ Recently Viewed
✔ Frequently Viewed
✔ Added to Cart
✔ Removed from Cart
✔ Previously Purchased
✔ Customer Interest Categories
✔ Customer Interest Tags
✔ Customer Interest Attributes

Customer Interest recommendations use categories, tags, and attributes of products, so store owners can provide more relevant suggestions.

[Product Relationship Filters](https://www.wpxpo.com/docs/wowrecommend/recommendation-filters/product-relationship-filters/)

Create recommendations around your current promotions and product relationships.

✔ Related Products
✔ Upsell Products
✔ Cross-sell Products
✔ Bought Together Products

Bought TogetherFilter uses actual order relationships to identify products customers commonly purchase together.

== Live Product Recommendation Rule Builder ==

WowRecommend includes an interactive [live rule builder](https://www.wpxpo.com/docs/wowrecommend/live-preview/) where you can manage the recommendation logic, placement, sorting, content, and design while viewing the result live for your storefront.

This makes creating a recommendation easier as you don’t need to repeatedly save a rule, open the storefront, check the result, and return to the settings page.

== Show Product Recommendations Across Your WooCommerce Store ==

Different recommendations work better at different stages of the buying journey. WowRecommend lets you place recommendation sections across 16 locations covering major WooCommerce pages.


== Product Page ==

Show related products, alternatives, upgrades, matching accessories, and other recommendations while customers evaluate a product.

== Shop Page ==

Display best sellers, new arrivals, featured products, personalized recommendations, and other product suggestions while customers browse your store.

== Product Archive Pages ==

Add relevant recommendations to category and tag archive pages to help shoppers discover additional products within or around the collection they are browsing.

== Cart Page ==

Recommend complementary products and useful add-ons while customers review their cart.

== Checkout Page ==

Show carefully selected recommendations before customers complete their order.

== Thank You Page ==

Recommend complementary or follow-up products immediately after an order is placed.

== Smart Sorting for Recommended Products ==

WowRecommend provides multiple sorting options to control which recommended products customers see first.

✔ Popularity
✔ Conversion
✔ Freshness
✔ Price
✔ Rating
✔ Random
✔ Bought Together

You can also **stack sorting methods by priority.**

For example, if **Popularity is 1st and Rating is 2nd,** products are sorted by popularity first. When products have the same popularity, rating determines their order.


== Sequential Display Settings for Smarter Recommendations ==

Use [display settings](https://www.wpxpo.com/docs/wowrecommend/placement-display/display-conditions/) of WowRecommend to control how multiple recommendation widgets appear when they share the same placement. 

**Show Instantly** – Display the selected recommendation widget immediately without any restriction.

**Timed Rotation** – Show the specific recommendation after a selected time interval.

**Reload-Based Rotation** – Display the recommendation widget after a set number of page reloads.


== Premade WooCommerce Recommendation Templates ==

Start with ready-to-use recommendation strategies instead of building every rule from scratch.

**Upsell Products**

Recommend higher-value alternatives to encourage customers to upgrade their purchase.

**Cross-Sell Products**

Suggest complementary products that work well with what the customer is buying.

**Best Sellers**

Highlight popular products to increase sales faster.

**New Arrivals**

Show recently added products and give new inventory more visibility.

**On Sale Products**

Promote discounted products and bring more attention to active offers.

**Increase Sales**

Recommend relevant products designed to generate more product purchases.

**Increase AOV**

Suggest add-ons, complementary items, and upgrades to increase average order value.

**Clear Inventory**

Promote slower-moving products to help reduce excess inventory.


== Customize Styles and Designs for the Recommendations ==

WowRecommend gives you flexible design controls for the Recommendations without requiring custom code.

**Card Layouts**: Choose from multiple product card designs for a stylish look.

**Grid or Slider**: Display recommended products in a product grid or carousel.

**Responsive Columns**: Set different column counts for desktop, tablet, and mobile devices.

**Product Elements**: Show or hide the product image, title, price, rating, category, and Add to Cart button.

**Style Controls**: Customize color themes, border radius, layout padding, card styles, and other visual settings.

== Popup Upsells for WooCommerce ==

Create targeted [popup upsell](https://www.wpxpo.com/docs/wowrecommend/popup-upsells/) offers that appear at the right moment and encourage customers to add more products to their orders.

**Action-based and time-based triggers** – Show upsell popups based on customer actions or after a specific time delay.

**Flexible product targeting** – Recommend specific products, categories, or broader product groups.

== Checkout Order Bumps for WooCommerce ==

Add simple one-click offers directly to the WooCommerce checkout.

A [checkout order bump](https://www.wpxpo.com/docs/wowrecommend/checkout-order-bumps/) can present an additional product with an option such as:

**“Add Premium Packaging for $8”**

Customers can add the offer to their order without leaving the checkout.


== Revenue Analytics for the Recommendations ==

WowRecommend tracks recommendation performance so you can identify which rules and placements are generating revenue.

**Order attribution** – Identify which recommendation rules and placements generate orders.
**Revenue tracking** – Measure revenue from recommendation-driven purchases.

== Schedule Product Recommendations ==

Create recommendations for limited-time promotions, seasonal campaigns, launches, and other store events.

Set a start and end date so a recommendation automatically appears during the selected period.

== Get Started in 3 Simple Steps with WowRecommend ==

Set up your first product recommendation campaign in three simple steps:

* **Choose where to display recommendations** – Select the page and placement where you want to show recommended products.
* **Set recommendation rules** – Use AI or choose from 32+ filters to define which products should be recommended.
* **Customize and publish** – Adjust the sorting, design and display settings, then publish your recommendations to your store.


== Other Plugins by WPXPO ==

Thank you for considering WowRecommend. WPXPO offers more WooCommerce plugins for building, managing, and growing online stores.

➕ [**WowAddons 🔥 :**](https://wordpress.org/plugins/product-addons/) The ultimate product addons plugin with 25+ extra product options, custom fields, allowing you to sell customizable products and increase average order value.

🚚 [**WowShipping 🔥:**](https://wordpress.org/plugins/wow-table-rate-shipping/) The complete table rate shipping plugin for WooCommerce, featuring 30+ flexible conditions and integrations with popular carriers like UPS, USPS, DHL, Sendle, and more.

📄 [**WowInvoice 🔥:**](https://wordpress.org/plugins/wow-pdf-invoices-packing-slips/) A comprehensive PDF invoices & packing slips plugin for WooCommerce that automates documents like invoices, packing slips, and picklists. 

🧲 [**WowOptin:**](https://wordpress.org/plugins/optin/) The next-gen optin and popup builder plugin with Canva-like design flexibility and detailed audience targeting.

💝 [**WowStore:**](https://wordpress.org/plugins/product-blocks/) An all-in-one WooCommerce solution to create professional and conversion-focused eCommerce stores.

💸 [**WowRevenue:**](https://wordpress.org/plugins/revenue/) Collections of various WooCommerce discount campaigns to boost revenue by increasing the average order value.

📦 [**WholesaleX:**](https://wordpress.org/plugins/wholesalex/) A complete WooCommerce Wholesale solution with additional features like a bulk order form, dynamic pricing & discount rules.

💝 [**PostX:**](https://wordpress.org/plugins/ultimate-post/) The top plugin for creating news, magazine, or blog sites. With PostX, build professional websites in three easy steps, enjoying complete customization freedom.


= Author =
Developed by [WPXPO](https://www.wpxpo.com). [Contribute to WowRecommend on Bitbucket](https://bitbucket.org/wpstabon/wow-ai-product-recommendations/src/dev-org2/) and join the party.

= Source Code =
[Source Code](https://bitbucket.org/wpstabon/wow-ai-product-recommendations/src/dev-org2/)

== External services ==

Wow Ai Product Recommendations includes an optional AI rule generation feature for the WooCommerce admin area. This feature uses the WordPress 7 built-in AI client (`wp_ai_client_prompt`) to generate and refine product recommendation rules from natural-language instructions. 
Older WordPress version users cannot be able to use this feature

== WordPress Built-in AI Client ==

All AI requests are handled by WordPress's native `wp_ai_client_prompt` API, introduced in WordPress 7.0. The AI provider, model, and API credentials are configured centrally in WordPress Site Settings, not within this plugin.

When an authorized administrator uses the AI generate or AI chat tools inside the plugin, data is sent to the AI provider configured in WordPress. The transmitted data includes the administrator's prompt or follow-up message, the current recommendation page context (for example, product page, cart, or checkout), the rule schema used by the builder, available product taxonomy slugs and attribute term slugs needed to build valid rules, the current rule configuration, and recent AI chat history when the chat-based refinement tool is used.

When an administrator uses the AI feature, data is transmitted to the AI provider configured in WordPress Site Settings. This may include:

- User prompts and follow-up messages.
- Current recommendation page context.
- Rule schema information.
- Product taxonomy and attribute term slugs.
- Current rule configuration.
- Recent AI chat history used for refinement.

The plugin does not select or configure the AI provider. The site owner is responsible for configuring an AI provider through WordPress Site Settings.

Examples of supported providers and their policies:

**OpenAI**
Terms of Service: https://openai.com/policies/terms-of-use/
Privacy Policy: https://openai.com/policies/privacy-policy/

**Google Gemini**
Terms of Service: https://policies.google.com/terms
Privacy Policy: https://policies.google.com/privacy

**Anthropic Claude**
Terms of Service: https://www.anthropic.com/legal/consumer-terms
Privacy Policy: https://www.anthropic.com/legal/privacy


== Frequently Asked Questions ==

= What is WowRecommend? =

WowRecommend is an AI-powered product recommendation plugin for WooCommerce. It helps you create product recommendations using a powerful rule builder, 32+ filters, smart sorting, live previews, popup upsells, checkout order bumps, and revenue analytics.

= How can I create product recommendations with AI? =

WowRecommend uses your AI provider to power up recommendation rules. Set up your API key with WordPress connector and WowRecommend automatically uses the AI to create smart recommendations. 

= Do I need AI to use WowRecommend? =

No. AI helps you create recommendation rules faster, but it is not required. You can manually configure recommendation filters, sorting, placements, designs, and other settings using the live rule builder.

= Can WowRecommend create personalized product recommendations? =

Yes. WowRecommend includes behavior-based filters for recently viewed products, previous purchases, cart activity, customer interests, and other shopping behavior. These filters can be used to create recommendations that change based on individual customer activity.

= Can I create upsells and cross-sells with WowRecommend? =

Yes. You can create WooCommerce upsell and cross-sell recommendations using filters, premade templates, existing WooCommerce product relationships, or custom recommendation rules.

= Is WowRecommend suitable for large product catalogs? =

Yes. The plugin is especially useful when manually assigning related products, upsells, and cross-sells becomes difficult. Filters based on categories, tags, brands, attributes, stock, pricing, sales data, and customer behavior help recommendations adapt as your catalog changes.

== Screenshots ==

1. AI-Powered Rule Creation
2. Recommendation Filters
3. Smart Sorting
4. Live Rule Builder
5. Popup Upsell
6. Order Bump

== Changelog ==
= 1.0.5 – 27th August 2026 =
* New: Added a Quick Access video thumbnail preview on the Overview page.
* Enhance: Reloaded license activation state to refresh onboarding and Pro gating immediately after activation.
* Enhance: Improved color sanitization to support alpha channels in global styles.
* Fix: Prevented duplicate rendering of recommendations on the same page location.

= 1.0.4 – 23th August 2026 =
* New: Added an AI chat assistant to the rule builder for creating and refining recommendation rules with natural-language prompts.
* New: Added a live rule builder with real-time storefront preview for placement, sorting, content, and design changes.
* New: Added a guided onboarding tour to help new users set up their first recommendation faster.
* New: Added premade recommendation templates, including Upsell, Cross-Sell, Best Sellers, New Arrivals, On Sale, Increase AOV, and Clear Inventory.
* New: Added revenue analytics with order attribution for recommendations, popup upsells, and order bumps.
* New: Added global widget style management for consistent card, layout, and button styling across recommendations.
* Enhance: Improved analytics data cleanup with batched deletion and optimized database indexes to reduce server load.
* Enhance: Improved compatibility with popular WooCommerce themes for recommendation and cart display styles.
* Fix: Resolved caching edge cases affecting recommendation results after product or rule changes.
* Fix: Corrected cart condition and product-selection logic used by popup upsells and order bumps.
* Fix: Resolved an issue that could prevent the plugin from being deleted cleanly.

= 1.0.3 – 21th June 2026 =
* New: Redesigned AI Chat Modal with improved styles and chat bubble animations.
* New: Added preset cards for the rules builder and product recommendations.
* Enhance: Recommendation templates are now dynamically retrieved from the store instead of hardcoded.
* Enhance: Rules builder UI with improved layout, padding, grid structure, and icon consistency.
* Fix: Resolved page and location initialization in the recommendation context resolution function.

= 1.0.2 – 10th June 2026 =
* Fix: Improved input sanitization for cookie handling to comply with WordPress Coding Standards.
* Fix: Clarified AI feature behavior and ensured no feature restrictions or trialware-related concerns.
* Update: Minor documentation improvements for External Services section.

= 1.0.1 – 9th June 2026 =
* Fix: Issues stated by Plugin Reviewer.

= 1.0.0 – 8th June 2026 =
* New: Initial release.