快速入門

Reseller Manager 把 WHMCS 管理員變成二級分銷網路。這份指南帶你從安裝走到第一筆佣金入帳，整個流程不超過 15 分鐘。

1. 安裝並啟用

1. 下載 reseller_manager_v1.0.0.zip 解壓到 WHMCS 根目錄。
2. WHMCS 管理後台 → 設定 → 插件管理 → Reseller Manager → 啟用。
3. 勾選可存取本模組的管理員角色，填入授權金鑰，點 儲存變更。

啟用後頂部選單 應用 → Reseller Manager 即可進入。啟用時會自動建立 6 張資料表:mod_reseller_admins、mod_reseller_customers、mod_reseller_commissions、mod_reseller_audit_log、mod_reseller_notifications、mod_reseller_config。

2. 標記第一個分銷商

在 分銷商 標籤(最左邊)會列出所有 WHMCS 管理員。把其中一個標記為分銷商:

1. 該列點 設定。
2. 填 新單佣金比例 (%) 和 續費佣金比例 (%) —— 例如 5 / 3 表示新單金額 5%、續費金額 3% 給該分銷商。
3. 上級分銷商 暫時保留 — (頂級)(第 4 步再加二級層)。
4. 儲存。該管理員現在帶綠色 分銷商 標識。

3. 分配客戶

分銷商獲取客戶的兩種方式:

A. 管理員分配 —— 進入 客戶池(分銷商需 superadmin 身份才能看這個視圖),對已分配客戶點 釋放到資源池 讓它可認領;或者直接 認領 給指定分銷商。

B. 分銷商自助認領 —— 分銷商登入 WHMCS 後進入 應用 → Reseller Manager → 客戶池。未分配的客戶會顯示帶 認領 按鈕。認領後該分銷商有 30 天時間讓客戶產生首單,否則客戶自動退回資源池。

4. 增加二級層(二級分銷)

這是核心賣點。把第二個管理員標記為分銷商時:

1. 該列點 設定。
2. 像之前一樣填 新單/續費比例(該分銷商自己的直推佣金)。
3. 上級分銷商 —— 從下拉選擇一個上級。自動檢測循環依賴。
4. 間推新單比例 (%) / 間推續費比例 (%) —— 上級 在該分銷商出單時拿到的比例。例如上級在每筆下級訂單上拿 2% / 1%。
5. 儲存。

之後每張下級分銷商客戶付款的發票會觸發兩筆佣金記錄:level=1 給下級(直推)+ level=2 給上級(間推)。兩筆都在 佣金 標籤可見,狀態 pending。

5. 追蹤與確認佣金

佣金 標籤列出所有佣金,支援按分銷商 / 狀態 / 時間範圍篩選。

• 預設新記錄為 pending(待確認) → 可確認(confirmed)再標 paid。
• 用 CSV 匯出 給會計 —— 匯出檔含 level 欄(1=直推,2=間推)。

6. 重要設定項

設定 頁常用項:

• 資源池保留天數 —— 分銷商認領後必須在多少天內產生首單(預設 30)。
• 提醒天數 —— 即將到期發票提前幾天郵件提醒分銷商(預設 7,3,1)。
• 分銷商可編輯比例 —— 是否允許下級分銷商自行修改佣金比例(預設關閉)。
• 每頁列數 —— 表格每頁列數(預設 20)。

7. 下級分銷商能看到什麼

關鍵:下級分銷商(任何被標為分銷商的管理員)只能看到 自己的 客戶和 自己的 佣金。視圖永遠不暴露其下級的具體客戶清單 —— 只顯示彙總(下級數量、訂單筆數、佣金總額)。

這是有意設計:上級分銷商可以稽核下級業務的彙總資料,但看不到對方的客戶名單,保護下級的客戶資源。