Passa al contenuto principale

Configurazione White Label

Richiede Abbonamento Annuale

La funzionalità White Label è disponibile esclusivamente per gli utenti con Abbonamento Annuale. Contatta il nostro team di assistenza via Telegram per ottenere il tuo codice di sblocco dopo aver acquistato un piano annuale.

La funzione White Label ti permette di personalizzare il branding di TikMatrix per adattarlo all'identità della tua azienda. Puoi modificare il nome dell'app, il logo e le informazioni del brand per creare una versione personalizzata di TikMatrix.

Funzionalità​

Impostazioni di Base​

  • Nome App: Personalizza il nome visualizzato dell'applicazione
  • Caricamento Logo: Carica il tuo logo principale personalizzato (consigliato 128x128px)
  • Favicon: Imposta una favicon personalizzata per l'applicazione

Impostazioni Brand​

  • Email di Supporto: Indirizzo email del supporto clienti
  • URL Tutorial: Link personalizzato al tutorial/documentazione
  • URL Telegram: Imposta il link del tuo gruppo o canale Telegram

Interruttori Funzionalità​

  • Mostra Link Tutorial: Controlla la visibilità del link al tutorial
  • Mostra Informazioni Brand: Controlla la visualizzazione delle informazioni del brand

Metodi di Configurazione​

Metodo 1: Configurazione tramite Interfaccia​

  1. Avvia l'applicazione TikMatrix
  2. Fai clic sull'icona a forma di tavolozza 🎨 nella barra del titolo
  3. Configura i parametri nella finestra di dialogo Impostazioni White Label:
    • Nome App: Inserisci il nome personalizzato della tua applicazione
    • Logo Principale: Carica il tuo file logo (PNG/JPG, consigliato 128x128px)
    • Email di Supporto: Inserisci il tuo indirizzo email di supporto
    • URL Tutorial: Inserisci il tuo URL personalizzato per il tutorial
    • URL Telegram: Inserisci l'URL del tuo gruppo/canale Telegram
    • Interruttori Funzionalità: Attiva/disattiva i link al tutorial e la visualizzazione delle informazioni del brand
  4. Fai clic su "Salva" per applicare le impostazioni

Metodo 2: File di Configurazione​

  1. Copia il file di configurazione di esempio:

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

  2. Modifica il file di configurazione:

    {
      "appName": "Il Nome della Tua App",
      "logo": {
        "main": "/percorso/del/tuo/logo.webp",
        "favicon": "/percorso/della/tua/favicon.ico"
      },
      "brand": {
        "supportEmail": "support@tuaazienda.com",
        "tutorialUrl": "https://tuaazienda.com/docs",
        "telegramUrl": "https://t.me/tuogruppo"
      },
      "features": {
        "showTutorialLink": true,
        "showBrandInfo": true
      }
    }

  3. Salva il file e riavvia l'applicazione

Metodo 3: Strumento da Riga di Comando​

  1. Vai nella directory del progetto:

    cd tikmatrix-desktop

  2. Esegui lo strumento di configurazione:

    node scripts/whitelabel-config.js

  3. Segui le istruzioni per configurare ogni parametro passo dopo passo

Creare una Versione Personalizzata​

1. Prepara i File delle Risorse​

# Posiziona i file del tuo logo nei percorsi corretti
src/assets/your-logo.webp       # Logo principale
public/your-favicon.ico        # Favicon web
src-tauri/icons/               # Icone dell'applicazione (varie dimensioni)

2. Configura i Parametri di Build​

Usa lo strumento da riga di comando o modifica manualmente la configurazione:

# Usando lo strumento da riga di comando
node scripts/whitelabel-config.js

# Oppure modifica manualmente
src/config/whitelabel-build.json

3. Compila l'Applicazione​

# Modalità sviluppo
npm run dev

# Build di produzione
npm run build

# Compila l'applicazione Tauri
npm run tauri build

Priorità di Configurazione​

