幸运抽奖内容管理

版本 v1.1.4· 张先生 · 93 次获取 · 内容管理

帖子回复抽奖 + 首页侧边栏抽奖 + 独立抽奖页：奖品支持积分/金币/实物/勋章，可分别开关，含中奖通知与中奖榜。

¥4.00抵扣

一次购买，永久使用

详情介绍

一、插件简介

项目	说明
插件标识	`lottery`
版本	1.1.34
分类标签	互动
前台入口	独立抽奖页 `/lottery`；帖内抽奖在主题详情；侧栏抽奖在社区首页右侧。社区开启伪静态时独立页为 `/lottery.html`
后台入口	应用中心 → 插件列表 → 幸运抽奖；菜单「幸运抽奖」`/admin/lottery`

幸运抽奖插件提供三种玩法：帖子回复抽奖、首页侧边栏抽奖、独立九宫格抽奖页。奖品支持积分、金币、实物、虚拟、卡密、勋章（独立页不含勋章）。积分/金币消耗与中奖发放的展示名称读取支付中心配置，未填写时默认「积分」「金币」。

二、核心能力

能力	说明
帖子回复抽奖	发帖时配置奖品，回帖自动参与；支持手动开奖或定时开奖，可排除作者、限制用户组、预扣积分/金币
首页侧边栏抽奖	首页右侧独立奖品，可设概率、库存、消耗；每人每奖品限一次（可叠加同 IP 限制）
独立抽奖页	`/lottery` 九宫格，统一消耗积分或金币；按各奖品中奖率开奖；展示动态与排行榜
奖品履约	积分/金币自动到账；卡密自动发放；勋章自动颁发；实物可填收件信息，后台发货；虚拟奖品登记说明
风控	同 IP 仅一次（帖内场次/侧栏奖品/独立页）；独立页可设每日次数；可限制发帖抽奖的用户组与版块
中奖通知	可选写入消息中心
后台运维	强制结束帖内活动、补发奖品、标记实物发货、查看各通道抽奖记录

三、依赖与安装

将插件目录置于 plugins/lottery/。
在应用中心安装「幸运抽奖」。
安装时创建 lottery、lottery_prize、lottery_participant、lottery_sidebar_prize、lottery_sidebar_log、lottery_win、lottery_page_prize、lottery_page_code、lottery_page_log 等表，并注册后台菜单。
硬依赖：社区插件（发帖、回帖、会员资产、首页侧栏）。
软依赖：支付中心（积分/金币展示名称）；勋章插件（勋章类奖品）；消息中心（中奖通知）。未安装对应插件时，相关奖品类型或通知不可用，其余玩法仍可运行。

四、应用中心基础配置

在应用中心 → 幸运抽奖 → 配置（亦可在后台抽奖菜单保存），字段来自 configSchema：

配置项	类型	默认值	说明
启用幸运抽奖	开关	开	总开关；关闭后帖子、侧栏、独立页均不可用
同 IP 仅一次	开关	开	同一 IP 在同一场帖内抽奖、同一个侧栏奖品、独立抽奖页只能参与一次，换号无效
帖子回复抽奖	开关	开	发帖配置奖品，回帖参与，手动/定时开奖
首页侧边栏抽奖	开关	开	首页右侧独立奖品抽奖
独立抽奖页	开关	开	访问 `/lottery`；奖品在「独立页奖品」配置，建议不超过 8 个
独立页标题 / 副标题 / 规则说明	文本	有默认文案	独立页展示用
每次抽奖消耗币种	下拉	积分	九宫格每次扣除积分或金币；前台名称读支付中心
每次抽奖消耗数量	数字	10	0 表示免费。兼容旧字段 `page_cost_coins`
独立页动态条数	数字	20	最近抽奖动态，范围 5–50
每日抽奖次数	数字	0	独立页每用户每天上限；0 不限制
右侧榜单数量	数字	8	独立页排行榜条数 1–20
中奖通知	开关	开	需已安装并启用消息中心
可发布用户组	多选	不限制	仅勾选用户组可在发帖时发起帖内抽奖；管理员不受限
可用版块	多选	全不勾选=全不可用	仅勾选版块的发帖页出现抽奖拓展
侧边栏标题 / 抽奖说明 / 动态条数	文本/数字	幸运抽奖 / 默认说明 / 20	首页右侧卡片

五、后台重点配置

独立页奖品

菜单默认进入 /admin/lottery。配置不超过 8 个九宫格奖品：类型（积分/金币/实物/虚拟/卡密）、数量、中奖率、库存；卡密类需导入卡密库。上下架后前台格子同步。

侧边栏奖品

/admin/lottery/sidebar：为首页侧栏添加奖品，设置消耗、概率、库存与类型。

帖子抽奖

用户在已开放版块发帖时配置奖品与开奖方式。后台「帖子抽奖活动」可查看进行中活动并强制结束（预扣资产按规则退回）。

中奖与发货

