礼品卡充值系统

适用于 XIUNOX 论坛的礼品卡兑换插件，管理员批量生成带面额的礼品卡，用户输入卡密即可为账户充值金币，适用于活动奖励、线下推广等场景。

版本

• 插件版本：1.1.0

• 最低 XIUNOX 版本：1.1

• 作者：段先生

功能概述

安装

1. 将 navg_cn_giftcard 目录放入论坛的 plugin/ 目录下

2. 进入后台 → 插件管理 → 找到「礼品卡充值系统」→ 点击「安装」

3. 安装后会自动创建 navg_giftcard 数据表

4. 安装后清除 tmp/ 缓存（重要）！！！！！！！！

使用说明

管理员

1. 进入后台 → 插件管理 → 点击「礼品卡充值系统」的「设置」按钮

2. 生成卡密：设置面额（金币）、数量（1-99）、有效期 → 点击「生成」

3. 管理卡密：可查看所有卡密，按状态/面额筛选，分页浏览

4. 批量作废：勾选未使用的卡密 → 点击「批量作废」

5. 导出 CSV：点击「导出CSV」下载全部卡密数据

前台用户

1. 进入个人中心 → 积分页面，在「积分记录」卡片下方可直接看到「兑换礼品卡」卡片

2. 输入卡密 → 点击「立即兑换」→ 金币即时到账

3. 点击「兑换记录」→ 弹窗查看历史兑换详情

卡密状态

技术架构

注册的 Hook

路由表

数据库表

CREATE TABLE navg_giftcard (
    id int unsigned NOT NULL AUTO_INCREMENT,
    card_no varchar(32) NOT NULL DEFAULT '',      -- 卡号（唯一）
    card_key varchar(64) NOT NULL DEFAULT '',     -- 卡密（MD5）
    amount int unsigned NOT NULL DEFAULT 0,       -- 面额（金币）
    expire_time int unsigned NOT NULL DEFAULT 0,  -- 过期时间戳（0=永久）
    status tinyint NOT NULL DEFAULT 0,            -- 状态：0未使用 1已使用 2已过期 3已作废
    used_uid int unsigned NOT NULL DEFAULT 0,     -- 兑换人 UID
    used_time int unsigned NOT NULL DEFAULT 0,    -- 兑换时间戳
    created int unsigned NOT NULL DEFAULT 0,      -- 创建时间戳
    PRIMARY KEY (id),
    UNIQUE KEY card_no (card_no),
    KEY card_key (card_key),
    KEY status (status),
    KEY used_uid (used_uid),
    KEY created (created)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

文件结构

navg_cn_giftcard/
├── conf.json                         # 插件配置
├── install.php                       # 安装脚本
├── uninstall.php                     # 卸载脚本
├── setting.php                       # 后台入口
├── README.md
├── model/
│   └── NavgGiftcardService.php       # 核心业务逻辑
├── route/
│   ├── navg_giftcard.php             # 前台路由
│   └── admin/
│       └── navg_giftcard.php         # 后台路由
├── hook/
│   ├── admin_index_route_case_end.php
│   ├── footer_js_after.htm
│   ├── index_route_case_end.php
│   ├── lang_zh_cn_bbs.php
│   ├── model_inc_file.php
│   ├── model_route_table_end.php
│   └── user_nav_end.htm
├── view/
│   └── htm/
│       ├── admin_generate.htm        # 后台生成页面
│       ├── admin_generate_result.htm # 后台生成结果页面
│       ├── admin_list.htm            # 后台卡密列表
│       ├── navg_giftcard.htm         # 前台兑换页面
│       └── navg_giftcard_history.htm # 用户兑换记录页面
└── static/
    ├── css/
    │   └── navg_giftcard.css
    └── js/
        └── navg_giftcard.js          # 前端交互（兑换卡片注入 + 模态框）

卸载

1. 进入后台 → 插件管理 → 找到「礼品卡充值系统」→ 点击「卸载」

2. 卸载后会自动删除 navg_giftcard 数据表和相关配置

3. 卸载后清除 tmp/ 缓存

注意事项

• 插件不修改任何主程序文件，所有功能仅在插件目录内完成

• 积分页面的兑换卡片通过 JS 动态注入，不覆盖核心模板

• 修改插件文件后需清除 tmp/ 目录下的编译缓存

• 卡密由 MD5 生成，不可逆向推导

• 兑换操作使用数据库事务，保证原子性
  
  

• 测试地址

• navg.cn

• 账号admin1，123456

• 目前正在修复，维护中ing...