Перейти к основному содержанию

Настройка белой метки

Требуется годовая подписка

Функциональность белой метки доступна исключительно для пользователей с годовой подпиской. Свяжитесь с нашей службой поддержки через Telegram, чтобы получить код разблокировки после покупки годового плана.

Функция белой метки позволяет настроить брендинг TikZenX в соответствии с корпоративной идентичностью вашей компании. Вы можете изменить название приложения, логотип и информацию о бренде, чтобы создать персонализированную версию TikZenX.

Функции​

Основные настройки​

  • Название приложения: Настройка отображаемого названия приложения
  • Загрузка логотипа: Загрузите свой основной логотип (рекомендуется 128x128px)
  • Фавикон: Установка пользовательского фавикона для приложения

Настройки бренда​

  • Email поддержки: Адрес электронной почты службы поддержки клиентов
  • URL обучения: Ссылка на пользовательские обучающие материалы/документацию
  • URL Telegram: Установка ссылки на вашу группу или канал Telegram

Переключатели функций​

  • Показать ссылку на обучение: Управление видимостью ссылки на обучение
  • Показать информацию о бренде: Управление отображением информации о бренде

Методы настройки​

Метод 1: Настройка через интерфейс​

  1. Запустите приложение TikZenX
  2. Нажмите на значок палитры 🎨 в заголовке окна
  3. Настройте параметры в диалоге настроек белой метки:
    • Название приложения: Введите название вашего приложения
    • Основной логотип: Загрузите файл логотипа (PNG/JPG, рекомендуется 128x128px)
    • Email поддержки: Введите адрес электронной почты службы поддержки
    • URL обучения: Введите URL ваших обучающих материалов
    • URL Telegram: Введите ссылку на вашу группу/канал Telegram
    • Переключатели функций: Включите/отключите отображение ссылок на обучение и информации о бренде
  4. Нажмите "Сохранить" для применения настроек

Метод 2: Файл конфигурации​

  1. Скопируйте пример файла конфигурации:

    cp examples/whitelabel-config.json src/config/whitelabel-custom.json

  2. Отредактируйте файл конфигурации:

    {
      "appName": "Название вашего приложения",
      "logo": {
        "main": "/path/to/your/logo.png",
        "favicon": "/path/to/your/favicon.ico"
      },
      "brand": {
        "supportEmail": "[email protected]",
        "tutorialUrl": "https://yourcompany.com/docs",
        "telegramUrl": "https://t.me/yourgroup"
      },
      "features": {
        "showTutorialLink": true,
        "showBrandInfo": true
      }
    }

  3. Сохраните файл и перезапустите приложение

Метод 3: Инструмент командной строки​

  1. Перейдите в директорию проекта:

    cd tiktok-matrix

  2. Запустите инструмент конфигурации:

    node scripts/whitelabel-config.js

  3. Следуйте подсказкам для пошаговой настройки каждого параметра

Сборка пользовательской версии​

1. Подготовка файлов ресурсов​

# Поместите файлы логотипов в правильные места
src/assets/your-logo.png       # Основной логотип
public/your-favicon.ico        # Веб-фавикон
src-tauri/icons/               # Иконки приложения (различные размеры)

2. Настройка параметров сборки​

Используйте инструмент командной строки или отредактируйте конфигурацию вручную:

# Использование инструмента командной строки
node scripts/whitelabel-config.js

# Или ручное редактирование
src/config/whitelabel-build.json

3. Сборка приложения​

# Режим разработки
npm run dev

# Продуктивная сборка
npm run build

# Сборка приложения Tauri
npm run tauri build

Приоритет конфигурации​

Система использует следующий порядок приоритета для конфигурации:

  1. Конфигурация времени выполнения: whitelabel_config в LocalStorage браузера
  2. Конфигурация сборки: src/config/whitelabel-build.json (используется при сборке)
  3. Пример конфигурации: examples/whitelabel-config.json
  4. Конфигурация по умолчанию: Встроенные значения по умолчанию

