Branding

Where in the admin: System › Settings › Brand (/settings/branding)。相关：System › Settings › General (/settings) 用于设置 URL 以及打印在发票上的卖家详细信息。

功能说明

NexCMP 采用白标设计：产品不带任何供应商名称，客户看到的一切均是您的品牌。品牌设置适用于登录页、注册页、门户、管理控制台和电子邮件。

前提条件

项目	要求
角色	管理员。
Files	徽标：SVG、PNG、JPEG、WEBP 或 ICO，每个最大 512 KB。
依赖项	无。

步骤

1. 打开 System › Settings › Brand。

2. 在 Identity 卡片中填写：

   字段	备注
   Brand name（必填）	最多 60 个字符。显示在门户、电子邮件、发票和法律页面中。
   发票上的卖家名称	最多 120 个字符。留空则使用品牌名称。
   Brand color	一个 #rrggbb 颜色；字段旁边的按钮可将其重置为内置颜色。
   Site currency	USD：价格和余额仅以 USD 显示，无货币切换功能。VND：同时按存储的汇率显示转换后的金额（参见Currency and exchange rates）。

3. 点击Save。

4. 在卡片 Logo & favicon 中通过 Upload（或 Replace）上传三张图片——Logo (light background)、Logo (dark background) 和 Favicon；Remove 用于删除其中一张。

General 中的相关设置

System › Settings › General 有两个标签页用于完善完整信息：

标签页	字段
Branding & URLs	品牌名称（电子邮件、发票）、默认语言（英文或越南语）、Customer app URL、Console URL、Admin URL（分销商代登录链接）以及 Partner console URL（邀请链接、分销商电子邮件）。安装向导会使用 https://<domain>、https://<domain>/admin 和 https://<domain>/console 填充这些内容。
Seller & invoicing	法人实体名称、税号、地址、联系电子邮件以及发票号前缀。参见 Invoices and ledger。

电子邮件的 From name 在 System › Settings › Email（SMTP and e-mails）中设置。

已上传文件的检查

• 系统会根据光栅图像的内容（而非文件名）进行识别和尺寸测量。
• SVG文件会使用安全的图形白名单进行重建。包含脚本、foreignObject、事件属性、指向外部的url(...)、DOCTYPE或实体文件的文件将被拒绝（svg_unsafe）。
• 文件过大会被 asset_too_large 拒绝，类型错误会被 asset_type 拒绝，尺寸错误会被 asset_dimensions 拒绝。
• 文件通过你自己的域名提供服务，并带有严格的安全标头。

验证

1. 在隐私窗口中打开门户登录页面：将显示徽标、名称和颜色。
2. 检查浏览器标签页中的 favicon（浏览器会缓存 favicon；如果仍看到旧的，请清除缓存后重新加载）。
3. 触发测试电子邮件（例如为测试客户发送 Send reset link），并检查主题和页脚中的品牌名称。

限制与注意事项

• 当客户或管理员切换到深色主题时，将使用深色背景的 Logo。
• 分销商拥有自己的品牌；他们可以上传最大 256 KB 的 PNG、JPEG、WEBP 或 ICO（不支持 SVG）。参见 Resellers。
• 对品牌颜色或 Logo 的更改会在下次加载页面时生效；已发送的电子邮件不会改变。

故障排查

症状	原因	解决办法
上传被拒绝：svg_unsafe	SVG 包含脚本、链接或外部引用	导出纯 SVG（无脚本、无外部图像）或使用 PNG。
asset_too_large	文件超过 512 KB	压缩或调整图像尺寸。
asset_type	不是 SVG、PNG、JPEG、WEBP 或 ICO	转换文件格式。
invalid_argument: primary	颜色不是 #rrggbb	使用六位十六进制值。
旧 Logo 仍然可见	浏览器缓存	强制重新加载；favicon 可能需要更长时间。
价格仅以 USD 显示	站点货币为 USD	切换到 VND 并确保已存储汇率。