内测版

前往下载

会员插件（PluginMember）— 详细功能介绍

一款为 Halo CMS 打造的全功能会员管理插件，帮助站长构建完整的会员运营体系，提升用户粘性与变现能力。

插件简介

本插件提供了一套完整的会员管理解决方案，包括：

• 会员等级：支持多级会员体系，每个等级可绑定 Halo 角色，实现内容权限控制
• 双账户系统：积分 + 余额，积分可通过签到/邀请获取，余额通过充值获取
• 签到系统：支持连续签到奖励阶梯、补签功能、前台签到组件
• 邀请推荐：三级奖励机制（访问/注册/购买），完善的防作弊体系
• 充值卡密：支持批量生成、CSV 导出，可用于余额和积分充值
• 内容收藏：用户可收藏文章内容，前端展示收藏状态

功能模块详解

1. 会员等级体系

核心能力

• 多级等级：创建任意数量的会员等级（如普通会员、银卡、金卡、钻石）
• 角色绑定：每个等级可绑定一个 Halo 角色，实现基于角色的内容权限控制
• 灵活定价：每个等级支持独立定价和有效期（天数，0 表示永久）
• 等级权益：每个等级可配置独立的权益参数

等级权益配置

每个等级可配置以下权益：

等级生命周期

1. 注册自动分配：用户注册时自动获得默认等级（可在设置中配置）
2. 购买升级：用户可购买更高等级，系统自动授予对应角色
3. 过期提醒：到期前 N 天（默认 7 天）发送提醒通知
4. 自动处理：到期后自动降级或切换到下一个可用等级
5. 角色回收：到期后自动移除对应角色

等级记录管理

• 查看所有用户的等级购买/续费记录
• 支持手动切换用户当前生效的等级
• 记录包含：开始时间、结束时间、金额、状态

2. 积分与余额系统

双账户体系

交易记录

所有积分和余额变动都有完整的交易记录，包含：

• 交易类型（22 种，涵盖所有业务场景）
• 交易金额（正数为增加，负数为减少）
• 交易状态（待处理/成功/失败/已取消）
• 关联业务（可跳转到等级记录、推荐记录、订单等）
• 操作时间、客户端 IP

积分兑换余额

• 支持配置兑换比例（默认 100 积分 = 1 元）
• 用户可在用户中心自行操作兑换

余额提现

• 可配置是否启用提现功能
• 支持设置最小/最大提现金额
• 支持配置提现手续费比例
• 提现申请需管理员审核

3. 每日签到系统

签到规则

• 每日可签到一次，获得基础积分/余额奖励
• 支持连续签到奖励阶梯（连续天数越多，奖励越丰厚）
• 支持补签功能（可配置补签费用、每月上限、可补签天数范围）

连续签到奖励

可配置多级连续签到奖励阶梯，示例：

补签功能

• 支持积分或余额补签（可配置）
• 可配置每月最大补签次数（默认 3 次）
• 可配置允许补签的天数范围（默认 7 天内）
• 补签同样计算连续天数和奖励

前台签到入口

插件自动在主题页面注入签到 Widget，支持以下配置：

• 启用/禁用前台签到入口
• Widget 显示模式（弹窗/侧边栏）
• Widget 位置（左上/右上/左下/右下）
• 用户中心链接地址

4. 邀请推荐系统

推荐码管理

• 每个会员可创建自己的推荐码
• 推荐码支持设置使用次数限制（-1 为不限）
• 推荐码支持设置有效期
• 推荐码自动生成 8 位唯一字符串

三级奖励机制

推荐码使用方式

• URL 参数：在任意页面 URL 后加 ?refcode=XXXX，系统自动捕获并保存到 Cookie（30 天有效）
• 邀请注册链接：/member/register?refcode=XXXX，直接跳转注册页面
• 邀请访问链接：/member/visit?refcode=XXXX，记录访问并跳转首页

推荐码折扣

• 支持基于推荐码的折扣计算
• 可配置推荐福利折扣比例
• 在用户中心可查看折扣详情

5. 充值卡密系统

卡密管理

• 批量生成：支持一次生成最多 1000 张卡密
• 灵活配置：卡密类型（余额/积分）、面值、前缀、长度（8-32 位）、有效期
• 批次管理：每批卡密有唯一批次号，便于追踪
• CSV 导出：支持导出卡密数据为 CSV 文件

卡密状态

卡密兑换

• 用户在用户中心输入卡密码即可兑换
• 兑换时自动校验卡密状态（禁用/已使用/过期/未生效）
• 兑换后自动增加对应账户余额或积分
• 记录兑换者 IP 和时间

6. 内容收藏系统

收藏功能

• 用户可收藏 Halo 文章内容
• 前端自动注入收藏 Widget 脚本
• 支持收藏状态查询和取消收藏
• 用户中心可查看所有收藏内容

管理后台功能

