Ana içeriğe geç

White Label Kurulumu

Yıllık Abonelik Gerekli

White Label işlevi yalnızca Yıllık Abonelik kullanıcıları için kullanılabilir. Yıllık plan satın aldıktan sonra kilit açma kodunuzu almak için Telegram üzerinden destek ekibimizle iletişime geçin.

White Label özelliği, TikMatrix'in markalamasını şirket kimliğinize uyacak şekilde özelleştirmenize olanak tanır. TikMatrix'in kişiselleştirilmiş bir sürümünü oluşturmak için uygulama adını, logoyu ve marka bilgilerini değiştirebilirsiniz.

Özellikler​

Temel Ayarlar​

  • Uygulama Adı: Uygulama görüntüleme adını özelleştirin
  • Logo Yükleme: Özel ana logonuzu yükleyin (128x128px önerilir)
  • Favicon: Uygulama için özel favicon ayarlayın

Marka Ayarları​

  • Destek E-postası: Müşteri destek e-posta adresi
  • Eğitim URL'si: Özel eğitim/dokümantasyon bağlantısı
  • Telegram URL'si: Telegram grubunuz veya kanalınızın bağlantısını ayarlayın

Özellik Anahtarları​

  • Eğitim Bağlantısını Göster: Eğitim bağlantısının görünürlüğünü kontrol edin
  • Marka Bilgisini Göster: Marka bilgisi görüntülenmesini kontrol edin

Kurulum Yöntemleri​

Yöntem 1: Arayüz Yapılandırması​

  1. TikMatrix uygulamasını başlatın
  2. Başlık çubuğundaki palet simgesine 🎨 tıklayın
  3. White Label Ayarları iletişim kutusunda parametreleri yapılandırın:
    • Uygulama Adı: Özel uygulama adınızı girin
    • Ana Logo: Logo dosyanızı yükleyin (PNG/JPG, 128x128px önerilir)
    • Destek E-postası: Destek e-posta adresinizi girin
    • Eğitim URL'si: Özel eğitim URL'nizi girin
    • Telegram URL'si: Telegram grup/kanal URL'nizi girin
    • Özellik Anahtarları: Eğitim bağlantılarını ve marka bilgisi görüntülenmesini etkinleştirin/devre dışı bırakın
  4. Ayarları uygulamak için "Kaydet"e tıklayın

Yöntem 2: Yapılandırma Dosyası​

  1. Örnek yapılandırma dosyasını kopyalayın:

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

  2. Yapılandırma dosyasını düzenleyin:

    {
      "appName": "Uygulama Adınız",
      "logo": {
        "main": "/logonuza/giden/yol.webp",
        "favicon": "/faviconunuza/giden/yol.ico"
      },
      "brand": {
        "supportEmail": "support@sirketiniz.com",
        "tutorialUrl": "https://sirketiniz.com/docs",
        "telegramUrl": "https://t.me/grubunuz"
      },
      "features": {
        "showTutorialLink": true,
        "showBrandInfo": true
      }
    }

  3. Dosyayı kaydedin ve uygulamayı yeniden başlatın

Yöntem 3: Komut Satırı Aracı​

  1. Proje dizinine gidin:

    cd tikmatrix-desktop

  2. Yapılandırma aracını çalıştırın:

    node scripts/whitelabel-config.js

  3. Her parametreyi adım adım yapılandırmak için istemleri izleyin

Özel Sürüm Oluşturma​

1. Kaynak Dosyalarını Hazırlayın​

# Logo dosyalarınızı doğru konumlara yerleştirin
src/assets/your-logo.webp       # Ana logo
public/your-favicon.ico        # Web favicon
src-tauri/icons/               # Uygulama simgeleri (çeşitli boyutlar)

2. Derleme Parametrelerini Yapılandırın​

Komut satırı aracını kullanın veya yapılandırmayı manuel olarak düzenleyin:

# Komut satırı aracını kullanarak
node scripts/whitelabel-config.js

# Veya manuel olarak düzenleyerek
src/config/whitelabel-build.json

3. Uygulamayı Derleyin​

# Geliştirme modu
npm run dev

# Üretim derlemesi
npm run build

# Tauri uygulamasını derle
npm run tauri build

Yapılandırma Önceliği​

Sistem, yapılandırma için şu öncelik sırasını kullanır:

  1. Çalışma Zamanı Yapılandırması: Tarayıcı LocalStorage whitelabel_config
  2. Derleme Yapılandırması: src/config/whitelabel-build.json (derleme sırasında kullanılır)
  3. Örnek Yapılandırma: examples/whitelabel-config.json
  4. Varsayılan Yapılandırma: Yerleşik varsayılan değerler