Требования к логотипу​

Основной логотип​

  • Формат: PNG, JPG или SVG
  • Размер: 128x128px (рекомендуется)
  • Фон: Прозрачный (для PNG)
  • Использование: Заголовок, экран загрузки, диалог "О программе"

Фавикон​

  • Формат: ICO или PNG
  • Размер: 32x32px или 16x16px
  • Использование: Вкладка браузера, иконка окна

Иконки приложения (для сборок)​

  • Форматы: PNG, ICO, ICNS
  • Размеры: 32x32, 128x128, 256x256, 512x512
  • Расположение: директория src-tauri/icons/

Интеграция API​

JavaScript API​

import { 
  getWhiteLabelConfig,
  saveWhiteLabelConfig, 
  resetWhiteLabelConfig,
  validateWhiteLabelConfig 
} from './config/whitelabel.js';

// Получить текущую конфигурацию
const config = getWhiteLabelConfig();

// Сохранить новую конфигурацию
saveWhiteLabelConfig(newConfig);

// Сбросить к значениям по умолчанию
resetWhiteLabelConfig();

// Проверить конфигурацию
validateWhiteLabelConfig(config);

Утилитарные функции​

import { 
  initWhiteLabel,
  updateDocumentTitle,
  updateFavicon
} from './utils/whitelabel.js';

// Инициализация белой метки при запуске приложения
initWhiteLabel();

// Обновить заголовок документа
updateDocumentTitle('Название вашего приложения');

// Обновить фавикон
updateFavicon('/path/to/favicon.ico');

Лучшие практики​

Дизайн логотипа​

  • Используйте изображения высокого разрешения для четкого отображения
  • Поддерживайте согласованный брендинг во всех размерах логотипа
  • Тестируйте логотипы как на светлом, так и на темном фоне
  • Убедитесь, что логотипы читаемы в малых размерах

Согласованность бренда​

  • Используйте согласованные цвета и шрифты по всему интерфейсу
  • Придерживайтесь существующих рекомендаций по бренду
  • Тестируйте настроенный интерфейс на разных размерах экрана
  • Поддерживайте профессиональный вид

Конфигурация URL​

  • Используйте HTTPS URL для всех внешних ссылок
  • Тестируйте все ссылки перед развертыванием
  • Убедитесь, что каналы поддержки должным образом отслеживаются
  • Поддерживайте URL документации в актуальном состоянии

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

Общие проблемы​

Логотип не отображается:

  • Проверьте путь к файлу и разрешения
  • Убедитесь, что формат изображения поддерживается
  • Убедитесь, что размер изображения подходящий
  • Очистите кэш браузера и перезапустите приложение

Конфигурация не сохраняется:

  • Проверьте разрешения файловой системы
  • Убедитесь, что синтаксис JSON правильный
  • Убедитесь, что директория конфигурации существует
  • Попробуйте запустить от имени администратора (при необходимости)

Сборка не удается:

  • Убедитесь, что все файлы ресурсов существуют
  • Проверьте синтаксис файла конфигурации
  • Убедитесь, что файлы иконок в правильном формате
  • Просмотрите журналы сборки для конкретных ошибок

Получение помощи​

Если у вас возникли проблемы с настройкой белой метки:

  1. Проверьте раздел устранения неполадок выше
  2. Просмотрите синтаксис файла конфигурации
  3. Свяжитесь с поддержкой через Telegram
  4. Включите ваш файл конфигурации и сообщения об ошибках при сообщении о проблемах

Лицензия и использование​

  • Функциональность белой метки доступна только для пользователей с годовой подпиской
  • Права на пользовательский брендинг включены в вашу подписку
  • Распространение настроенных версий может потребовать дополнительного лицензирования
  • Свяжитесь с поддержкой для получения вариантов корпоративного лицензирования

Нужен код разблокировки? Свяжитесь с нашей службой поддержки через Telegram с деталями вашей годовой подписки.