Przejdź do głównej zawartości

Konfiguracja White Label

Wymagana subskrypcja roczna

Funkcjonalność White Label jest dostępna wyłącznie dla użytkowników subskrypcji rocznej. Skontaktuj się z naszym zespołem wsparcia przez Telegram, aby uzyskać kod odblokowujący po zakupie planu rocznego.

Funkcja White Label pozwala dostosować branding TikMatrix do tożsamości Twojej firmy. Możesz zmodyfikować nazwę aplikacji, logo i informacje o marce, aby utworzyć spersonalizowaną wersję TikMatrix.

Funkcje​

Ustawienia podstawowe​

  • App Name: Dostosuj nazwę wyświetlaną aplikacji
  • Logo Upload: Prześlij niestandardowe główne logo (zalecane 128x128px)
  • Favicon: Ustaw niestandardową ikonę favicon dla aplikacji

Ustawienia marki​

  • Support Email: Adres e-mail wsparcia klienta
  • Tutorial URL: Link do niestandardowego tutorialu/dokumentacji
  • Telegram URL: Ustaw link do swojej grupy lub kanału Telegram

Przełączniki funkcji​

  • Show Tutorial Link: Kontroluj widoczność linku do tutoriala
  • Show Brand Info: Kontroluj wyświetlanie informacji o marce

Metody konfiguracji​

Metoda 1: Konfiguracja UI​

  1. Uruchom aplikację TikMatrix
  2. Kliknij ikonę palety 🎨 na pasku tytułu
  3. Skonfiguruj parametry w oknie dialogowym Ustawień White Label:
    • App Name: Wprowadź niestandardową nazwę aplikacji
    • Main Logo: Prześlij plik logo (PNG/JPG, zalecane 128x128px)
    • Support Email: Wprowadź adres e-mail wsparcia
    • Tutorial URL: Wprowadź niestandardowy URL tutoriala
    • Telegram URL: Wprowadź URL swojej grupy/kanału Telegram
    • Feature Toggles: Włącz/wyłącz linki do tutoriala i wyświetlanie informacji o marce
  4. Kliknij "Save", aby zastosować ustawienia

Metoda 2: Plik konfiguracyjny​

  1. Skopiuj przykładowy plik konfiguracyjny:

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

  2. Edytuj plik konfiguracyjny:

    {
      "appName": "Your App Name",
      "logo": {
        "main": "/path/to/your/logo.webp",
        "favicon": "/path/to/your/favicon.ico"
      },
      "brand": {
        "supportEmail": "support@yourcompany.com",
        "tutorialUrl": "https://yourcompany.com/docs",
        "telegramUrl": "https://t.me/yourgroup"
      },
      "features": {
        "showTutorialLink": true,
        "showBrandInfo": true
      }
    }

  3. Zapisz plik i uruchom ponownie aplikację

Metoda 3: Narzędzie wiersza poleceń​

  1. Przejdź do katalogu projektu:

    cd tikmatrix-desktop

  2. Uruchom narzędzie konfiguracyjne:

    node scripts/whitelabel-config.js

  3. Postępuj zgodnie z monitami, aby skonfigurować każdy parametr krok po kroku

Budowanie niestandardowej wersji​

1. Przygotuj pliki zasobów​

# Umieść pliki logo w odpowiednich lokalizacjach
src/assets/your-logo.webp       # Główne logo
public/your-favicon.ico        # Favicon internetowy
src-tauri/icons/               # Ikony aplikacji (różne rozmiary)

2. Skonfiguruj parametry budowania​

Użyj narzędzia wiersza poleceń lub ręcznie edytuj konfigurację:

# Używając narzędzia wiersza poleceń
node scripts/whitelabel-config.js

# Lub ręcznie edytuj
src/config/whitelabel-build.json

3. Zbuduj aplikację​

# Tryb deweloperski
npm run dev

# Budowanie produkcyjne
npm run build

# Budowanie aplikacji Tauri
npm run tauri build

Priorytet konfiguracji​

