White-Label : comment ça marche

1. Côté client

Après avoir acheté le White-Label Pack (ou avoir un abonnement Elite actif), les clients re-téléchargent simplement leurs addons depuis leur compte. Le serveur détecte leur statut White-Label au moment du téléchargement et sert le ZIP sans branding à la place du standard — si une version White-Label a été uploadée pour cet addon.

Si aucune version White-Label n'est disponible pour un addon, le client reçoit le ZIP standard (fallback transparent). Pas d'erreur, pas d'alerte — le retrait du branding est best-effort par addon.

2. Côté développeur d'addon

Quand vous publiez un addon sur xen-support.com, vous pouvez optionnellement uploader DEUX ZIPs depuis le formulaire admin :

• ZIP standard — avec le footer/copyright "Powered by XenSupport". Servi à tous les clients sans WL.
• ZIP White-Label (optionnel) — addon identique, mais avec tout le branding retiré des templates / phrases / footers publics. Servi aux clients White-Label.

Le serveur choisit le bon ZIP au download selon user_has_branding_removed() — qui vérifie l'abonnement Elite + le Pack Lifetime + les grants per-extension. Le client ne choisit pas ; on choisit pour lui.

3. Préparer le ZIP White-Label

Pour chaque élément brandé de votre addon standard, produisez une version épurée :

• Retirez le footer "Powered by XenSupport" des templates publics.
• Retirez les phrases / chaînes de copyright (généralement *_copyright, *_powered_by, etc.).
• Laissez la fiche addon ACP telle quelle — rien à retirer (vu par le client, pas par ses membres).
• Gardez le même id et la même version dans addon.json : l'upgrade entre les deux doit être propre.

4. Uploader les deux ZIPs côté admin

Dans /admin/extensions/{id}/edit, vous trouverez deux champs upload sous « Archive livrée à l'acheteur » :

• file — ZIP standard (obligatoire à la création).
• file_whitelabel — ZIP White-Label (optionnel ; uploadable plus tard).

La liste admin extensions (/admin/extensions) affiche une colonne WL ✓/✗ pour voir d'un coup d'œil quels addons attendent encore leur version White-Label.

5. Comportement de fallback

Si aucun ZIP White-Label n'est uploadé, tous les clients (WL ou non) reçoivent le ZIP standard. C'est intentionnel : avoir un catalogue WL partiel est OK. À mesure que vous ajoutez des ZIPs WL, plus de clients en bénéficient. Pas de migration big-bang nécessaire.

6. Audit / observabilité

Chaque téléchargement White-Label est tracé via l'événement security_audit « download.whitelabel_served » avec { user_id, ext_id, item_id }. Utile pour mesurer l'usage du Pack/Elite dans vos rapports.

7. Besoin d'aide ?

Ouvrez un ticket depuis votre compte, ou consultez la doc API sur /docs/api.