تعتمد مواقع Joomla على القوالب للتحكم في شكل الموقع. لكي يظهر شات بوت MirajX في كل الصفحات، يتم عادة وضع كود التضمين داخل القالب النشط قبل وسم الإغلاق </body>.
أولًا انسخ كود MirajX
- سجّل الدخول إلى لوحة العميل في MirajX.
- افتح قسم كود التضمين أو الودجت.
- انسخ كود السكربت كاملًا. إذا لم يظهر التوكن كاملًا، أنشئ توكن جديد وانسخ الكود مباشرة.
معرفة قالب Joomla النشط
إذا كان بإمكانك الدخول إلى لوحة Joomla، افتح System ثم Site Templates أو Templates. سجّل اسم القالب النشط لأنك ستحتاجه داخل cPanel.
الخطوات من cPanel
- سجّل الدخول إلى cPanel.
- افتح File Manager.
- افتح مجلد الموقع الرئيسي، وغالبًا يكون
public_html. - افتح مجلد
templates. - افتح مجلد القالب النشط.
- ابحث عن ملف
index.php. هذا غالبًا هو ملف القالب الرئيسي. - حمّل نسخة احتياطية قبل التعديل.
- اضغط Edit.
- انزل إلى آخر الملف وابحث عن
</body>. - الصق كود MirajX فوق
</body>مباشرة. - احفظ الملف.
مثال على مكان الكود
<!-- محتوى قالب Joomla -->
<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>
إذا لم تجد وسم body بوضوح
بعض قوالب Joomla متقدمة وتقسم التصميم على عدة ملفات. إذا لم تجد </body> داخل index.php، افحص مجلدات مثل layouts أو html أو ملفات إطار القالب. إذا لم تكن متأكدًا، اسأل مطور الموقع أو دعم الاستضافة قبل التعديل.
اختبار الموقع بعد الحفظ
- امسح كاش Joomla من لوحة التحكم إذا كان الكاش مفعّلًا.
- امسح كاش الاستضافة أو CDN إن وجد.
- افتح الموقع من نافذة خاصة أو Incognito.
- تحقق من ظهور فقاعة المحادثة في زاوية الموقع السفلية.
ملاحظات مهمة لعملاء Joomla
- تحديثات القالب قد تستبدل التعديلات اليدوية. احتفظ بنسخة من كود MirajX.
- لا تعدّل ملفات Joomla الأساسية إلا إذا طلب منك المطور ذلك.
- إذا كان الموقع يستخدم أكثر من قالب، أضف الكود إلى القالب المستخدم في الصفحات العامة.
- إذا تمت مشاركة التوكن بالخطأ، أنشئ توكن جديد من MirajX.