For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt, and this page is available as Markdown at /reward/settings.md.

楠枝文档中心

配置项

适用版本 1.0.0 ｜ Halo ≥ 2.27.0 ｜后台路径：插件 → 打赏插件 → 设置

配置分为基础、收款、记录与展示、爱发电、通知五组。前台表单的字段会跟随这里的开关自动显示或隐藏，主题不需要另做判断。

基础设置

选项	默认值	说明
启用打赏页面	开启	关闭后 `/reward` 返回 404，提交与验证码接口拒绝服务；只读接口不受影响
页面标题	打赏支持	前台页面主标题
页面简介	示例文案	标题下方的说明文字，可留空
货币符号	`¥`	显示在金额前的符号

收款设置

选项	默认值	说明
微信收款码	空	从 Halo 附件库选择图片，建议 1:1 正方形
支付宝收款码	空	同上；两种都上传时前台双列展示
收款提示	示例文案	显示在收款码下方，建议说明「需手动输入金额」

记录与展示

选项	默认值	说明
允许访客提交打赏记录	开启	关闭后前台只展示收款码，不收集记录
仅登录用户可提交	关闭	开启后未登录访客无法提交，按钮提示先登录
允许填写留言	开启	关闭后表单不显示留言框
提交时校验图形验证码	开启	5 分钟过期、一次性使用，不区分大小写
要求填写交易单号	关闭	开启后表单显示交易单号且必填，便于对照收款记录
允许访客填写头像地址	关闭	仅接受 `http(s)` 或站内路径，头像会展示在赞助者墙
提交后自动通过	关闭	关闭时新记录为「待确认」；开启后直接上墙，请自行评估风险
展示赞助者墙	开启	关闭后前台不显示赞助者墙，统计仍可正常读取
赞助者墙每页条数	10	1 ~ 50，影响首屏与「加载更多」的每页数量
在赞助者墙显示金额	开启	关闭后只展示昵称与留言

爱发电

选项	默认值	说明
启用爱发电	关闭	开启后可使用订单回调与手动同步
开发者 user_id	空	爱发电开发者后台获取
API 凭据	空	选择一个包含 `token` 键的 Halo 密钥
爱发电主页	空	填写后前台展示「前往爱发电」卡片
订单自动确认并展示	开启	关闭时平台订单入库为「待确认」

具体步骤见爱发电对接。

通知

选项	默认值	说明
有新的打赏记录时通知管理员	开启	适用于前台表单提交产生的记录
爱发电新订单入库时通知管理员	开启	仅平台回调会通知；后台手动同步不通知，避免补录历史订单时被连续提醒

推荐配法

最小可用：只填标题、简介与一张收款码，其余保持默认。访客扫码后可提交记录，站长确认后上墙。

对账优先：开启「要求填写交易单号」，关闭「提交后自动通过」与「允许访客填写头像地址」。每条记录都能与微信 / 支付宝账单对应，伪造成本也更高。

轻量展示：关闭「允许访客提交打赏记录」与「展示赞助者墙」，页面只留收款码与爱发电入口，适合不想维护记录的场景。

信任访客：开启「提交后自动通过」与「允许访客填写头像地址」，记录提交后立即上墙；仍建议保留验证码，避免被批量刷屏。

注意事项

「启用打赏页面」只控制 /reward、配置读取、验证码与提交入口；赞助者墙与统计是独立只读接口，方便主题在其它页面展示数据
「允许访客提交打赏记录」关闭后，已有记录仍会正常展示；想连墙面一起下线，需关闭「展示赞助者墙」
联系方式与交易单号只存后台，任何公开接口都不会返回；填写前仍建议在页面说明中告知访客
金额必须大于 0，最多两位小数；后台补录的金额上限为 1000000
修改开关后前台立即生效，不需要重新构建主题；若浏览器缓存了旧页面，强刷一次即可