幸运抽奖内容
帖子回复抽奖 + 首页侧边栏抽奖：奖品支持积分/金币/实物/勋章，可分别开关，含中奖通知与中奖榜。
¥19.90
一次购买，永久使用
详情介绍
一、插件简介
幸运抽奖（lottery）面向社区站点，提供两种抽奖形态：帖子回复抽奖（发帖设奖、回帖参与、手动/定时开奖）与 首页侧边栏抽奖（独立奖品池、概率/库存/消耗积分）。奖品类型含积分、金币、实物、勋章。
适合活动运营、用户促活、节日营销等场景。
plaza_after_hot 插槽）/admin/lottery）POST /lottery/join — 参与帖内抽奖（回帖触发）POST /lottery/draw — 手动开奖POST /lottery/force — 强制结束POST /lottery/sidebar_draw — 侧边栏抽奖二、核心能力
| 能力 | 说明 |
|---|---|
| 帖内抽奖 | 发帖配置奖品，用户回帖自动参与 |
| 开奖方式 | 手动开奖 / 定时开奖（设到期时间） |
| 参与限制 | 可排除楼主；可限制参与用户等级 |
| 奖品类型 | 积分、金币、实物、勋章（需 badge 插件） |
| 预扣机制 | 积分/金币奖品发帖时预扣，结束未发完可退回 |
| 侧边栏抽奖 | 首页独立奖品，概率、库存、消耗积分可配 |
| 中奖通知 | 依赖消息（message）插件发站内通知 |
| 中奖记录 | 后台可查帖内与侧栏中奖记录，支持补发 |
三、依赖与安装
建议环境：
安装步骤：
数据表：
{prefix}lottery、{prefix}lottery_prize、{prefix}lottery_participant{prefix}lottery_win — 中奖记录{prefix}lottery_sidebar_prize、{prefix}lottery_sidebar_log — 侧栏四、应用中心基础配置
路径：应用中心 → 幸运抽奖 → 配置（部分项亦可在后台 /admin/lottery 保存）
| 配置项 | 说明 | 建议 |
|---|---|---|
| 启用幸运抽奖 | 总开关；关闭后帖内与侧栏均不可用 | 保持开启 |
| 帖子回复抽奖 | 帖内抽奖子开关 | 按需 |
| 首页侧边栏抽奖 | 侧栏卡片子开关 | 按需 |
| 中奖通知 | 需消息插件 | 建议开启 |
| 可发布用户组 | 仅指定组可发起帖内抽奖 | 按需 |
| 侧边栏标题 | 首页右侧卡片标题 | 默认「幸运抽奖」 |
| 抽奖说明 | 侧栏「说明」弹窗内容，支持换行 | 填写规则 |
| 动态条数 | 侧栏底部最近抽奖动态（5–50） | 默认 20 |
五、后台重点配置
路径：插件列表 → 幸运抽奖
5.1 侧边栏奖品
/admin/lottery/sidebar5.2 帖子抽奖活动
/admin/lottery/activity5.3 中奖记录
/admin/lottery/win5.4 侧边栏抽奖记录
/admin/lottery/sidebar_log5.5 帖内抽奖发帖参数
| 项 | 说明 |
|---|---|
| 开奖方式 | 手动 / 定时（须设有效开奖时间） |
| 排除楼主 | 楼主是否可参与 |
| 参与等级 | 允许参与的用户等级 |
| 奖品列表 | 至少一项；积分/金币会预扣 |
六、前台用户流程
帖内抽奖
lottery/join）侧边栏抽奖
uk_prize_user 唯一约束）七、后台审核与运维
| 操作 | 说明 |
|---|---|
| 侧边栏奖品管理 | 增删改、上下架 |
| 活动监控 | 查看帖内抽奖状态，必要时强制结束 |
| 中奖记录 | 查中奖明细，实物/失败奖品可补发 |
| 侧栏日志 | 审计侧栏抽奖行为 |
| 保存配置 | 侧栏标题、说明、动态条数等 |
八、特殊说明
币种流水标签（coinTypeLabels）：
lottery_prepay — 帖子抽奖预扣lottery_refund — 帖子抽奖退回lottery_win — 幸运抽奖中奖lottery_sidebar — 侧边栏抽奖消耗插件钩子：
| 插槽 | 作用 |
|---|---|
topic_after_content | 帖内抽奖展示 |
compose_extra / admin_topic_form | 发帖配置 |
plaza_after_hot | 首页侧栏卡片 |
限制： 已有用户参与后不可修改帖内抽奖配置；已结束不可再改。
九、推荐上线清单
十、常见问题
Q：首页看不到侧栏抽奖？ 检查总开关、「首页侧边栏抽奖」、是否在首页且 plaza_home 上下文存在。
Q：发帖提示预扣失败？ 积分/金币奖品需发帖人余额足够支付「金额 × 份数」。
Q：已有参与无法修改奖品？ 防作弊设计；需删帖重建或强制结束后再处理。
Q：勋章奖品发不出去？ 确认 badge 插件已安装启用，奖品配置了有效勋章 ID。
Q：侧栏提示已抽过？ 每人每奖品仅一次，换账号或换奖品再试。
更新记录 （5）
-
v1.0.5
2026-09-02
1、侧栏抽奖、帖内抽奖等区块不再在 HTML 内延迟注入 CSS 2、样式改为由社区布局在 <head> 统一提前加载，修复刷新时「幸运抽奖」区域短暂丢样式问题
-
v1.0.4
2026-08-30
1、侧栏登录态改为 Member::loggedIn() 2、支持管理员参与抽奖（扣积分、发奖走管理员账户） 3、流水/中奖表增加 admin_id，每人每奖品仍限一次
-
v1.0.3
2026-08-25
发帖页按板块显示/隐藏入口；保存与上传接口校验板块
-
v1.0.2
2026-08-24
支持 only_active_extras：后台编辑时，没开过的拓展不显示空表单
-
v1.0.1
2026-08-24
首次发布