Główne cechy

Struktura pliku

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

Przepływ żądań

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

Komunikacja w czasie rzeczywistym

Wykorzystuje zdarzenia wysyłane przez serwer (SSE) do aktualizacji na żywo. Panel administracyjny utrzymuje stałe połączenie SSE dla:

• Aktualizacje liczby odwiedzających na żywo i statusu
• Powiadomienia o nowych wiadomościach
• Zmiany w kolejce
• Wskaźniki pisania za pomocą awaryjnego sondowania

Uwierzytelnianie

Uwierzytelnianie administratora za pomocą uwierzytelniania PHP opartego na sesji. Widget wykorzystuje odcisk palca użytkownika (hash przeglądarki + adres IP + plik cookie) w celu zapewnienia ciągłości sesji.

Akcje skierowane do widżetów (18)

Akcje dostępne dla administratora (37)

Kod integracyjny

<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>

Obsługiwane języki (35)

en, de, fr, es, it, nl, pl, pt, ja, zh, ko, ru, ar, tr, sv, no, fi, da, cs, hu, ro, bg, el, hr, sk, sl, lt, lv, et, uk, sr, on, 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'});

Zakresy dat

Obsługuje zakresy: „Dzisiaj”, „7/30/90 dni”. Wszystkie dane agregowane po stronie serwera z buforowaniem.

Podzakładki

• Przegląd: 6 KPI, linia trendu, słupki godzinowe, kanały, jakość, polecający, lejek, nowi/powracający, metryki czatu
• Rozmowy: Alerty o nieodebranych czatach, rozkład czasu reakcji, czas trwania, trend CSAT, źródła czatów, tematy wiadomości
• Odwiedzający: Typy urządzeń, języki, kraje, mapa cieplna godzin szczytu (siatka 7×24)
• Wydajność: Przeglądarki, systemy operacyjne, rozdzielczości ekranu z wykresami słupkowymi
• Treść: Typy stron, strony wejścia/wyjścia, strony generujące czaty, tabela pełnostronicowa z sortowaniem/filtrowaniem/wyszukiwaniem

Filtry danych

Ruch botów jest domyślnie wyłączony. Wewnętrzne adresy IP można skonfigurować w Ustawieniach. Wszystkie wykresy korzystają z Chart.js z responsywnym płótnem.

1. Prześlij pliki Do modules/livechat/
2. Konfiguruj config.php z danymi uwierzytelniającymi bazy danych
3. Uruchom konfigurację — tabele tworzone automatycznie przy pierwszym załadowaniu
4. Dodaj widget - włączać livechat.js w twoim szablonie
5. Konfiguruj SSE — upewnij się, że serwer obsługuje EventSource
6. Test — otwórz panel administracyjny i sprawdź połączenie

Ustawienia config.php

Wersja 5 — Aktualna

• Zaawansowana analityka z 5 podzakładkami i mapami cieplnymi
• Tłumaczenie w czasie rzeczywistym (35 języków)
• System zarządzania botami
• Łańcuch eskalacji bezczynności
• Planowanie urlopów
• Przyciągający wzrok widget

Wersja 4

• Panel kontekstu konwersacji
• Gotowe odpowiedzi z wyszukiwaniem
• Wsparcie udostępniania plików
• Zarządzanie kolejkami
• System oddzwaniania

Wersja 3

• Silnik reguł automatycznego wyzwalania
• Profil i oś czasu odwiedzającego
• Zaawansowany system banów (IP + czasowy)
• Profile administratorów z awatarami

Wersja 2

• Aktualizacje SSE w czasie rzeczywistym
• Powiadomienia na pulpicie
• Alerty dźwiękowe
• Wskaźniki pisania

Wersja 1

• Podstawowa funkcjonalność czatu
• Śledzenie odwiedzających
• Interfejs odpowiedzi administratora