Il sistema usa il seguente ordine di priorità per la configurazione:

  1. Configurazione Runtime: LocalStorage del browser whitelabel_config
  2. Configurazione di Build: src/config/whitelabel-build.json (usata durante la build)
  3. Configurazione di Esempio: examples/whitelabel-config.json
  4. Configurazione Predefinita: Valori predefiniti integrati

Logo Principale​

  • Formato: PNG, JPG o SVG
  • Dimensione: 128x128px (consigliata)
  • Sfondo: Trasparente (per PNG)
  • Uso: Intestazione, schermata di avvio, finestra "Informazioni su"

Favicon​

  • Formato: ICO o PNG
  • Dimensione: 32x32px o 16x16px
  • Uso: Scheda del browser, icona della finestra

Icone dell'Applicazione (per le build)​

  • Formati: PNG, ICO, ICNS
  • Dimensioni: 32x32, 128x128, 256x256, 512x512
  • Posizione: directory src-tauri/icons/

Integrazione API​

API JavaScript​

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

// Ottieni la configurazione attuale
const config = getWhiteLabelConfig();

// Salva una nuova configurazione
saveWhiteLabelConfig(newConfig);

// Ripristina i valori predefiniti
resetWhiteLabelConfig();

// Valida la configurazione
validateWhiteLabelConfig(config);

Funzioni di Utilità​

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

// Inizializza il white label all'avvio dell'app
initWhiteLabel();

// Aggiorna il titolo del documento
updateDocumentTitle('Il Nome della Tua App');

// Aggiorna la favicon
updateFavicon('/percorso/della/favicon.ico');

Best Practice​

  • Usa immagini ad alta risoluzione per una visualizzazione nitida
  • Mantieni un branding coerente su tutte le dimensioni del logo
  • Testa i loghi sia su sfondi chiari che scuri
  • Assicurati che i loghi siano leggibili anche a dimensioni ridotte

Coerenza del Brand​

  • Usa colori e font coerenti ovunque
  • Allineati alle tue linee guida di brand esistenti
  • Testa l'interfaccia personalizzata su diverse dimensioni di schermo
  • Mantieni un aspetto professionale

Configurazione degli URL​

  • Usa URL HTTPS per tutti i link esterni
  • Testa tutti i link prima della distribuzione
  • Assicurati che i canali di supporto siano monitorati correttamente
  • Mantieni aggiornati gli URL della documentazione

Risoluzione dei Problemi​

Problemi Comuni​

Il logo non viene visualizzato:

  • Controlla il percorso del file e i permessi
  • Verifica che il formato dell'immagine sia supportato
  • Assicurati che la dimensione dell'immagine sia appropriata
  • Cancella la cache del browser e riavvia l'app

La configurazione non si salva:

  • Controlla i permessi del file system
  • Verifica che la sintassi JSON sia corretta
  • Assicurati che la directory di configurazione esista
  • Prova a eseguire come amministratore (se necessario)

La build fallisce:

  • Verifica che tutti i file delle risorse esistano
  • Controlla la sintassi del file di configurazione
  • Assicurati che i file delle icone siano nel formato corretto
  • Rivedi i log di build per errori specifici

Ottenere Aiuto​

Se riscontri problemi con la configurazione White Label:

  1. Controlla la sezione di risoluzione dei problemi sopra
  2. Rivedi la sintassi del file di configurazione
  3. Contatta l'assistenza via Telegram
  4. Includi il tuo file di configurazione e i messaggi di errore quando segnali i problemi

Licenza e Utilizzo​

  • La funzionalità White Label è disponibile solo per gli utenti con Abbonamento Annuale
  • I diritti di branding personalizzato sono inclusi nel tuo abbonamento
  • La ridistribuzione di versioni personalizzate potrebbe richiedere licenze aggiuntive
  • Contatta l'assistenza per le opzioni di licenza aziendale

Hai bisogno del codice di sblocco? Contatta il nostro team di assistenza via Telegram con i dettagli del tuo abbonamento annuale.