การตั้งค่าฟีเจอร์ White Label

ต้องเป็นแพ็กเกจรายปี

ฟีเจอร์ White Label เปิดให้ใช้งานเฉพาะผู้ใช้ แพ็กเกจรายปี เท่านั้น หลังซื้อแพ็กเกจรายปีแล้ว กรุณาติดต่อทีมซัพพอร์ตผ่าน Telegram เพื่อรับรหัสปลดล็อก

White Label ช่วยให้คุณปรับแบรนด์ของ TikMatrix ให้ตรงกับแบรนด์บริษัทได้ เช่น เปลี่ยนชื่อแอป โลโก้ และข้อมูลแบรนด์ เพื่อสร้างเวอร์ชันที่เป็นเอกลักษณ์ของคุณ

ความสามารถหลัก

การตั้งค่าพื้นฐาน

• ชื่อแอป: กำหนดชื่อที่แสดงของแอป
• อัปโหลดโลโก้: อัปโหลดโลโก้หลักของคุณ (แนะนำ 128x128px)
• ไอคอนเว็บไซต์: ตั้งค่า favicon ของแอป

การตั้งค่าแบรนด์

• อีเมลซัพพอร์ต: อีเมลสำหรับติดต่อฝ่ายสนับสนุน
• ลิงก์คู่มือ: ลิงก์เอกสาร/คู่มือที่กำหนดเอง
• ลิงก์ Telegram: ลิงก์กลุ่มหรือช่อง Telegram ของคุณ

สวิตช์ฟีเจอร์

• แสดงลิงก์คู่มือ
• แสดงข้อมูลแบรนด์

วิธีตั้งค่า

วิธีที่ 1: ตั้งค่าผ่าน UI

1. เปิดแอป TikMatrix
2. คลิกไอคอนจานสี 🎨 บนแถบหัวข้อ
3. กำหนดค่าในหน้าต่าง White Label:
   • ชื่อแอป
   • โลโก้หลัก (PNG/JPG แนะนำ 128x128px)
   • อีเมลซัพพอร์ต
   • ลิงก์คู่มือ
   • ลิงก์ Telegram
   • สวิตช์ฟีเจอร์ (เปิด/ปิดการแสดงลิงก์คู่มือและข้อมูลแบรนด์)
4. คลิก บันทึก

วิธีที่ 2: ตั้งค่าผ่านไฟล์คอนฟิก

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. บันทึกไฟล์และรีสตาร์ตแอป

วิธีที่ 3: ตั้งค่าผ่าน Command Line

1. เข้าโฟลเดอร์โปรเจกต์:

cd tikmatrix-desktop

2. รันเครื่องมือตั้งค่า:

node scripts/whitelabel-config.js

3. ทำตามขั้นตอนบนหน้าจอ

การ build เวอร์ชันกำหนดเอง

1) เตรียมไฟล์ทรัพยากร

# วางไฟล์โลโก้ในตำแหน่งที่ถูกต้อง
src/assets/your-logo.webp       # โลโก้หลัก
public/your-favicon.ico         # ไอคอนเว็บไซต์
src-tauri/icons/                # ไอคอนแอปหลายขนาด

2) ตั้งค่าพารามิเตอร์การ build

# ใช้เครื่องมือ CLI
node scripts/whitelabel-config.js

# หรือแก้ไฟล์ด้วยตนเอง
src/config/whitelabel-build.json

3) Build แอป

# โหมดพัฒนา
npm run dev

# Build โปรดักชัน
npm run build

# Build Tauri app
npm run tauri build

ลำดับความสำคัญของคอนฟิก

ระบบจะอ่านคอนฟิกตามลำดับนี้:

1. Runtime Config: whitelabel_config ใน LocalStorage
2. Build Config: src/config/whitelabel-build.json
3. Example Config: examples/whitelabel-config.json
4. Default Config: ค่าดีฟอลต์ในระบบ

ข้อกำหนดโลโก้

โลโก้หลัก

