إنتقل إلى المحتوى الرئيسي

إعداد العلامة البيضاء

يتطلب اشتراكًا سنويًا

ميزة العلامة البيضاء متاحة فقط لمستخدمي الاشتراك السنوي. بعد شراء الخطة السنوية، يرجى الاتصال بخدمة العملاء عبر Telegram للحصول على كود الفتح.

تتيح لك ميزة العلامة البيضاء تخصيص هوية العلامة التجارية لـ TikMatrix لتتناسب مع صورة شركتك. يمكنك تعديل اسم التطبيق والشعار ومعلومات العلامة التجارية لإنشاء نسخة مخصصة من TikMatrix.

الميزات​

الإعدادات الأساسية​

  • اسم التطبيق: تخصيص اسم عرض التطبيق
  • تحميل الشعار: تحميل شعارك الرئيسي المخصص (يُنصح بـ 128x128 بكسل)
  • أيقونة الموقع: تعيين أيقونة مخصصة للتطبيق

إعدادات العلامة التجارية​

  • البريد الإلكتروني للدعم: عنوان البريد الإلكتروني لدعم العملاء
  • رابط الدروس: رابط الدروس/الوثائق المخصص
  • رابط Telegram: تعيين رابط مجموعة أو قناة Telegram الخاصة بك

مفاتيح الميزات​

  • عرض رابط الدروس: التحكم في عرض رابط الدروس
  • عرض معلومات العلامة التجارية: التحكم في عرض معلومات العلامة التجارية

طرق الإعداد​

الطريقة الأولى: التكوين عبر الواجهة​

  1. قم بتشغيل تطبيق TikMatrix
  2. انقر على أيقونة لوحة الألوان 🎨 في شريط العنوان
  3. قم بتكوين المعاملات في مربع حوار إعدادات العلامة البيضاء:
    • اسم التطبيق: أدخل اسم التطبيق المخصص الخاص بك
    • الشعار الرئيسي: قم بتحميل ملف شعارك (PNG/JPG، يُنصح بـ 128x128 بكسل)
    • البريد الإلكتروني للدعم: أدخل عنوان بريدك الإلكتروني للدعم
    • رابط الدروس: أدخل رابط الدروس المخصص الخاص بك
    • رابط Telegram: أدخل رابط مجموعة/قناة Telegram الخاصة بك
    • مفاتيح الميزات: تفعيل/تعطيل عرض رابط الدروس ومعلومات العلامة التجارية
  4. انقر على "حفظ" لتطبيق الإعدادات

الطريقة الثانية: ملف التكوين​

  1. انسخ ملف التكوين النموذجي:

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

  2. قم بتحرير ملف التكوين:

    {
      "appName": "اسم التطبيق الخاص بك",
      "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. احفظ الملف وأعد تشغيل التطبيق

الطريقة الثالثة: أداة سطر الأوامر​

  1. انتقل إلى دليل المشروع:

    cd tikmatrix-desktop

  2. قم بتشغيل أداة التكوين:

    node scripts/whitelabel-config.js

  3. اتبع المطالبات لتكوين كل معامل خطوة بخطوة

بناء نسخة مخصصة​

1. تحضير ملفات الموارد​

# ضع ملفات شعارك في الموقع الصحيح
src/assets/your-logo.webp       # الشعار الرئيسي
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
  • الحجم: 128x128 بكسل (يُنصح به)
  • الخلفية: خلفية شفافة (تنسيق PNG)
  • الاستخدام: شريط العنوان، شاشة البداية، مربع حوار حول

أيقونة الموقع​

  • التنسيق: ICO أو PNG
  • الحجم: 32x32 بكسل أو 16x16 بكسل
  • الاستخدام: علامة تبويب المتصفح، أيقونة النافذة

أيقونات التطبيق (للبناء)​

  • التنسيق: 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');

أفضل الممارسات​

تصميم الشعار​

  • استخدم صور عالية الدقة للحصول على عرض واضح
  • حافظ على صورة علامة تجارية متسقة في جميع أحجام الشعار
  • اختبر الشعار على خلفيات فاتحة وداكنة
  • تأكد من أن الشعار لا يزال قابلاً للقراءة بأحجام صغيرة

اتساق العلامة التجارية​

  • استخدم ألوانًا وخطوطًا متسقة في جميع أنحاء الواجهة
  • حافظ على الاتساق مع إرشادات علامتك التجارية الحالية
  • اختبر الواجهة المخصصة على أحجام شاشات مختلفة
  • حافظ على مظهر احترافي

تكوين الروابط​

  • استخدم HTTPS لجميع الروابط الخارجية
  • اختبر جميع الروابط قبل النشر
  • تأكد من مراقبة قنوات الدعم بشكل مناسب
  • حافظ على تحديث روابط الوثائق

استكشاف الأخطاء وإصلاحها​

المشاكل الشائعة​

الشعار لا يظهر:

  • تحقق من مسار الملف والأذونات
  • تحقق من دعم تنسيق الصورة
  • تأكد من أن حجم الصورة مناسب
  • امسح ذاكرة التخزين المؤقت للمتصفح وأعد تشغيل التطبيق

التكوين لا يُحفظ:

  • تحقق من أذونات نظام الملفات
  • تحقق من صحة بناء جملة JSON
  • تأكد من وجود دليل التكوين
  • حاول التشغيل كمسؤول (إذا لزم الأمر)

فشل البناء:

  • تحقق من وجود جميع ملفات الموارد
  • تحقق من بناء جملة ملف التكوين
  • تأكد من صحة تنسيق ملفات الأيقونات
  • راجع سجلات البناء للأخطاء المحددة

الحصول على المساعدة​

إذا واجهت مشاكل أثناء إعداد العلامة البيضاء:

  1. راجع قسم استكشاف الأخطاء وإصلاحها أعلاه
  2. تحقق من بناء جملة ملف التكوين
  3. اتصل بالدعم الفني عبر Telegram
  4. قم بتضمين ملف التكوين ورسائل الخطأ الخاصة بك عند الإبلاغ عن المشاكل

الترخيص والاستخدام​

  • ميزة العلامة البيضاء متاحة فقط لمستخدمي الاشتراك السنوي
  • حقوق العلامة التجارية المخصصة متضمنة في اشتراكك
  • قد يتطلب توزيع الإصدارات المخصصة ترخيصًا إضافيًا
  • اتصل بخدمة العملاء لخيارات ترخيص المؤسسات

هل تحتاج إلى كود الفتح؟ يرجى الاتصال بفريق خدمة العملاء عبر Telegram مع تفاصيل اشتراكك السنوي.