الميزات الرئيسية

بنية الملف

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

مسار الطلب

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

الاتصال في الوقت الفعلي

يستخدم نظام الأحداث المرسلة من الخادم (SSE) للتحديثات المباشرة. تحافظ لوحة التحكم على اتصال SSE دائم من أجل:

• عدد الزوار المباشر وتحديثات الحالة
• إشعارات الرسائل الجديدة
• تغييرات قائمة الانتظار
• مؤشرات الكتابة عبر آلية الاستقصاء الاحتياطية

المصادقة

مصادقة المسؤول عبر مصادقة PHP القائمة على الجلسة. تستخدم الأداة بصمة الزائر (تجزئة المتصفح + عنوان IP + ملف تعريف الارتباط) لضمان استمرارية الجلسة.

الإجراءات المتعلقة بالأدوات (18)

الإجراءات الموجهة للمسؤولين (37)

رمز التكامل

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

اللغات المدعومة (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، he، th، vi، id

واجهة برمجة تطبيقات جافا سكريبت

// 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'});

نطاقات التواريخ

يدعم نطاقات اليوم، و7/30/90 يومًا. يتم تجميع جميع البيانات على جانب الخادم مع التخزين المؤقت.

علامات التبويب الفرعية

• ملخص: 6 مؤشرات أداء رئيسية، خط الاتجاه، أشرطة البيانات كل ساعة، القنوات، الجودة، المحيلون، مسار التحويل، العملاء الجدد/العائدون، مقاييس الدردشة
• المحادثات: تنبيهات المحادثات الفائتة، توزيع وقت الاستجابة، المدة، اتجاه رضا العملاء، مصادر المحادثات، مواضيع الرسائل
• الزوار: أنواع الأجهزة، واللغات، والبلدان، وخريطة حرارية لساعات الذروة (شبكة 7×24)
• أداء: المتصفحات، وأنظمة التشغيل، ودقة الشاشة مع الرسوم البيانية الشريطية
• محتوى: أنواع الصفحات، صفحات الدخول/الخروج، صفحات إنشاء المحادثات، جدول صفحة كاملة مع إمكانية الفرز/التصفية/البحث

مرشحات البيانات

يتم استبعاد حركة مرور البوتات افتراضيًا. يمكن ضبط عناوين IP الداخلية في الإعدادات. تستخدم جميع الرسوم البيانية Chart.js مع لوحة رسم متجاوبة.

1. تحميل الملفات ل modules/livechat/
2. تهيئة config.php باستخدام بيانات اعتماد قاعدة البيانات
3. قم بتشغيل الإعداد — الجداول التي يتم إنشاؤها تلقائيًا عند التحميل الأول
4. إضافة أداة - يشمل livechat.js في قالبك
5. تكوين SSE — تأكد من أن الخادم يدعم EventSource
6. امتحان — افتح لوحة التحكم وتحقق من الاتصال

إعدادات ملف config.php

الإصدار الخامس - الحالي

• تحليلات متقدمة مع 5 علامات تبويب فرعية وخرائط حرارية
• الترجمة الفورية (35 لغة)
• نظام إدارة الروبوتات
• سلسلة تصعيد الخمول
• جدولة العطلات
• أداة لافتة للنظر

V4

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

الإصدار الثالث

• محرك قواعد التشغيل التلقائي
• ملف تعريف الزائر والجدول الزمني
• نظام حظر متطور (عنوان IP + مؤقت)
• ملفات تعريف المسؤولين مع الصور الرمزية

الإصدار الثاني

• تحديثات SSE في الوقت الفعلي
• إشعارات سطح المكتب
• تنبيهات صوتية
• مؤشرات الكتابة

الإصدار الأول

• وظائف الدردشة الأساسية
• تتبع الزوار
• واجهة رد المسؤول