Smart Recommendations 智能商品推荐引擎 WordPress 插件[更至v1.1.1]

WPC Smart Recommendations for WooCommerce：基于顾客行为的 WooCommerce 智能商品推荐引擎

WPC Smart Recommendations for WooCommerce 是一款面向 WooCommerce 商店的商品推荐插件。它不仅依赖商品分类生成「相关商品」，还结合顾客在店铺中的真实行为数据——如共同购买、同一会话浏览、长期浏览轨迹、愿望清单与商品对比记录——帮助商店在更合适的位置展示更可能转化的商品。

核心定位：用行为数据提升推荐相关性

这款插件的重点是为 WooCommerce 提供更智能的商品推荐逻辑，适合希望提升以下指标的店铺：

• 商品页的关联购买转化
• 购物车与结账页的加购机会
• 订单完成后的复购与回访
• 个性化推荐展示效果
• 推荐模块带来的点击、加购、购买与收入归因

插件启用后即可开始从店铺数据中学习，无需复杂初始化配置。其推荐引擎综合多种信号，而非仅按商品分类或手动指定商品进行展示。

主要功能：多算法推荐与多位置展示

推荐算法

WPC Smart Recommendations for WooCommerce 支持多种推荐逻辑：

• 共同购买分析：根据已完成订单识别经常被一起购买的商品，用于生成「购买此商品的顾客也购买了……」类推荐。
• 共同浏览分析：基于同一浏览会话内的商品浏览行为，发现仅靠订单数据不易识别的商品关联。
• 分类亲和回退机制：当商品缺少足够行为数据时，优先展示同分类中表现较好的商品，避免新商品页面没有可用推荐。
• 愿望清单推荐：在启用 WPC Smart Wishlist 时，可将愿望清单数据纳入推荐逻辑。
• 商品对比推荐：在启用 WPC Smart Compare 时，可将商品对比数据纳入推荐逻辑。
• 兴趣评分：通过每小时运行的后台聚合流程，将多种行为信号汇总为每个商品的兴趣分数，并用于推荐排序。
• Trending Now：通过时间衰减评分机制展示近期热度更高的商品，而非长期历史热门商品。

展示位置

插件支持在多个 WooCommerce 关键位置展示推荐商品：

• 商品详情页
• 购物车页
• 结账页
• 订单完成/感谢页
• 弹窗
• 邮件模板
• 小工具区域
• 通过短代码插入的任意位置

可用短代码包括：

• [wpcrc_trending]：用于展示 Trending Now 区块
• [wpcrc_order]：用于在自定义感谢页展示基于刚购买商品的推荐
• [wpcrc_order order_id="{{order_id}}"]：可用于 WooCommerce 邮件模板，在订单确认邮件中加入个性化推荐

布局与交互

插件提供 3 种推荐展示布局：

• Grid 网格布局：使用 WooCommerce 商品卡片，适合商品页、分类页或常规内容区域。
• Carousel/Slider 轮播布局：基于 CSS scroll-snap 实现横向滚动，不依赖 JavaScript 轮播库，支持移动端原生触摸滑动。
• Compact List 紧凑列表布局：适合侧边栏、弹窗等空间较小的位置。

Carousel/Slider 布局支持：

• 平滑 scroll-snap 对齐
• 上一项/下一项导航按钮，并在边界自动禁用
• 响应式断点适配
• 与 Grid 布局共用商品卡片模板，保持视觉一致

响应式显示规则包括：

• 桌面端（>1024px）：按后台设置显示 2–6 列
• 平板端（768–1024px）：最多显示 3 个商品卡片
• 移动端（480–768px）：显示 2 个商品卡片
• 小屏移动端（<480px）：约显示 1.4 个商品卡片，形成预览效果

适用场景：从浏览、加购到订单完成后的推荐

商品页推荐

插件可在商品详情页展示基于共同购买、共同浏览、同分类热销、愿望清单或对比行为生成的推荐商品。对于订单量较少的新店，也可以通过共同浏览和分类亲和逻辑补充推荐数据。

个性化”For You”弹窗

插件提供一个每个会话显示一次的个性化”For You”弹窗，根据访客浏览历史展示推荐商品。可配置项包括：