Logo Gereksinimleri​

  • Biçim: PNG, JPG veya SVG
  • Boyut: 128x128px (önerilen)
  • Arka Plan: Şeffaf (PNG için)
  • Kullanım: Üst bilgi, açılış ekranı, hakkında iletişim kutusu

Favicon​

  • Biçim: ICO veya PNG
  • Boyut: 32x32px veya 16x16px
  • Kullanım: Tarayıcı sekmesi, pencere simgesi

Uygulama Simgeleri (derlemeler için)​

  • Biçimler: PNG, ICO, ICNS
  • Boyutlar: 32x32, 128x128, 256x256, 512x512
  • Konum: src-tauri/icons/ dizini

API Entegrasyonu​

JavaScript API​

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

// Mevcut yapılandırmayı al
const config = getWhiteLabelConfig();

// Yeni yapılandırmayı kaydet
saveWhiteLabelConfig(newConfig);

// Varsayılanlara sıfırla
resetWhiteLabelConfig();

// Yapılandırmayı doğrula
validateWhiteLabelConfig(config);

Yardımcı Fonksiyonlar​

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

// Uygulama başlangıcında white label'ı başlat
initWhiteLabel();

// Belge başlığını güncelle
updateDocumentTitle('Uygulama Adınız');

// Favicon'u güncelle
updateFavicon('/faviconunuza/giden/yol.ico');

En İyi Uygulamalar​

Logo Tasarımı​

  • Net bir görüntü için yüksek çözünürlüklü görseller kullanın
  • Tüm logo boyutlarında tutarlı markalama sürdürün
  • Logoları hem açık hem koyu arka planlarda test edin
  • Logoların küçük boyutlarda okunabilir olduğundan emin olun

Marka Tutarlılığı​

  • Her yerde tutarlı renkler ve yazı tipleri kullanın
  • Mevcut marka yönergelerinizle uyumlu olun
  • Özelleştirilmiş arayüzü farklı ekran boyutlarında test edin
  • Profesyonel bir görünüm sürdürün

URL Yapılandırması​

  • Tüm harici bağlantılar için HTTPS URL'leri kullanın
  • Dağıtımdan önce tüm bağlantıları test edin
  • Destek kanallarının düzgün izlendiğinden emin olun
  • Dokümantasyon URL'lerini güncel tutun

Sorun Giderme​

Yaygın Sorunlar​

Logo görüntülenmiyor:

  • Dosya yolunu ve izinleri kontrol edin
  • Görüntü biçiminin desteklendiğini doğrulayın
  • Görüntü boyutunun uygun olduğundan emin olun
  • Tarayıcı önbelleğini temizleyin ve uygulamayı yeniden başlatın

Yapılandırma kaydedilmiyor:

  • Dosya sistemi izinlerini kontrol edin
  • JSON söz diziminin doğru olduğunu doğrulayın
  • Yapılandırma dizininin var olduğundan emin olun
  • Yönetici olarak çalıştırmayı deneyin (gerekiyorsa)

Derleme başarısız oluyor:

  • Tüm kaynak dosyalarının var olduğunu doğrulayın
  • Yapılandırma dosyası söz dizimini kontrol edin
  • Simge dosyalarının doğru biçimde olduğundan emin olun
  • Belirli hatalar için derleme günlüklerini inceleyin

Yardım Alma​

White Label kurulumuyla ilgili sorunlarla karşılaşırsanız:

  1. Yukarıdaki sorun giderme bölümünü kontrol edin
  2. Yapılandırma dosyası söz dizimini gözden geçirin
  3. Telegram üzerinden destekle iletişime geçin
  4. Sorunları bildirirken yapılandırma dosyanızı ve hata mesajlarınızı ekleyin

Lisans ve Kullanım​

  • White Label işlevi yalnızca Yıllık Abonelik kullanıcıları için kullanılabilir
  • Özel markalama hakları aboneliğinize dahildir
  • Özelleştirilmiş sürümlerin yeniden dağıtımı ek lisanslama gerektirebilir
  • Kurumsal lisanslama seçenekleri için destekle iletişime geçin

Kilit açma koduna mı ihtiyacınız var? Yıllık abonelik bilgilerinizle birlikte Telegram üzerinden destek ekibimizle iletişime geçin.