[原创插件]MQgzs幸运抽奖插件v.1.0

一、插件概述

二、核心功能

✨ 前台用户功能

1. 积分消耗抽奖：用户每次抽奖消耗预设积分，积分不足时自动拦截并提示。
2. 每日抽奖上限：可配置用户单日最多抽奖次数，防止恶意刷奖。
3. 实时中奖记录：展示全站用户最新中奖动态，营造社区活跃氛围。
4. 直观状态显示：清晰展示当前用户的积分消耗规则、剩余抽奖次数。
5. 无缝集成：通过钩子系统直接嵌入会员中心首页，无需修改核心文件。

⚙️ 后台管理功能

1. 奖品配置管理：支持添加 / 编辑 / 删除奖品，可设置：
   • 奖品名称、图片
   • 中奖概率（支持百分比配置）
   • 奖品类型（积分 / 实物 / 虚拟道具）
   • 库存上限、发放状态
2. 全局参数设置：
   • 单次抽奖消耗积分
   • 每日最大抽奖次数
   • 活动开关（一键开启 / 关闭抽奖功能）
3. 中奖记录管理：
   • 查看所有用户的中奖记录（用户 ID、奖品、时间）
   • 支持按用户 / 奖品筛选、导出记录
   • 异常中奖记录标记与重置
4. 数据统计面板：展示抽奖参与人数、总消耗积分、热门奖品分布等数据。

三、技术架构与兼容性

四、文件结构与说明

└── lottery/
    ├── plugin.php       # 钩子注册文件（实现插件化加载）
    ├── widget.php       # 前台展示模块（会员中心抽奖界面）
    ├── index.php        # 抽奖核心逻辑（消耗积分+中奖判断）
    ├── admin.php        # 后台管理入口（奖品/记录/配置）
    ├── install.sql      # 数据库安装脚本（自动建表）
    └── assets/          # 静态资源（奖品图片、样式文件）

五、安装与部署流程

1. 上传文件：将lottery文件夹上传至论坛根目录的plugins/目录下。
2. 执行安装：在论坛后台「应用中心」上传并安装插件，自动执行install.sql创建数据表。
3. 基础配置：在后台插件管理页设置单次消耗积分、每日上限等全局参数。
4. 添加奖品：配置奖品信息、中奖概率与库存，启用活动。
5. 验证功能：前台登录会员中心，确认抽奖模块正常显示、积分消耗与中奖记录正常。

六、安全与防作弊设计

• 双重校验机制：前端请求与后端核心逻辑双重校验用户积分与抽奖次数，防止抓包作弊。
• 防重复提交：通过 Token 令牌防止用户重复提交抽奖请求。
• 概率算法隔离：中奖概率计算逻辑完全在后端实现，前端仅负责结果展示，无法篡改。
• 操作日志留存：所有抽奖操作均记录日志，可追溯异常行为。

七、扩展与定制能力

• 样式自定义：支持修改widget.php的 CSS，适配论坛现有主题风格。
• 奖品类型扩展：可二次开发支持实物奖品发货、虚拟道具自动发放等功能。
• 通知集成：可对接论坛站内信、邮件通知，中奖后自动推送提醒。
• 多场景适配：除会员中心外，也可嵌入论坛首页、帖子页等位置。

八、适用场景

• 社区活跃运营：通过抽奖提升用户登录率、互动率。
• 积分消耗闭环：为论坛积分提供消耗出口，平衡积分通胀。
• 活动运营工具：节日 / 版本更新等场景的运营活动载体。