• รูปแบบ: PNG, JPG, SVG
• ขนาด: แนะนำ 128x128px
• พื้นหลัง: แนะนำโปร่งใส (PNG)
• การใช้งาน: แถบหัวข้อ, หน้าจอเริ่มต้น, กล่อง About

ไอคอนเว็บไซต์ (Favicon)

• รูปแบบ: ICO หรือ PNG
• ขนาด: 32x32px หรือ 16x16px
• การใช้งาน: แท็บเบราว์เซอร์, ไอคอนหน้าต่าง

ไอคอนแอป (สำหรับ Build)

• รูปแบบ: 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);

Utility Functions

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

// เรียกตอนแอปเริ่มทำงาน
initWhiteLabel();

// อัปเดตชื่อหน้าเอกสาร
updateDocumentTitle('ชื่อแอปของคุณ');

// อัปเดต favicon
updateFavicon('/path/to/favicon.ico');

แนวปฏิบัติที่แนะนำ

งานออกแบบโลโก้

• ใช้ไฟล์ความละเอียดสูงเพื่อความคมชัด
• รักษาเอกลักษณ์แบรนด์ให้สม่ำเสมอทุกขนาด
• ทดสอบบนพื้นหลังสว่าง/มืด
• ตรวจสอบว่าโลโก้ยังอ่านได้ในขนาดเล็ก

ความสอดคล้องของแบรนด์

• ใช้โทนสีและฟอนต์ให้สม่ำเสมอทั้งระบบ
• ให้สอดคล้องกับ Brand Guideline เดิมของคุณ
• ทดสอบการแสดงผลหลายขนาดหน้าจอ
• รักษาภาพลักษณ์มืออาชีพ

การตั้งค่าลิงก์

• ใช้ HTTPS กับลิงก์ภายนอกทั้งหมด
• ทดสอบลิงก์ทุกตัวก่อนนำขึ้นใช้งานจริง
• ตรวจสอบช่องทางซัพพอร์ตให้พร้อมตอบกลับ
• อัปเดตลิงก์เอกสารให้เป็นปัจจุบัน

การแก้ปัญหา

ปัญหาที่พบบ่อย

โลโก้ไม่แสดง

• ตรวจสอบพาธไฟล์และสิทธิ์การเข้าถึง
• ตรวจสอบฟอร์แมตรูปภาพว่ารองรับ
• ตรวจสอบขนาดรูปให้เหมาะสม
• ล้างแคชและรีสตาร์ตแอป

คอนฟิกไม่ถูกบันทึก

• ตรวจสอบสิทธิ์ไฟล์/โฟลเดอร์
• ตรวจสอบ JSON syntax ให้ถูกต้อง
• ตรวจสอบว่าโฟลเดอร์คอนฟิกมีอยู่จริง
• หากจำเป็นให้ลองรันสิทธิ์แอดมิน

Build ล้มเหลว

• ตรวจสอบว่าไฟล์ทรัพยากรมีครบ
• ตรวจสอบ syntax ของไฟล์คอนฟิก
• ตรวจสอบฟอร์แมตไฟล์ไอคอน
• อ่าน build log เพื่อดู error จริง

ต้องการความช่วยเหลือ

หากติดปัญหาระหว่างตั้งค่า White Label:

1. ตรวจสอบหัวข้อแก้ปัญหาด้านบน
2. ตรวจสอบ syntax ของไฟล์คอนฟิก
3. ติดต่อทีมผ่าน Telegram
4. แนบไฟล์คอนฟิกและข้อความ error ตอนแจ้งปัญหา

สิทธิ์การใช้งาน

• White Label เปิดให้ใช้เฉพาะแพ็กเกจรายปี
• สิทธิ์ปรับแบรนด์รวมอยู่ในแพ็กเกจ
• การแจกจ่ายเวอร์ชันกำหนดเองอาจต้องมีไลเซนส์เพิ่มเติม
• หากต้องการตัวเลือกสำหรับองค์กร กรุณาติดต่อซัพพอร์ต

---

ต้องการรหัสปลดล็อก? กรุณาติดต่อทีมซัพพอร์ตผ่าน Telegram พร้อมข้อมูลแพ็กเกจรายปีของคุณ