Subpartner system a referral tree

Jak funguje doporučení nového affiliate

  1. Existující affiliate sdílí referral link z dashboard záložky Subpartners — formát https://example.com/become-an-affiliate/?ref=ABC123.
  2. Nový partner klikne na link a otevře se mu registrační formulář s předvyplněným parent code.
  3. Po registraci se v wp_affinite_affiliates tabulce uloží parent_id vazba.

Tier struktura

Tier hloubka je konfigurovatelná v Settings → Subpartners → Subpartner Levels (default 3). Plugin akceptuje hodnoty 1–5.

Pro každou úroveň nastavte tier rate v procentech (Tier 2 Rate, Tier 3 Rate, Tier 4 Rate, Tier 5 Rate). Tier 1 = sazba affiliate samotného (z general nebo individuální).

Výpočet provizí pro multi-tier

Při vytvoření konverze plugin:

  1. Vytvoří provizi pro přímého affiliate (tier 1) podle jeho commission rate.
  2. Najde parent_id daného affiliate (subpartner relationship).
  3. Vytvoří provizi pro parent (tier 2) s tier 2 rate.
  4. Opakuje pro další úrovně až do max tier depth.

BFS team query

Pro načtení celého stromu downline plugin používá iterativní BFS (Breadth-First Search) s batched IN-clause queries:

  • O(depth) queries místo O(n) — pro 3-tier strom maximálně 3 queries bez ohledu na šířku.
  • Hard guards: max_depth = 10, max_members = 10 000 (prevence DoS přes DB cycle).
  • Cycle detection přes O(1) lookup mapu.

Subpartner statistiky v dashboardu

  • Direct referrals — počet přímých partnerů (tier 1 vůči přihlášenému affiliate).
  • Team size — celkový počet členů v downline (všechny tier).
  • Team earnings — celková suma provizí z konverzí přivedených týmem (status approved/paid).
  • Seznam subpartnerů — jméno, kód, status, tier level, datum registrace, lifetime earnings.