Personnalisation

Où dans l'administration : System › Settings › Brand (/settings/branding). Similaire : System › Settings › General (/settings) pour les URL et les coordonnées du vendeur indiquées sur les factures.

Description

NexCMP est en marque blanche : le produit ne porte aucun nom de fournisseur et tout ce que vos clients voient est votre marque. Les paramètres de marque s'appliquent aux pages de connexion et d'inscription, au portail, à la console d'administration et aux e-mails.

Prérequis

Élément	Prérequis
Rôle	Un administrateur.
Fichiers	Logos : SVG, PNG, JPEG, WEBP ou ICO, jusqu'à 512 Ko chacun.
Dépendances	Aucune.

Étapes

1. Open System › Settings › Brand.

2. Dans la carte Identity, renseignez :

   Champ	Remarques
   Brand name (required)	Jusqu'à 60 caractères. Affiché dans le portail, les e-mails, les factures et les pages légales.
   Nom du vendeur sur les factures	Jusqu'à 120 caractères. Vide signifie le nom de la marque.
   Brand color	Une couleur #rrggbb ; le petit bouton à côté du champ la réinitialise à la couleur intégrée.
   Site currency	USD : les prix et les soldes sont affichés uniquement en USD, sans sélecteur de devise. VND : affiche également le montant converti au taux de change enregistré (voir Currency and exchange rates).

3. Cliquez sur Save.

4. Dans la carte Logo & favicon, téléchargez les trois images — Logo (fond clair), Logo (fond sombre) et Favicon — à l'aide de Upload (ou de Replace) ; Remove permet d'en supprimer une.

Paramètres associés dans General

System › Settings › General comporte deux onglets qui complètent le tableau :

Onglet	Champs
Branding & URLs	Nom de marque (e-mail, factures), langue par défaut (anglais ou vietnamien), Customer app URL, Console URL, Admin URL (lien d'usurpation de revendeur) et Partner console URL (liens d'invitation, e-mails de revendeur). L'assistant d'installation remplit ces champs avec https://<domain>, https://<domain>/admin et https://<domain>/console.
Seller & invoicing	Nom de l'entité juridique, numéro de TVA, adresse, e-mail de contact et préfixe de numéro de facture. Voir Invoices and ledger.

Le nom d'expéditeur (From name) des e-mails se configure dans System › Settings › Email (SMTP and e-mails).

Vérification des fichiers téléchargés

• Les images matricielles sont reconnues d'après leur contenu (et non d'après le nom du fichier) et mesurées.
• Les fichiers SVG sont régénérés à partir d'une liste sécurisée de formes. Tout fichier contenant des scripts, foreignObject, des attributs d'événements, des liens externes, url(...) pointant vers l'extérieur, un DOCTYPE ou des entités est refusé (svg_unsafe).
• Un fichier trop volumineux est refusé avec asset_too_large, un type incorrect avec asset_type, de mauvaises dimensions avec asset_dimensions.
• Les fichiers sont servis depuis votre propre domaine avec des en-têtes de sécurité stricts.

Vérification

1. Ouvrez la page de connexion du portail dans une fenêtre privée : le logo, le nom et la couleur apparaissent.
2. Vérifiez l'onglet du navigateur pour le favicon (les navigateurs mettent les favicons en cache ; rechargez en vidant le cache si vous voyez toujours l'ancien).
3. Déclenchez un e-mail de test (par exemple Send reset link pour un client test) et vérifiez le nom de la marque dans l'objet et le pied de page.

Limites et notes

• Le logo pour fond sombre est utilisé lorsque le client ou l'administrateur bascule sur le thème sombre.
• Les revendeurs possèdent leur propre marque ; ils téléchargent des fichiers PNG, JPEG, WEBP ou ICO jusqu'à 256 Ko (pas de SVG). Voir Resellers.
• Une modification de la couleur de marque ou du logo s'affiche au chargement de page suivant ; les e-mails déjà envoyés ne sont pas modifiés.

Dépannage

Symptôme	Cause	Solution
Téléchargement refusé : svg_unsafe	Le SVG contient des scripts, des liens ou des références externes	Exportez un SVG simple (sans script ni images externes) ou utilisez le format PNG.
asset_too_large	Fichier supérieur à 512 Ko	Compressez ou redimensionnez l'image.
asset_type	Format non pris en charge (ni SVG, ni PNG, ni JPEG, ni WEBP, ni ICO)	Convertissez le fichier.
invalid_argument: primary	La couleur n'est pas #rrggbb	Utilisez une valeur hexadécimale à six chiffres.
Ancien logo toujours visible	Cache du navigateur	Effectuez un rechargement forcé ; les favicons peuvent prendre plus de temps.
Les prix s'affichent uniquement en USD	La devise du site est l'USD	Passez au VND et assurez-vous qu'un taux de change est enregistré.