Брендинг

В панели управления: System › Settings › Brand (/settings/branding). См. также: System › Settings › General (/settings) для настройки URL и реквизитов продавца для счетов.

Назначение

NexCMP работает по модели white-label: в продукте не упоминается разработчик, и клиенты видят исключительно ваш бренд. Настройки бренда применяются к страницам входа и регистрации, порталу, панели управления и e-mail.

Требования

Параметр	Требование
Роль	Администратор.
Файлы	Логотипы: SVG, PNG, JPEG, WEBP или ICO, до 512 КБ каждый.
Зависимости	Нет.

Шаги

1. Откройте System › Settings › Brand.

2. В блоке Identity заполните:

   Поле	Примечания
   Brand name (обязательно)	До 60 символов. Отображается в портале, письмах, счетах и на юридических страницах.
   Наименование продавца в счетах	До 120 символов. Если не заполнено, используется название бренда.
   Brand color	Цвет в формате #rrggbb; небольшая кнопка рядом с полем сбрасывает значение к исходному цвету.
   Site currency	USD: цены и балансы отображаются только в USD, без переключения валюты. VND: также отображается конвертированная сумма по сохраненному курсу (см. Валюта и обменные курсы).

3. Нажмите Save.

4. В карточке Logo & favicon загрузите три изображения — Logo (light background), Logo (dark background) и Favicon — с помощью Upload (или Replace); Remove удаляет изображение.

Связанные настройки в General

В разделе System › Settings › General есть две вкладки, дополняющие эти параметры:

Вкладка	Поля
Branding & URLs	Название бренда (email, счета), язык по умолчанию (English или Vietnamese), Customer app URL, Console URL, Admin URL (ссылка для олицетворения реселлера) и Partner console URL (ссылки-приглашения, email реселлеров). Мастер настройки заполняет их значениями https://<domain>, https://<domain>/admin и https://<domain>/console.
Seller & invoicing	Название юрлица, ИНН/налоговый номер, адрес, контактный email и префикс номера счета. См. Счета и журнал операций.

Параметр From name для email настраивается в System › Settings › Email (SMTP и электронная почта).

Проверка загружаемых файлов

• Растровые изображения распознаются по их содержимому (а не по имени файла) и проверяются по размеру.
• SVG-файлы пересобираются по белому списку безопасных фигур. Файл, содержащий скрипты, foreignObject, атрибуты событий, внешние ссылки, теги url(...) с внешними адресами, DOCTYPE или сущности, отклоняется (svg_unsafe).
• Слишком большой файл отклоняется с ошибкой asset_too_large, неверный тип — с asset_type, неподдерживаемые размеры — с asset_dimensions.
• Файлы отдаются с вашего собственного домена со строгими заголовками безопасности.

Проверка

1. Откройте страницу входа в портал в приватном окне: отобразятся логотип, название и цвет.
2. Проверьте favicon на вкладке браузера (браузеры кэшируют favicons; если отображается старый, обновите страницу с очисткой кэша).
3. Отправьте тестовое письмо (например, Send reset link для тестового клиента) и проверьте название бренда в теме и подвале.

Ограничения и примечания

• Логотип для темного фона используется, когда клиент или администратор переключается на темную тему.
• У реселлеров собственный брендинг; они могут загружать файлы PNG, JPEG, WEBP или ICO размером до 256 КБ (без SVG). См. Реселлеры.
• Изменение цвета бренда или логотипа применяется при следующей загрузке страницы; уже отправленные письма не изменяются.

Устранение неполадок

Симптом	Причина	Решение
Загрузка отклонена: svg_unsafe	SVG содержит скрипты, ссылки или внешние ресурсы	Экспортируйте чистый SVG (без скриптов и внешних изображений) или используйте PNG.
asset_too_large	Файл больше 512 КБ	Сожмите файл или уменьшите разрешение изображения.
asset_type	Формат отличается от SVG, PNG, JPEG, WEBP или ICO	Конвертируйте файл.
invalid_argument: primary	Цвет не соответствует формату #rrggbb	Используйте шестизначный HEX-код.
По-прежнему виден старый логотип	Кэш браузера	Выполните жесткую перезагрузку страницы; обновление favicon может занять больше времени.
Цены отображаются только в USD	Основная валюта сайта — USD	Переключитесь на VND и убедитесь, что обменный курс сохранен.