子比捐赠模板插件
专为子比主题开发的全功能捐赠模板插件，深度适配主题原生样式与支付体系，集成一键支付、实时筹款统计、捐赠留言、动态特效、暗色模式、订单修复等全套能力，开箱即用。
一、功能特性
1. 核心支付与统计
- 电商式一键支付，点击快捷金额即可唤起支付流程，操作简洁流畅
- 兼容微信、支付宝、站内余额三种支付方式，复用子比原生支付弹窗
- 筹款金额数据库实时计算，内置 5 分钟数据缓存，无需手动维护
- 渐变流光进度条，同步展示筹款百分比，视觉效果出色
2. 交互体验增强
- 捐赠留言功能：支持填写 100 字以内寄语，随捐赠记录公开展示
- 目标达成动效：筹款进度 100% 时自动触发 Canvas 撒花庆祝动画
- 支付成功弹窗：搭配动态图标与金额展示，提升反馈体验
- 金额区间校验：后台可设置最小 / 最大捐款额，拦截异常提交
3. 捐赠列表展示
- 隐私保护：匿名展示，昵称以「热心网友 A~Z」循环轮换
- 数据来源：读取
wp_zibpay_order正式支付订单，数据真实可靠 - 展示规则：默认按时间倒序，仅展示最新 10 条捐赠记录，隐藏用户头像
4. 样式与多端适配
- 全量采用子比主题 CSS 变量，自动跟随日间 / 夜间模式切换，无需额外配置
- 全站响应式布局，完美适配手机、平板、桌面等各类设备
- 后台可视化配置，所有核心参数均可在 WordPress 后台自定义
5. 订单记录修复
- 自动修正余额流水：将捐赠类订单标注为「捐赠支出」，替代原有「付费内容」
- 后台提供一键批量修复工具，统一修正历史旧订单展示问题
二、安装使用
1. 安装步骤
- 将插件文件夹
zib-donation-template上传至网站/wp-content/plugins/目录 - 进入 WordPress 后台 → 插件，启用「子比捐赠模板插件」
- 后台导航进入 设置 → 捐赠模板设置，完成参数配置
2. 调用简码
在文章、页面、自定义模块中直接使用简码渲染捐赠页面：
支持服务器维护费用
¥954.1
已筹金额
¥10000
目标金额
9.5%
您的支持对我们非常重要，每一份捐赠都将帮助我们继续前进，共同创造更美好的未来。
💝 选择支持金额
点击下方金额，立即支付只需一步
¥
最多 100 个字，留空则不显示
💝 感谢以下爱心捐赠者
热心网友R
"支持一下"
2026-05-28 02:45
¥1
热心网友Q
"支持一下！"
2026-05-28 02:25
¥2
热心网友M
2026-05-28 02:19
¥2
热心网友L
2026-05-28 02:19
¥200
热心网友K
2026-05-28 02:14
¥1
热心网友J
2026-05-28 02:11
¥1
热心网友I
2026-05-28 02:10
¥50
热心网友H
2026-05-28 02:10
¥1
热心网友G
2026-05-28 01:57
¥1
热心网友F
2026-05-28 01:37
¥50
3. 简码可选参数
表格
| 参数 | 作用 | 默认值 |
|---|---|---|
| title | 捐赠模块标题 | 后台配置值 |
| goal | 筹款目标金额 | 后台配置值 |
| raised | 手动填写已筹金额（开启实时统计后失效） | 后台配置值 |
| description | 筹款呼吁文案 | 后台配置值 |
| project_desc | 项目详情介绍 | 后台配置值 |
| show_list | 是否显示捐赠列表 | yes |
使用示例
助力公益项目
¥954.1
已筹金额
¥20000
目标金额
4.8%
您的支持对我们非常重要，每一份捐赠都将帮助我们继续前进，共同创造更美好的未来。
💝 选择支持金额
点击下方金额，立即支付只需一步
¥
最多 100 个字，留空则不显示
💝 感谢以下爱心捐赠者
热心网友R
"支持一下"
2026-05-28 02:45
¥1
热心网友Q
"支持一下！"
2026-05-28 02:25
¥2
热心网友M
2026-05-28 02:19
¥2
热心网友L
2026-05-28 02:19
¥200
热心网友K
2026-05-28 02:14
¥1
热心网友J
2026-05-28 02:11
¥1
热心网友I
2026-05-28 02:10
¥50
热心网友H
2026-05-28 02:10
¥1
热心网友G
2026-05-28 01:57
¥1
热心网友F
2026-05-28 01:37
¥50
三、后台配置项
1. 基础设置
- 捐赠页面标题：模块顶部主标题
- 目标金额：设定筹款总目标
- 已筹金额：手动填写金额（推荐开启实时统计后忽略此项）
- 捐赠呼吁文案：进度条下方说明文字
- 项目说明：支付弹窗内展示的项目详情
- 显示捐赠列表：开关控制列表展示状态
2. 金额相关配置
- 默认金额选项：快捷捐款按钮金额，多个数值使用英文逗号分隔，默认
50,100,200,500 - 最小捐赠金额：单笔捐款下限，默认
1 - 最大捐赠金额：单笔捐款上限，默认
99999
四、文件目录结构
zib-donation-template/
├── zib-donation-template.php # 插件主入口文件
├── includes/
│ └── class-zib-donation.php # 核心业务逻辑类
├── templates/
│ └── donation-page.php # 前端页面模板
└── assets/
├── css/
│ └── style.css # 样式文件（基于子比CSS变量）
└── js/
└── script.js # 前端交互脚本
五、更新日志
v2.0.0（2025-05-28 重大更新）
- 样式重构：全面改用子比主题 CSS 变量，完美适配明暗模式
- 新增实时筹款统计，5 分钟缓存机制，自动读取订单数据
- 后台支持自定义快捷金额、单笔金额上下限
- 上线捐赠留言功能，支持寄语填写与展示
- 增加目标达成撒花动画、支付成功感谢弹窗
- 新增金额合法性校验，防范异常订单
v1.21.0（2025-05-28）
- 完善夜间模式适配，全页面兼容子比暗色主题
v1.20.0（2025-05-28）
- 修复余额记录显示异常，统一将捐赠订单标注为「捐赠支出」
- 为主题函数
zibpay_get_pay_type_name()新增过滤器filter_pay_type_name
v1.19.0
- 优化捐赠列表逻辑，读取真实支付订单
- 实现匿名昵称轮换（热心网友 A~Z），限制最多展示 10 条记录
- 关闭列表头像展示
六、重要注意事项
- 本插件仅限 Zibll 子比主题使用，其他主题不兼容
- 网站必须提前安装并启用 子比 ZibPay 支付系统
- 插件自动注册自定义订单类型
order_type=100，请勿随意修改数据库标识 - 余额记录修复功能依赖主题过滤器，需确保主题版本支持 v1.20.0 及以上配套逻辑
© 版权声明
本网站部分文件及内容来自互联网，版权归原作者所有。转载需授权，侵权必究。部分内容受《网络出版服务管理规定》保护，未经许可禁止商业使用。
THE END
暂无评论内容