Перейти до основного вмісту

Налаштування White Label

Потрібна річна підписка

Функція White Label доступна виключно для користувачів із річною підпискою. Зверніться до нашої команди підтримки через Telegram, щоб отримати код розблокування після придбання річного плану.

Функція White Label дозволяє налаштувати брендинг TikMatrix відповідно до ідентичності вашої компанії. Ви можете змінити назву застосунку, логотип та інформацію про бренд, щоб створити персоналізовану версію TikMatrix.

Можливості​

Основні налаштування​

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

Налаштування бренду​

  • Email підтримки: адреса електронної пошти служби підтримки клієнтів
  • URL навчальних матеріалів: власне посилання на навчальні матеріали/документацію
  • URL Telegram: встановіть посилання на вашу групу чи канал Telegram

Перемикачі функцій​

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

Способи налаштування​

Спосіб 1: налаштування через інтерфейс​

  1. Запустіть застосунок TikMatrix
  2. Натисніть іконку палітри 🎨 у рядку заголовка
  3. Налаштуйте параметри в діалоговому вікні White Label:
    • Назва застосунку: введіть власну назву застосунку
    • Основний логотип: завантажте файл логотипа (PNG/JPG, рекомендовано 128x128px)
    • Email підтримки: введіть адресу електронної пошти вашої підтримки
    • URL навчальних матеріалів: введіть власний URL навчальних матеріалів
    • URL Telegram: введіть URL вашої групи/каналу Telegram
    • Перемикачі функцій: увімкніть/вимкніть посилання на навчальні матеріали та відображення інформації про бренд
  4. Натисніть «Зберегти», щоб застосувати налаштування

Спосіб 2: файл конфігурації​

  1. Скопіюйте приклад файлу конфігурації:

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

  2. Відредагуйте файл конфігурації:

    {
      "appName": "Назва вашого застосунку",
      "logo": {
        "main": "/шлях/до/вашого/logo.webp",
        "favicon": "/шлях/до/вашого/favicon.ico"
      },
      "brand": {
        "supportEmail": "support@vashakompaniya.com",
        "tutorialUrl": "https://vashakompaniya.com/docs",
        "telegramUrl": "https://t.me/vashagrupa"
      },
      "features": {
        "showTutorialLink": true,
        "showBrandInfo": true
      }
    }

  3. Збережіть файл і перезапустіть застосунок

Спосіб 3: інструмент командного рядка​

  1. Перейдіть до каталогу проєкту:

    cd tikmatrix-desktop

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

    node scripts/whitelabel-config.js

  3. Дотримуйтеся підказок, щоб налаштувати кожен параметр крок за кроком

Збірка власної версії​

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

# Розмістіть файли вашого логотипа в правильних місцях
src/assets/your-logo.webp       # Основний логотип
public/your-favicon.ico        # Веб-favicon
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. Конфігурація виконання: LocalStorage браузера whitelabel_config
  2. Конфігурація збірки: src/config/whitelabel-build.json (використовується під час збірки)
  3. Приклад конфігурації: examples/whitelabel-config.json
  4. Конфігурація за замовчуванням: вбудовані значення за замовчуванням

Вимоги до логотипа​

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

  • Формат: PNG, JPG або SVG
  • Розмір: 128x128px (рекомендовано)
  • Фон: прозорий (для PNG)
  • Використання: заголовок, екран заставки, діалог «Про програму»

Favicon​

  • Формат: 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';

// Ініціалізувати white label при запуску застосунку
initWhiteLabel();

// Оновити заголовок документа
updateDocumentTitle('Назва вашого застосунку');

// Оновити favicon
updateFavicon('/шлях/до/favicon.ico');

Найкращі практики​

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

  • Використовуйте зображення високої роздільної здатності для чіткого відображення
  • Підтримуйте узгоджений брендинг для всіх розмірів логотипа
  • Тестуйте логотипи як на світлому, так і на темному фоні
  • Переконайтеся, що логотипи читабельні при малих розмірах

Узгодженість бренду​

  • Використовуйте узгоджені кольори та шрифти всюди
  • Дотримуйтесь наявних настанов вашого бренду
  • Тестуйте налаштований інтерфейс на різних розмірах екрана
  • Підтримуйте професійний вигляд

Налаштування URL​

  • Використовуйте HTTPS URL для всіх зовнішніх посилань
  • Тестуйте всі посилання перед розгортанням
  • Переконайтеся, що канали підтримки належно відстежуються
  • Підтримуйте URL документації в актуальному стані

Усунення несправностей​

Поширені проблеми​

Логотип не відображається:

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

Конфігурація не зберігається:

  • Перевірте дозволи файлової системи
  • Переконайтеся, що синтаксис JSON правильний
  • Переконайтеся, що каталог конфігурації існує
  • Спробуйте запустити від імені адміністратора (за потреби)

Збірка не вдається:

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

Отримання допомоги​

Якщо ви зіткнулися з проблемами під час налаштування White Label:

  1. Перевірте розділ усунення несправностей вище
  2. Перегляньте синтаксис файлу конфігурації
  3. Зверніться до підтримки через Telegram
  4. Додайте свій файл конфігурації та повідомлення про помилки, коли повідомляєте про проблеми

Ліцензія та використання​

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

Потрібен код розблокування? Зверніться до нашої команди підтримки через Telegram з деталями вашої річної підписки.