「中奖记录」可补发失败奖品、为实物填写发货信息。「独立页抽奖记录」「侧边栏抽奖记录」用于对账。

六、前台用户流程

独立页：打开 /lottery → 登录 → 点击九宫格中间抽奖（按页面设定扣积分或金币）→ 中奖后积分/金币/卡密自动到账；实物填写收件信息。
侧栏：首页右侧选择奖品 → 确认消耗 → 抽取；每奖品每人（及同 IP，若开启）仅一次。
帖内：符合条件用户发帖开启抽奖 → 读者回帖参与 → 到达定时或楼主/管理员开奖 → 中奖者自动履约或等待实物联系。

七、后台审核与运维

功能	路径	说明
独立页奖品	`/admin/lottery`、`/admin/lottery/page`	九宫格奖品增删改、上下架
独立页抽奖记录	`/admin/lottery/page_log`
侧边栏奖品	`/admin/lottery/sidebar`
侧边栏抽奖记录	`/admin/lottery/sidebar_log`
帖子抽奖活动	`/admin/lottery/activity`	查看活动
强制结束活动	`POST /admin/lottery/activity/force`	结束进行中的帖内抽奖
中奖记录	`/admin/lottery/win`
补发奖品	`POST /admin/lottery/win/reissue`	履约失败时补发
标记实物发货	`POST /admin/lottery/win/ship`
保存抽奖配置	`POST /admin/lottery/save`	与应用中心配置相同

前台路由

方法	路径	说明
GET	`/lottery`	独立抽奖页
POST	`/lottery/page_draw`	九宫格抽奖
POST	`/lottery/page_ship`	独立页实物收件信息
POST	`/lottery/sidebar_draw`	侧栏抽奖
POST	`/lottery/join`	帖内参与（回帖链路）
POST	`/lottery/draw`	帖内开奖
POST	`/lottery/force`	帖内强制结束

八、特殊说明

静态资源：/static/lottery/（抽奖页、帖内脚本与样式），由社区布局按开关引入。
奖品类型：帖内/侧栏可为积分、金币、实物、勋章等；独立页为积分、金币、实物、虚拟、卡密（无勋章）。展示名随支付中心变化。
可用版块：不勾选任何版块时，发帖页不出现抽奖拓展。
数据表：帖内活动 lottery 状态 0 进行中 / 1 已开奖 / 2 强制结束；独立页卡密 lottery_page_code。

九、推荐上线清单

开启总开关，按需打开帖内、侧栏、独立页
独立页配置 8 个以内奖品，中奖率合计合理，卡密库存充足
设定消耗币种与数量（0 为免费），并到支付中心确认展示名称
勾选允许发帖抽奖的版块与用户组
决定是否开启同 IP 仅一次、每日次数上限
侧栏奖品核对概率与库存，避免空奖
安装消息中心后再开中奖通知；勋章奖需勋章插件
抽检三种玩法各一笔：扣款、到账、实物填地址

十、常见问题

Q：发帖看不到抽奖？ 检查总开关、帖子回复抽奖开关、当前版块是否在「可用版块」中，以及发帖用户组是否在「可发布用户组」内（空=不限制）。

Q：独立页 404 或九宫格为空？ 开启「独立抽奖页」并至少上架奖品；伪静态时访问 /lottery.html。

Q：提示余额不足？ 独立页按配置扣除积分或金币；名称以支付中心为准。数量为 0 则免费。

Q：换号仍提示已参与？ 已开启「同 IP 仅一次」。

Q：卡密没发到？ 检查独立页奖品卡密库是否还有未用记录，可在中奖记录补发。

Q：勋章奖发不出？ 需安装勋章插件；独立页不支持勋章类型。

Q：中奖没有站内信？ 开启「中奖通知」且消息中心已安装启用。

Q：消耗显示仍是积分/金币？ 到支付中心填写积分名称、金币名称后刷新前台。

更新记录（14）

v1.1.4 2026-10-06
1、抽奖盘及奖品图标背景适配深色模式。 2、抽奖消耗及积分 / 金币类奖品名称读取支付配置。
v1.1.3 2026-09-24
版本优化
v1.1.2 2026-09-23
1、优化后台表单，兼容新版后台UI框架 2、优化前端及后端加载逻辑
v1.1.1 2026-09-22
优化插件缓存加载逻辑
v1.1.0 2026-09-20
1、增加 withClientIp（对齐红包） 2、榜单默认数量改为 10；库里 leaderboard_limit 从 9 → 10 3、页面/样式微调（lottery.css、lottery-page.css）
v1.0.9 2026-09-19
新增单IP抽奖限制
v1.0.8 2026-09-18
优化插件缓存加载逻辑
v1.0.7 2026-09-16
优化贴内中奖名单展示样式
v1.0.6 2026-09-13
1、新增独立抽奖页，后台可配置多奖品及每个奖品的中奖率~ 2、新增实物奖品收货信息填写，支持管理员邮递奖品
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
首次发布