管理后台位于 Halo 后台「会员管理」菜单下，包含 9 个功能标签页：

概览面板

• KPI 卡片：会员总数、本期新增、交易金额、推荐注册数
• 趋势图表：会员增长趋势、交易金额趋势（支持日期范围筛选）
• 等级分布：各等级会员数量占比
• 运营摘要：会员资产汇总、推荐码统计、充值卡使用情况、签到统计

会员信息管理

• 查看所有会员列表（用户名、等级、积分、余额、状态等）
• 新增/编辑/删除会员
• 批量设置等级（统一设置或逐个指定）
• Excel/CSV 导入设置等级
• 一键同步等级（为未设置等级的会员自动匹配最高等级）
• 多维筛选：用户、等级、有效期、状态、排序、日期范围

会员等级管理

• 创建/编辑/删除等级
• 配置等级图标、名称、描述、价格、有效期
• 绑定 Halo 角色
• 配置等级权益（折扣/奖励/推荐码限制）
• 启用/禁用等级

等级记录管理

• 查看所有等级购买/续费记录
• 手动切换用户当前生效等级
• 筛选：用户、等级、状态、日期范围

卡密管理

• 查看所有卡密列表
• 创建单张/批量生成卡密
• 启用/禁用卡密
• 导出 CSV
• 筛选：类型、状态、批次号、日期范围

推荐码管理

• 查看所有推荐码
• 创建/编辑/删除推荐码
• 查看使用统计（访问/注册/购买次数）
• 筛选：所属用户、状态、日期范围

推荐记录管理

• 查看所有推荐行为记录
• 包含：推荐码、推荐者、被推荐者、行为类型、奖励值
• 筛选：推荐者、被推荐者、行为类型、奖励状态

交易记录管理

• 查看所有交易流水
• 交易类型用颜色区分（正数绿色/负数红色）
• 支持跳转关联业务（等级记录、推荐记录、订单）
• 筛选：用户、交易类型、业务类型、状态

签到记录管理

• 查看所有签到/补签记录
• 包含：用户、签到日期、连续天数、积分/余额奖励
• 筛选：用户、签到类型（正常/补签）

用户中心功能

用户中心位于 Halo 用户中心「会员管理」菜单下，包含 7 个功能标签页：

概览

• 当前会员等级信息
• 积分和余额余额
• 推荐码信息（可复制/新增/编辑/删除）
• 卡密兑换入口
• 等级续费/升级入口
• 交易记录和推荐记录快捷查看

会员等级

• 浏览所有可用等级（卡片式展示）
• 查看当前等级标识
• 升级/续费操作
• 等级切换（切换到已有的等级记录）

等级记录

• 查看个人等级购买/续费历史

推荐记录

• 查看个人推荐行为记录
• 包含：推荐码、被推荐者、行为类型、奖励状态

交易记录

• 查看个人交易流水明细

签到

• 签到日历可视化
• 每日签到 / 补签
• 签到规则说明
• 连续签到统计

我的收藏

• 查看所有收藏的文章内容
• 支持取消收藏

配置说明

插件提供 4 组配置，可在 Halo 后台「插件管理」→「设置」中进行配置：

通用设置

邀请设置

签到设置

支付设置

通知系统

插件提供 6 种通知模板，覆盖主要业务场景：

所有通知均支持纯文本和 HTML 两种格式，可在 Halo 通知模板中自定义样式。

安全与防滥用

插件内置多层防滥用机制，保护推荐系统不被恶意刷量：

注册频率限制

访问频率限制

重复检测

• 检测同一邀请码下是否有相同 IP 或设备指纹的注册/访问记录
• 基于设备指纹识别，有效防止浏览器多开等作弊手段

推荐码安全

• 推荐码使用次数限制
• 推荐码有效期限制
• 推荐码启用/禁用状态控制

常见问题

Q：用户注册后没有自动成为会员？

A：请检查「通用设置」中是否配置了默认等级。如果没有配置默认等级，用户注册后不会自动创建会员信息。

Q：签到 Widget 没有显示在前台？

A：请检查「签到设置」中是否启用了「前台签到入口」。如果启用了但仍不显示，可能是主题不支持 footer 扩展点，请尝试切换 Widget 显示模式。

Q：邀请推荐的奖励没有自动发放？

A：请检查「邀请设置」中是否启用了「自动处理奖励」。如果关闭了自动处理，奖励交易记录将处于待处理状态，需要管理员手动审核。

Q：等级到期后用户角色没有被回收？

A：请检查「通用设置」中是否启用了「自动切换等级」。如果启用了，系统会自动切换到下一个可用等级；如果没有可用等级，才会清除角色。

Q：充值卡密显示已过期但还在有效期内？

A：系统会在兑换时自动检查有效期，如果卡密已过期会自动更新状态。如果确认卡密在有效期内仍无法兑换，请检查服务器时间是否正确。