• 面向所有访客、仅登录用户、仅游客显示，或关闭
• 弹窗触发前的空闲等待秒数
• 自定义标题、副标题与图标/emoji
• 弹窗内使用 Grid、Carousel 或 List 布局
• 推荐商品数量与列数

Trending Now 热门趋势区块

Trending Now 区块适合用于首页、活动页或专题页面，突出当前阶段更受欢迎的商品。它通过时间衰减算法计算热度，使近期受关注的商品排名高于上月热门但近期热度下降的商品。 可配置内容包括：

• 商品数量
• 统计时间窗口
• Grid、Carousel 或 List 布局
• 自定义标题文本
• 通过 [wpcrc_trending] 插入到指定页面

购物车、结账与订单推荐

在购物车页，插件可根据当前购物车内所有商品生成推荐，并支持多个展示位置：

• 交叉销售商品之前
• 交叉销售商品之后
• 购物车表格下方
• 购物车合计之后

在结账页，可选择将推荐显示在：

• 订单审核区域之前或之后
• 顾客信息区域之前或之后

在订单完成页，可使用 [wpcrc_order] 展示基于本次已购买商品生成的推荐，适合用于感谢页、订单确认页或自定义售后引导页面。 在订单邮件中，可将 [wpcrc_order order_id="{{order_id}}"] 加入 WooCommerce 邮件模板，在订单确认邮件里展示个性化商品推荐。

规则引擎配置

WPC Smart Recommendations 提供了一套基于规则的精细化推荐控制系统，支持通过多维度条件匹配实现商品推荐权重的动态调整。

支持的匹配条件

规则系统可依据以下产品属性进行条件判断：产品年龄、价格、库存数量、是否促销、是否精选、所属分类、标签以及产品类型。

条件运算符

每个条件支持多种比较方式：小于、大于、等于、不等于、包含、不包含。

可执行操作

当条件匹配时，系统可执行三类操作：Boost %（提升权重百分比）、Penalize %（降低权重百分比）、Exclude（直接排除）。

规则优先级

规则按拖拽排序的顺序评估，首次匹配即生效。每个规则配有独立开关，可随时启用或禁用而无需删除。

典型规则示例

短代码使用指南

所有短代码均支持 layout、columns、limit、title 四个通用属性，可灵活控制展示样式。

产品详情页推荐

[wpcrc_product] – 显示当前产品的关联推荐，可指定数量和布局。 [wpcrc_product limit=”8″ columns=”4″ layout=”grid”]

购物车推荐

[wpcrc_cart] – 基于购物车中所有商品生成推荐列表。 [wpcrc_cart limit=”4″ columns=”4″ layout=”carousel”]

订单推荐

[wpcrc_order] – 在订单确认页或邮件中展示订单相关推荐，系统自动检测当前订单 ID，也支持手动传入 order_id 参数。 [wpcrc_order] [wpcrc_order order_id=”123″ limit=”6″ layout=”list”]

热门趋势推荐

[wpcrc_trending] – 基于时间衰减算法展示当前热销产品。 [wpcrc_trending limit=”8″ columns=”4″ layout=”carousel”]

个性化推荐

[wpcrc_for_you] – 根据当前登录用户的浏览和购买历史提供个性化推荐。 [wpcrc_for_you limit=”6″ columns=”3″ layout=”grid” title=”为您精选”]

最近浏览记录

[wpcrc_recent_viewed] – 展示用户本地存储（localStorage）中的最近浏览产品。 [wpcrc_recent_viewed limit=”6″ columns=”4″ layout=”grid” title=”最近浏览”]

开发者接口（PHP API）

插件为主题开发者和自定义集成提供了完整的公共接口：

REST API

插件在 wpcrc/v1/ 路径下注册了 REST API 端点，适用于无头 WooCommerce 商店（Headless Store）的外部系统对接。

模板自定义

产品卡片模板支持主题覆盖，可按以下步骤自定义展示样式：

1. 将 wp-content/plugins/wpc-smart-recommendations/templates/content-product-grid.php 复制到主题目录 wp-content/themes/您的主题/wpcrc/content-product-grid.php
2. 根据需求修改模板文件
3. 系统自动优先加载主题目录中的自定义版本