快速开始

Reseller Manager 把 WHMCS 管理员变成二级分销网络。这份指南带你从安装走到第一笔佣金入账，整个过程不超过 15 分钟。

1. 安装并激活

下载 reseller_manager_v1.0.0.zip 解压到 WHMCS 根目录。
WHMCS 管理后台 → 配置 → 插件管理 → Reseller Manager → 激活。
勾选可访问本模块的管理员角色，填入授权密钥，点 保存修改。

激活后顶部菜单 应用 → Reseller Manager 即可进入。激活时会自动创建 6 张表：mod_reseller_admins、mod_reseller_customers、mod_reseller_commissions、mod_reseller_audit_log、mod_reseller_notifications、mod_reseller_config。

2. 标记第一个分销商

在 分销商 标签（最左边）会列出所有 WHMCS 管理员。把其中一个标记为分销商：

该行点设置。
填 新单佣金比例 (%) 和 续费佣金比例 (%) —— 例如 5 / 3 表示新单金额 5%、续费金额 3% 给该分销商。
上级分销商 暂时保留 — (顶级)（第 4 步再加二级层）。
保存。该管理员现在带绿色 分销商 标识。

3. 分配客户

分销商获取客户的两种方式：

A. 管理员分配 —— 进入 客户池（分销商需 superadmin 身份才能看这个视图），对已分配客户点 释放到资源池 让它可认领；或者直接认领给指定分销商。

B. 分销商自助认领 —— 分销商登录 WHMCS 后进入 应用 → Reseller Manager → 客户池。未分配的客户会显示带认领按钮。认领后该分销商有 30 天时间让客户产生首单，否则客户自动退回资源池。

4. 添加二级层（二级分销）

这是核心卖点。把第二个管理员标记为分销商时：

该行点设置。
像之前一样填 新单/续费比例（该分销商自己的直推佣金）。
上级分销商 —— 从下拉选择一个上级。自动检测循环依赖。
间推新单比例 (%) / 间推续费比例 (%) —— 上级在该分销商出单时拿到的比例。例如上级在每笔下级订单上拿 2% / 1%。
保存。

之后每张下级分销商客户付款的发票会触发两笔佣金记录：level=1 给下级（直推）+ level=2 给上级（间推）。两笔都在佣金标签可见，状态 pending。

5. 追踪与确认佣金

佣金标签列出所有佣金，支持按分销商 / 状态 / 时间范围筛选。

默认新记录为 pending（待确认） → 可确认（confirmed）再标 paid。
用 CSV 导出 给会计 —— 导出文件含 level 列（1=直推，2=间推）。

6. 重要设置项

设置页常用项：

资源池保留天数 —— 分销商认领后必须在多少天内产生首单（默认 30）。
提醒天数 —— 即将到期发票提前几天邮件提醒分销商（默认 7,3,1）。
分销商可编辑比例 —— 是否允许下级分销商自行修改佣金比例（默认关闭）。
每页行数 —— 表格每页行数（默认 20）。

7. 下级分销商能看到什么

关键：下级分销商（任何被标为分销商的管理员）只能看到 自己的 客户和 自己的 佣金。视图永远不暴露其下级的具体客户清单 —— 只显示汇总（下级数量、订单笔数、佣金总额）。

这是有意设计：上级分销商可以审计下级业务的汇总数据，但看不到对方的客户名单，保护下级的客户资源。