拼团插件-UCBK · 栈域
UCBK · 栈域

{{ tags.important.name }}拼团插件

{{ tag.name }}
优惠前：
已售{{ sales_count }}
原价:
已售{{ sales_count }}
{{ important_discount.small_badge }}
倒计时00分00秒
{{ important_discount.desc }}
{{ opt.name }}
{{ opt.view_mode === 'img' ? '列表' : '图片' }}
 {{ item.name }}
{{ item.name }}
{{ item.value }}
{{ item.name }}

子比拼团插件 — 为子比主题商城打造的拼团功能

子比拼团是一款专为子比主题 (Zibll 8.x) 开发的 WordPress 拼团插件，深度集成主题原生商城系统，让商品支持多人拼团购买。用户可以在商品页发起拼团或加入现有拼团，达到目标人数后即成团发货。

核心功能

  • 一键开团 / 加入拼团： 用户在商品页点击”立即拼团”即可发起拼团，也可通过分享链接加入他人发起的拼团。
  • 灵活的价格设置： 管理员可独立设置每个商品的拼团价，不受商品原价影响。
  • 自定义成团条件： 支持设置成团人数（2-100人）和拼团有效期（1-720小时），适配不同商品需求。
  • 多支付方式： 支持余额支付、积分支付、微信/支付宝等所有子比主题支持的支付方式。
  • 自动退款： 拼团超时未成团，余额和积分自动退回用户账户；第三方支付自动创建售后记录并通知管理员处理。
  • 倒计时机制： 拼团有效期从团长实际支付成功那一刻开始计算，确保公平合理。
  • 站内信与邮件通知： 成团或失败时自动发送站内消息和邮件通知所有参与者。
  • 用户中心集成： 订单列表自动标记拼团订单，新增”我的拼团”子页面，可在用户中心查看所有拼团记录。
  • 防刷机制： 同一用户同时只能参与一个进行中的拼团，已支付后不可再开新团或加入其他团。
  • 分享邀请： 每个拼团生成唯一链接（带加密令牌），团长可一键复制分享到微信、QQ等平台邀请好友参团。
  • 后台管理： 管理员可在后台查看所有拼团列表、管理拼团状态、手动处理过期拼团、清空测试数据。
  • 暗色模式适配： 拼团页面完整支持子比主题的暗色模式。

使用指南

插件上传到 plugins目录，main.min.js上传到 zibll/inc/functions/shop/assets/js ,因为插件调用了主题的支付，所以要替换这个文件，已适配最新的子比主题

一、后台配置

进入商品编辑页，在右侧边栏找到”拼团设置”面板：

  1. 启用拼团： 开启后该商品即支持拼团购买。
  2. 拼团价格： 设置每个参团者的实际支付金额（单位：元）。
  3. 成团人数： 设置需要多少人支付才算成团，默认 2 人，范围 2-100。
  4. 有效期： 设置拼团有效期（小时），从团长支付成功后开始计时，超时未成团将自动退款。

也可在 shop_product 菜单下进入”拼团管理“页面，集中查看和管理所有拼团记录。

二、用户操作流程

发起拼团

  1. 进入支持拼团的商品页面。原购买按钮区域会自动显示拼团信息：拼团价、已拼人数、倒计时等。
  2. 点击”立即拼团“按钮，弹出主题原生的确认订单弹窗（VShopConfirm）。
  3. 选择收货地址和支付方式，点击提交。
  4. 完成支付后，系统自动创建拼团并生成分享链接。
  5. 点击”邀请好友“按钮，复制拼团链接发送给好友。

参加拼团

  1. 通过好友分享的拼团链接进入拼团详情页。
  2. 点击”参加拼团“按钮，同样进入支付确认流程。
  3. 支付成功后自动加入该拼团。
  4. 当参团人数达到目标后，拼团状态变为”已成功”，商家开始发货。

注意： 用户在同一时间内只能参与一个进行中的拼团。如需参与新的拼团，需等待当前拼团结束（成团或失败）。

退款机制

拼团超时未成团时，系统会自动处理退款：

支付方式退款方式
余额支付自动退回用户余额账户
积分支付自动退回用户积分账户
微信 / 支付宝自动创建售后记录，发送邮件通知管理员，需人工处理退款

退款完成后，用户会收到站内消息和邮件通知，告知拼团失败及退款情况。

技术亮点

  • 深度集成子比原生系统： 完全复用主题的 VShopConfirm 支付弹窗、ZibPay 支付系统、ZibMsg 消息系统，无需额外支付接口。
  • “先支付再建团”设计： 用户点击”立即拼团”不会立即创建拼团记录，仅在团长完成支付后创建。避免大量无效拼团占用数据库。
  • 倒计时从支付时刻起算： 拼团有效期从团长实际付款成功开始计时，而不是从点击按钮时算起，保证公平。
  • 多层自愈机制： 支付成功钩子、页面加载兜底、前端轮询检测三重保障，确保极端情况下拼团数据不丢失。
  • 并发退款安全： 使用数据库原子锁防止同一拼团被重复退款。
  • 防枚举访问： 拼团链接带加密令牌，防止随意猜测 URL 访问他人拼团详情。
  • 自动化退款： 通过 WP-Cron 定时任务和页面加载惰性检查双通道处理过期拼团。

安装与要求

  • WordPress： 5.0 或以上
  • PHP： 7.4 或以上
  • 主题： 子比主题 (Zibll) 8.x

安装方式：在 WordPress 后台进入”插件 -> 安装插件 -> 上传插件”，上传插件 ZIP 包即可。激活后插件会自动创建所需数据表（zibll_group_buy 和 zibll_group_buy_members）。

常见问题

1. 插件是否支持虚拟商品？

支持。插件基于子比主题的 shop_product 商品类型，不限制实物或虚拟商品。

2. 如果团长支付后一直没人参团，后续会怎样？

拼团超过有效期后自动判断为失败，系统会对已支付的成员执行退款操作。团长会收到站内信和邮件通知。

3. 可以同时修改拼团价和商品原价吗？

可以。拼团价是独立设置的，不影响商品原价。未启用拼团时，商品按原价正常购买。

4. 为什么用户不能同时参与多个拼团？

这是防刷机制。同一用户同时只能参与一个进行中的拼团，防止恶意占位或囤积。拼团结后会自动释放，可参与新的拼团。

5. 微信/支付宝支付的退款会自动退回吗？

不会自动退回。余额和积分支持自动退款，但微信/支付宝等第三方支付需要管理员在支付平台后台手动操作退款。系统会创建售后记录并通过邮件提醒管理员。

更新日志

v1.1.0

  • 新增站内消息和邮件通知（成团 / 失败双重通知）
  • 新增用户锁定机制，防止同一用户同时参与多个拼团
  • 新增分享令牌机制，保护拼团详情页 URL 安全
  • 新增后台拼团管理页面（列表查看 / 手动处理过期 / 清空测试数据）
  • 新增用户中心拼团标签页和订单拼团标识
  • 新增并发退款安全锁和补偿重试机制
  • 优化倒计时逻辑（从支付时刻起算）
  • 修复订单中心 500 错误的兼容性问题

v1.0.0

  • 初始版本发布
  • 支持商品拼团购买
  • 支持余额和积分支付
  • 支持过期自动退款
  • 后台商品编辑页拼团设置

插件作者：小黑 (ucbk.cn) | 适用主题：子比主题 Zibll 8.x | 最低 PHP 7.4

推荐

在手机上浏览此页面