System używa następującej kolejności priorytetów dla konfiguracji:

  1. Runtime Config: LocalStorage przeglądarki whitelabel_config
  2. Build Config: src/config/whitelabel-build.json (używany podczas budowania)
  3. Example Config: examples/whitelabel-config.json
  4. Default Config: Wbudowane wartości domyślne
  • Format: PNG, JPG lub SVG
  • Rozmiar: 128x128px (zalecane)
  • Tło: Przezroczyste (dla PNG)
  • Użycie: Nagłówek, ekran powitalny, okno dialogowe o programie

Favicon​

  • Format: ICO lub PNG
  • Rozmiar: 32x32px lub 16x16px
  • Użycie: Zakładka przeglądarki, ikona okna

Ikony aplikacji (dla budów)​

  • Formaty: PNG, ICO, ICNS
  • Rozmiary: 32x32, 128x128, 256x256, 512x512
  • Lokalizacja: katalog src-tauri/icons/

Integracja API​

JavaScript API​

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

// Pobierz bieżącą konfigurację
const config = getWhiteLabelConfig();

// Zapisz nową konfigurację
saveWhiteLabelConfig(newConfig);

// Resetuj do wartości domyślnych
resetWhiteLabelConfig();

// Zweryfikuj konfigurację
validateWhiteLabelConfig(config);

Funkcje użytkowe​

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

// Inicjalizuj white label przy starcie aplikacji
initWhiteLabel();

// Zaktualizuj tytuł dokumentu
updateDocumentTitle('Your App Name');

// Zaktualizuj favicon
updateFavicon('/path/to/favicon.ico');

Najlepsze praktyki​

  • Używaj obrazów o wysokiej rozdzielczości dla ostrego wyświetlania
  • Zachowaj spójny branding we wszystkich rozmiarach logo
  • Testuj logo zarówno na jasnym, jak i ciemnym tle
  • Upewnij się, że logo są czytelne w małych rozmiarach

Spójność marki​

  • Używaj spójnych kolorów i czcionek w całej aplikacji
  • Dostosuj się do istniejących wytycznych marki
  • Testuj dostosowany interfejs na różnych rozmiarach ekranu
  • Zachowaj profesjonalny wygląd

Konfiguracja URL​

  • Używaj URL HTTPS dla wszystkich linków zewnętrznych
  • Testuj wszystkie linki przed wdrożeniem
  • Upewnij się, że kanały wsparcia są prawidłowo monitorowane
  • Aktualizuj URL dokumentacji na bieżąco

Rozwiązywanie problemów​

Typowe problemy​

Logo się nie wyświetla:

  • Sprawdź ścieżkę do pliku i uprawnienia
  • Zweryfikuj, czy format obrazu jest obsługiwany
  • Upewnij się, że rozmiar obrazu jest odpowiedni
  • Wyczyść pamięć podręczną przeglądarki i uruchom ponownie aplikację

Konfiguracja się nie zapisuje:

  • Sprawdź uprawnienia systemu plików
  • Zweryfikuj, czy składnia JSON jest poprawna
  • Upewnij się, że katalog konfiguracyjny istnieje
  • Spróbuj uruchomić jako administrator (jeśli to konieczne)

Budowanie się nie udaje:

  • Zweryfikuj, czy wszystkie pliki zasobów istnieją
  • Sprawdź składnię pliku konfiguracyjnego
  • Upewnij się, że pliki ikon są w poprawnym formacie
  • Przejrzyj dzienniki budowania pod kątem konkretnych błędów

Uzyskiwanie pomocy​

Jeśli napotkasz problemy z konfiguracją White Label:

  1. Sprawdź sekcję rozwiązywania problemów powyżej
  2. Przejrzyj składnię pliku konfiguracyjnego
  3. Skontaktuj się z pomocą techniczną przez Telegram
  4. Dołącz plik konfiguracyjny i komunikaty o błędach podczas zgłaszania problemów

Licencja i użytkowanie​

  • Funkcjonalność White Label jest dostępna tylko dla użytkowników subskrypcji rocznej
  • Prawa do niestandardowego brandingu są zawarte w Twojej subskrypcji
  • Redystrybucja dostosowanych wersji może wymagać dodatkowego licencjonowania
  • Skontaktuj się z pomocą techniczną w sprawie opcji licencjonowania dla przedsiębiorstw

Potrzebujesz kodu odblokowującego? Skontaktuj się z naszym zespołem wsparcia przez Telegram ze szczegółami swojej subskrypcji rocznej.