插件简介

RiPro-to-Zibll 是一个把 RiPro-V5 主题的业务数据迁移到子比主题的 WordPress 后台迁移插件，入口在后台「工具 → RiPro转子比」。

用户余额与会员、订单与购买关系、付费文章的价格与下载地址、推广佣金、下载记录、卡密等一次性搬过去。迁移完成后用户登录即可看到原有资产，之前买过的文章依然能正常查看和下载。

插件共 11 个模块，支持试运行（只统计不写库）、分批续跑（断点续传，大站不超时）、写入前快照备份与逐模块一键回滚。

插件截图

后台「工具 → RiPro转子比」，11 个模块可单独勾选、单独执行、单独回滚，每个模块实时显示进度与「处理 / 写入 / 跳过 / 失败」统计。下图为在真实站点上完成迁移后的实际界面：

为什么需要专门的迁移插件

两套主题对同一类数据的存法完全不同，不是改几个字段名就能搬过去，下面三个坑是手工搬运必定会踩的：

• meta 存放位置不同：子比把头像、收藏、签到明细、余额记录等一并塞在 zib_other_data 这一条序列化 meta 里。直接用 update_user_meta() 写成独立行，子比完全读不到，等于没迁。插件为此做了专门的适配层。
• 计价单位不同：RiPro 用站内币（另有汇率），子比用人民币。1000 金币原样搬过去就变成 1000 元。插件提供三种换算模式。
• 付费模式多对一：RiPro 一篇文章可同时开付费下载、付费视频、付费阅读，子比只能有一种 pay_type，必须按优先级取舍。

迁移范围

• 主题设置：会员名称、推广返佣比例、货币符号、余额与签到开关、SEO 三项
• 文章付费设置：价格、会员折扣价、购买权限、下载地址与提取码、资源属性、演示地址、销量、点赞
• 文章视频预览：视频封面与剧集，兼容 RiPro-V2 遗留的旧格式字段
• 正文短代码：rihide / ri-reply-hide / ri-login-hide / ri-video / ri-alerts / ri-buttons / ri-accordions
• 用户数据：余额或积分、余额明细、会员等级与有效期、推荐人、签到、封禁、第三方账号绑定、文章收藏
• 自定义头像：用户上传的头像，并自动校正 RiPro 的路径错位问题
• 订单记录：全部已支付订单，订单号保持不变，用户「已购买」的判断依赖此表
• 推广佣金：回填到订单行的推荐人、佣金金额与提现状态
• 下载记录：用户与文章两个维度的下载明细
• 卡密：充值卡与注册邀请码
• 工单：子比无工单系统，转为站内系统消息发给原提交人（默认关闭）

不迁移内容

以下内容两套主题结构差异过大，需要在子比后台重新设置，插件执行完会在日志里列出清单：

• 支付接口密钥、第三方登录密钥（用户的绑定关系会迁移，只需重填应用密钥）
• 会员套餐商品：RiPro 按「天数 + 价格」，子比按商品配置，需重新定价
• 首页、导航、页面模板等外观配置
• 签到历史明细：RiPro 只记录最后一次签到时间，历史无法还原
• 文章收藏数：RiPro 不按文章统计收藏数，迁移后计数从 0 开始（收藏列表本身完整）

使用说明

1. 完整备份数据库（必做，插件自带的回滚只覆盖它自己写入的部分）
2. 把 ripro-to-zibll 文件夹放入 wp-content/plugins 并在后台启用
3. 进入「工具 → RiPro转子比」，查看环境体检结果
4. 把主题切换到子比，访问一次后台，让子比建好自己的数据表
5. 保持「试运行」勾选，点「开始试运行」，核对各模块数量是否符合预期
6. 取消「试运行」，点「开始迁移」
7. 抽查：用户余额、会员到期时间、已购文章能否正常查看

注意事项

