Ciri-ciri Utama

Struktur Fail

modules/livechat/
├── LiveChat.php          (Main class - 128 methods)
├── admin-livechat.php    (Admin panel - this file)
├── livechat.tpl          (Widget template)
├── livechat.js           (Widget JS - visitor facing)
├── config.php            (Configuration)
└── assets/
    ├── notification.mp3
    └── widget.css

Aliran Permintaan

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  Widget JS   │────▶│  AJAX Handler │────▶│  LiveChat   │
│  (Browser)   │◀────│  (PHP)       │◀────│  Class      │
└─────────────┘     └──────────────┘     └──────┬──────┘
                                                 │
┌─────────────┐     ┌──────────────┐            │
│  Admin Panel │────▶│  SSE Stream  │◀───────────┘
│  (This page) │◀────│  (Real-time) │     ┌──────┴──────┐
└─────────────┘     └──────────────┘     │  Database    │
                                          │  (12 tables) │
                                          └─────────────┘

Komunikasi Masa Nyata

Menggunakan Peristiwa Dihantar Pelayan (SSE) untuk kemas kini langsung. Panel pentadbir mengekalkan sambungan SSE berterusan untuk:

• Kiraan pelawat langsung & kemas kini status
• Pemberitahuan mesej baharu
• Perubahan giliran
• Penunjuk menaip melalui sandaran tinjauan pendapat

Pengesahan

Pengesahan pentadbir melalui pengesahan PHP berasaskan sesi. Widget menggunakan cap jari pelawat (hash pelayar + IP + kuki) untuk kesinambungan sesi.

Tindakan Menghadap Widget (18)

Tindakan Berhadapan Pentadbir (37)

Kod Integrasi

<script src="/modules/livechat/livechat.js"></script>
<script>
  WeSellMachines.LiveChat.init({
    position: 'bottom-right',
    primaryColor: '#3498db',
    greeting: 'Need help? Chat with us!',
    offlineMessage: 'We are offline. Leave a message!'
  });
</script>

Bahasa yang Disokong (35)

en, de, fr, es, it, nl, pl, pt, ja, zh, ko, ru, ar, tr, sv, tidak, fi, da, cs, hu, ro, bg, el, hr, sk, sl, lt, lv, et, uk, sr, he, th, vi, id

API JavaScript

// Open chat programmatically
WeSellMachines.LiveChat.open();

// Send automatic message  
WeSellMachines.LiveChat.sendMessage('How can I help?');

// Track custom event
WeSellMachines.LiveChat.trackEvent('viewed_listing', {id: 1234});

// Set visitor info
WeSellMachines.LiveChat.setVisitor({name: 'John', email: 'john@example.com'});

Julat Tarikh

Menyokong Hari Ini, julat 7/30/90 hari. Semua data diagregatkan di bahagian pelayan dengan caching.

Sub-tab

• Gambaran Keseluruhan: 6 KPI, garisan trend, bar setiap jam, saluran, kualiti, perujuk, corong, baharu/kembali, metrik sembang
• Perbualan: Amaran sembang terlepas, taburan masa respons, tempoh, trend CSAT, sumber sembang, topik mesej
• Pelawat: Jenis peranti, bahasa, negara, peta haba waktu puncak (grid 7×24)
• Prestasi: Pelayar, OS, resolusi skrin dengan carta bar
• Kandungan: Jenis halaman, halaman masuk/keluar, halaman penjana sembang, jadual halaman penuh dengan isihan/penapis/carian

Penapis Data

Trafik bot dikecualikan secara lalai. IP dalaman boleh dikonfigurasikan dalam Tetapan. Semua carta menggunakan Chart.js dengan kanvas responsif.

1. Muat naik fail kepada modules/livechat/
2. Konfigurasikan config.php dengan kelayakan pangkalan data
3. Jalankan persediaan — jadual dicipta secara automatik pada pemuatan pertama
4. Tambah widget — sertakan livechat.js dalam templat anda
5. Konfigurasikan SSE — pastikan pelayan menyokong EventSource
6. Ujian — buka panel pentadbir dan sahkan sambungan

Tetapan config.php

V5 — Semasa

• Analisis lanjutan dengan 5 sub-tab dan peta haba
• Terjemahan masa nyata (35 bahasa)
• Sistem pengurusan bot
• Rantaian peningkatan ketidakaktifan
• Penjadualan cuti
• Widget yang menarik perhatian

V4

• Panel konteks perbualan
• Respons terkumpul dengan carian
• Sokongan perkongsian fail
• Pengurusan giliran
• Sistem panggilan balik

V3

• Enjin peraturan pencetus automatik
• Profil & garis masa pelawat
• Sistem larangan lanjutan (IP + masa)
• Profil pentadbir dengan avatar

V2

• Kemas kini masa nyata SSE
• Pemberitahuan desktop
• Amaran bunyi
• Penunjuk menaip

V1

• Fungsi sembang asas
• Penjejakan pelawat
• Antara muka balasan pentadbir