يشرح هذا الدليل طريقة إضافة شات بوت MirajX إلى موقع Laravel عندما يكون موقعك مستضافًا على cPanel. لا تحتاج إلى كتابة كود جديد، فقط انسخ كود التضمين من لوحة MirajX وضعه في ملف التصميم الرئيسي للموقع.

قبل أن تبدأ

  • سجّل الدخول إلى لوحة العميل في MirajX.
  • افتح قسم الودجت أو كود التضمين.
  • إذا لم يظهر لك الكود الكامل، اضغط Regenerate Token ثم انسخ الكود كاملًا مباشرة.
  • احتفظ بالكود كما هو تمامًا. لا تحذف التوكن أو رابط الموقع أو رقم العميل أو رقم الوكيل.

أين يتم وضع الكود؟

في مواقع Laravel، أفضل مكان غالبًا هو ملف Blade الرئيسي، قبل وسم الإغلاق </body> مباشرة. بهذه الطريقة يظهر الشات بوت في كل الصفحات التي تستخدم هذا التصميم.

الخطوات من cPanel

  1. سجّل الدخول إلى حساب cPanel الخاص بالاستضافة.
  2. افتح File Manager.
  3. افتح مجلد الموقع. في أغلب الاستضافات يكون اسمه public_html. إذا كان مشروع Laravel داخل مجلد آخر، افتح مجلد المشروع.
  4. ابحث عن مجلد واجهات Laravel. غالبًا ستجده في resources/views/layouts أو resources/views أو داخل مجلد قالب مخصص.
  5. ابحث عن ملف التصميم الرئيسي. قد يكون اسمه app.blade.php أو layout.blade.php أو master.blade.php أو main.blade.php.
  6. قبل التعديل، حمّل نسخة احتياطية من الملف إلى جهازك.
  7. اضغط على الملف ثم اختر Edit.
  8. انزل إلى آخر الملف وابحث عن </body>.
  9. الصق كود MirajX فوق </body> مباشرة.
  10. احفظ الملف.

مثال على مكان الكود

<!-- محتوى الموقع الحالي -->

<script
  src="https://your-mirajx-domain.com/widgets/mirajx_chatboot.js"
  data-webhook-url="https://your-mirajx-domain.com/api/runtime/chat"
  data-widget-config-url="https://your-mirajx-domain.com/api/runtime/widget-config"
  data-brand-name="Your Business Name"
  data-tenant-id="YOUR_TENANT_ID"
  data-agent-id="YOUR_AGENT_ID"
  data-widget-token="YOUR_WIDGET_TOKEN"
></script>
</body>

إذا لم يظهر الشات بوت

  • افتح الموقع من نافذة خاصة أو Incognito.
  • امسح كاش Laravel إذا كانت لديك صلاحية تنفيذ الأوامر أو بمساعدة المطور: php artisan view:clear و php artisan cache:clear.
  • امسح كاش الموقع أو CDN أو أي إضافة تحسين سرعة مستخدمة.
  • تأكد أن الكود وُضع في ملف التصميم المستخدم فعلًا في الموقع، وليس في صفحة غير مستخدمة.
  • تأكد أن الكود لم يظهر كنص داخل الصفحة. يجب أن يكون داخل مصدر HTML قرب نهاية الملف.

ملاحظات أمان مهمة

عدّل فقط ملف التصميم المطلوب. لا تغيّر ملفات Laravel مثل .env أو composer.json أو ملفات المسارات أو قواعد البيانات إلا إذا طلب منك المطور ذلك. إذا تم إرسال التوكن للشخص الخطأ، ارجع إلى لوحة MirajX وأنشئ توكن جديد.