前言

子比主题原生自带的打赏功能，核心仅为展示微信、支付宝两款收款二维码，用户完成扫码转账后，作者既无法实时核实是否到账，也无法精准追溯打赏金额，这类纯靠信任的打赏模式，不仅让用户的打赏体验大打折扣，也给站点的日常运营带来了诸多不便，存在显著的功能短板。

子比在线打赏插件（zibll-donation）的开发，正是为了针对性解决这一核心痛点。插件将原有静态的二维码扫码打赏，无缝升级为便捷的在线支付打赏模式，用户完成支付后，金额会自动划转至作者账户，整个打赏流程全程可追踪、可管理，彻底弥补了原生功能的不足。

核心特性

01 无缝替换，零感知升级

插件激活后自动接管子比主题原生打赏弹窗，用户点击文章底部「赞赏」按钮，不再展示收款二维码，而是加载全新在线支付界面，集成预设金额卡片、自定义金额输入、留言框、支付方式选择等功能，操作流程一气呵成。

全程复用子比主题原生模态框机制与支付通道，无需额外配置支付接口，升级过程对用户和站长均无感知。

02 灵活金额体系，适配多样打赏需求

• 自定义预设金额：后台可自由配置多档打赏金额（如 2/5/10/20/50/100 元），支持拖拽调整档位排序，贴合站点运营需求；
• 手动输入金额：用户可自定义打赏金额，插件内置数值校验，严格限制金额最小值与最大值，避免异常输入；
• 默认金额选中：可后台设定默认选中的金额档位，减少用户操作步骤，提升打赏转化率。

03 双收入模式，一键切换适配不同运营策略

插件提供两种打赏收入模式，后台一键切换实时生效，满足个人站点与多作者平台的差异化需求：

表格

收入模式	核心说明	适用场景
余额模式（默认）	打赏金额直接划入作者站内余额，可直接用于站内消费或申请提现	个人站点、小型创作者社区
创作分成模式	打赏金额计入子比主题「创作收入」体系，按平台规则走提现审核流程	多作者平台、需财务统一管控的站点

04 内置平台抽成机制，透明化分账管理

针对多作者运营站点设计专属抽成功能，兼顾平台运营与作者权益，全程公开透明：

• 抽成比例可自由设置，支持 1%~100% 灵活调节；
• 打赏弹窗内自动展示抽成提示，让打赏者清晰知晓金额分配规则；
• 作者收款通知中精准标注原始打赏金额、平台抽成金额、实际到账金额；
• 内置兜底保护机制，确保作者每笔打赏至少获得 0.01 元收益。

05 三重专属通知体系，交易进度实时知晓

每笔打赏支付成功后，插件将发送 3 条专属通知（替代主题通用订单通知），支持站内消息 + 邮件推送双渠道（遵循子比主题后台通知开关设置）：

• 作者通知：含打赏金额、打赏者名称、来源文章、留言内容，及本次收入去向说明；
• 打赏者通知：确认打赏成功，附带订单号、付款明细、作者信息，留存交易凭证；
• 管理员通知：实时新打赏提醒，同步展示今日 / 本月打赏订单统计数据，方便平台运营。

06 作者主页专属打赏入口，拓宽打赏渠道

除文章页底部原生打赏按钮外，插件将在作者个人主页自动注入打赏按钮，访客无需阅读文章，可直接打赏喜欢的创作者，进一步提升作者收入。

按钮样式与子比主题原生设计完全一致，视觉风格高度融合，不破坏页面整体美观度。

07 现代化后台管理面板，一站式高效管控

插件搭载基于 Vue 3 + Element Plus 构建的现代化后台管理界面，操作简洁、功能全面，打赏管理更高效：

• 打赏设置中心：功能开关、金额配置、收入模式、抽成比例等所有功能，一站式集中管理，无需多页面切换；
• 完整打赏记录：支持按关键词搜索、按日期 / 状态筛选，展示打赏者、被赏作者、关联文章、打赏金额、留言、支付方式等全维度明细，流水可查可追溯。

08 全场景样式适配，兼顾体验与美观

插件样式深度适配子比主题使用场景，确保不同设备、不同显示模式下均有优质体验：

• 完美兼容主题深色模式，通过 .dark-theme 类自动响应模式切换，色彩搭配协调统一；
• 针对移动端做专属响应式布局优化，适配手机、平板等不同尺寸设备，操作流畅无卡顿。

安全设计

插件从多维度构建安全防护体系，全方位保障打赏交易安全与站点数据安全：

1. 所有 AJAX 请求均验证 WordPress Nonce 令牌，有效防止 CSRF 跨站请求伪造攻击；
2. 后台所有操作严格校验 manage_options 权限，杜绝未授权访问；
3. 所有用户输入内容均经过 sanitize_text_field /sanitize_textarea_field 专业消毒处理，防止 XSS 跨站脚本攻击；
4. 内置自我打赏拦截机制，在弹窗展示、订单提交等全环节，自动阻止用户打赏自己，避免恶意操作；
5. 支付成功回调环节进行二次数据校验，确保订单金额、状态等信息一致性，防止数据篡改。

版本兼容

插件完美兼容子比主题主流版本，自动检测主题版本并匹配对应的订单数据处理方式，无需用户手动配置，即装即用：

• 子比主题 v8.5+：采用 initiate_order_data_type_{type} 过滤器 + order_meta 表存储打赏额外数据，适配主题新版数据结构；
• 子比主题 v8.1：采用 initiate_order_data 过滤器 + other 字段存储打赏额外数据，兼容主题旧版逻辑。

环境要求

插件运行环境要求贴合子比主题通用配置，无需额外升级服务器，低门槛部署：

表格

运行项目	最低要求
WordPress	5.0+
PHP	7.2+
子比主题	全版本（需开启主题支付功能）

最后说明

子比在线打赏插件的核心开发理念是：不重新造轮子，只做精准增强。

插件全程复用子比主题原生的支付通道、模态框机制、消息系统和 UI 组件，不改变主题原有操作逻辑，仅针对「打赏」单一场景做深度优化，解决原生二维码打赏的无追踪、无管理痛点，让每一笔打赏都有据可查、有迹可循，实现打赏者、创作者、平台三方共赢。

如果你正在运营基于子比主题的多作者内容平台，或是希望让读者的打赏更便捷、更透明，真正触达创作者 —— 这款插件值得你一试。