• 环境体检出现红色「阻断」项时不要执行迁移，最常见的原因是子比的数据表还没建好。
• 执行到一半超时或 502，把「每批处理条数」从 200 调到 50 再继续，进度是持久化的，会从断点往下跑。
• 重复点执行不会写重：用户和文章按迁移映射跳过，订单按订单号去重。
• 卡密单密码模式：RiPro 的充值卡只有一个兑换码，对应子比的「单密码模式」。迁移卡密后请到「主题设置 → 支付付费 → 余额」把它打开，否则兑换页面会要求同时输入卡号和密码，而迁移过来的卡没有卡号，永远匹配不上。
• 文章视频封面：子比的文章视频受主题选项「文章视频封面」控制，需在主题设置中开启后才会在内页显示。
• 付费视频只迁移勾选了「免费播放」的。未勾选的属于付费内容，写入视频封面会被任何人直接播放，插件一律跳过并在日志中列出文章 ID 供人工处理。

更新日志

1.3.0 2026年11月13日

• 新增自定义头像修复模块。除字段名不同外，实际站点上还存在 RiPro 自身的遗留问题：数据库里记的是 /wp-content/uploads/avatars/ 下的路径，而文件实际落在 /wp-content/avatars/ 下，直接按数据库路径搬会导致全站头像 404。新模块为每个路径生成候选列表并逐个校验，只写入磁盘上真实存在的文件，找不到的跳过并记入日志，不写死链。

1.2.0 2026年11月13日

• 视频迁移模块现在也解析 RiPro-V2 时期的旧字段 video_url。V5 改用了新的数组格式，自带的内部迁移每批只处理 1000 条且要手动反复点击，很多站点根本没跑完，这些文章在 RiPro-V5 下本来就不显示视频，属于休眠数据，本版一并补齐。
• 新旧字段同时存在时以新格式为准；解析规则与 RiPro 自带脚本一致，并额外兼容多种换行与空格。

1.1.0 2026年11月13日

• 新增文章视频预览迁移模块。修复 1.0.x 的视频漏迁：原先只在付费类型判定为「付费视频」时才搬视频，而实际站点上大量文章是「免费播放的视频 + 付费下载」的组合，两种情况叠加导致视频一条都迁不过去。
• 免费播放的视频本就不属于付费内容，正确归宿是子比的文章视频封面而非付费 meta，故以独立模块补齐。

1.0.1 2026年7月27日

• 修复卡密已使用状态写错，导致已兑换的卡迁移后可被二次兑换。
• 修复工单迁移的站内消息收件人格式错误，导致消息不出现在用户消息列表。
• 修复 WordPress 会吞掉反斜杠的问题，影响本地路径类下载地址与含转义字符的资源备注。
• 修复老订单支付金额为空时营收统计与佣金计算归零。
• 修复推广佣金在订单被跳过时整条丢失。
• 修复归集 meta 整桶回滚会误删用户迁移后产生的其它数据（影响最大的一项）。
• 健壮性：捕获 Throwable、用户模块不再全表扫描、前端增加无进展熔断、日志文件名加随机串。

1.0.0 2026年7月27日

• 首个版本，9 个迁移模块、试运行模式、分批处理与断点续跑、写入前备份与逐模块回滚、归集 meta 适配层、后台日志面板。

收费标准与获取方式

本插件为收费插件，涉及授权与版本更新，按社区规范在此说明收费与售后，不在本站设置付费阅读：

• 收费标准：￥49，一次购买可持续获取后续版本更新
• 收费方式：在官网商品页下单后自动发货，下载对应版本压缩包
• 售后服务：迁移过程中遇到问题可在本帖评论反馈，或通过下方 QQ 联系。涉及数据结构差异导致的漏迁，确认后在后续版本修复并免费更新

下载地址

获取方式：

https://www.zibll.top/forum-post/48538.html

反馈意见

有问题请直接在本帖评论反馈，涉及隐私信息的请私信我反馈。

特别着急的问题，加我 QQ 反馈：2510585358

同一插件只维护这一个帖子，后续版本更新会直接在本帖追加更新日志。