يمكن إضافة شات بوت MirajX إلى مواقع WordPress بطريقتين شائعتين: من خلال إضافة خاصة بأكواد الهيدر والفوتر، أو بتعديل ملف الفوتر الخاص بالقالب من cPanel. لمعظم العملاء، استخدام الإضافة هو الخيار الأكثر أمانًا. وإذا اضطررت لاستخدام cPanel، عدّل بحذر واحتفظ بنسخة احتياطية.

انسخ كود MirajX

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

الخيار المفضل: استخدام إضافة فوتر في WordPress

  1. سجّل الدخول إلى لوحة تحكم WordPress.
  2. اذهب إلى إضافات ثم Add New.
  3. ابحث عن إضافة موثوقة لإضافة أكواد الهيدر والفوتر مثلا Code Snippet.
  4. ثبّت الإضافة وفعلها.
  5. افتح إعدادات الإضافة وابحث عن قسم الفوتر أو body end أو before </body>.
  6. الصق كود MirajX هناك.
  7. احفظ التغييرات واختبر الموقع.

خيار cPanel: تعديل ملف فوتر القالب

  1. سجّل الدخول إلى cPanel.
  2. افتح File Manager.
  3. افتح public_html أو المجلد الذي تم تثبيت WordPress داخله.
  4. افتح wp-content/themes.
  5. افتح مجلد القالب النشط. إذا كنت تستخدم child theme، افتح مجلد القالب الابن.
  6. ابحث عن footer.php.
  7. حمّل نسخة احتياطية قبل التعديل.
  8. اضغط Edit.
  9. ابحث عن </body> قرب نهاية الملف.
  10. الصق كود MirajX فوق </body> مباشرة، ثم احفظ.

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

<?php wp_footer(); ?>

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

تحذير مهم في WordPress

إذا عدّلت القالب الرئيسي مباشرة، فقد يزيل تحديث القالب هذا التعديل لاحقًا. استخدام child theme أو إضافة لإدارة أكواد الفوتر أكثر أمانًا لأنه يقلل احتمال فقدان الكود مع التحديثات.

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

  • امسح كاش إضافة التخزين المؤقت في WordPress.
  • امسح كاش الاستضافة أو CDN أو Cloudflare إن وجد.
  • افتح الموقع من نافذة خاصة أو Incognito.
  • تأكد أن الكود داخل القالب النشط، وليس داخل قالب قديم غير مستخدم.
  • تأكد أن السكربت كامل وأن سطر التوكن لم يتم حذفه.

متى تطلب المساعدة؟

اطلب مساعدة مطور الموقع أو دعم الاستضافة إذا لم تستطع معرفة القالب النشط، أو إذا كان الموقع يستخدم Page Builder بقوالب خاصة، أو إذا تسبب تعديل footer.php في ظهور خطأ. إذا تمت مشاركة التوكن بالخطأ، أنشئ توكن جديد من MirajX قبل الاختبار مرة أخرى.