العودة إلى لوحة التحكم

التوثيق

تعلّم كيفية استخدام Asyntai

كيفية إضافة روبوت الدردشة Asyntai AI إلى Joomla

دليل خطوة بخطوة لمواقع Joomla

الحصول على كود التضمين

الخطوة 1: احصل على كود التضمين

أولاً، انتقل إلى لوحة تحكم Asyntai وانتقل لأسفل إلى قسم "Embed Code". انسخ كود التضمين الفريد الذي سيبدو هكذا:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

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

الخطوة 2: إضافة الكود باستخدام وحدة HTML مخصصة (مُوصى به)

أسهل طريقة لإضافة روبوت الدردشة إلى جميع الصفحات هي استخدام وحدة HTML مخصصة:

  1. سجّل الدخول إلى لوحة مدير Joomla
  2. انتقل إلى Content → Site Modules
  3. انقر على "New" لإنشاء وحدة جديدة
  4. اختر "Custom" (وحدة HTML مخصصة)
  5. أدخل عنوانًا مثل "Asyntai Chatbot" (يمكنك إخفاؤه لاحقًا)
  6. انقر على زر "Toggle Editor" للتبديل إلى وضع HTML الخام
  7. الصق كود تضمين Asyntai
  8. في حقل "Position"، اختر موضع التذييل (مثل "footer" أو "debug")
  9. اضبط "Show Title" على "Hide"
  10. ضمن علامة تبويب "Menu Assignment"، اختر "On all pages"
  11. انقر على "Save & Close"

نصيحة: إذا تم حذف الكود الخاص بك، انتقل إلى System → Global Configuration → Site واضبط المحرر الافتراضي مؤقتًا على "None"، ثم أضف الكود، ثم عُد إلى الإعداد السابق.

بديل: تحرير ملفات القالب

يمكنك إضافة الكود مباشرة إلى ملف index.php الخاص بالقالب:

  1. انتقل إلى System → Site Templates
  2. انقر على اسم القالب النشط الخاص بك
  3. ابحث عن "index.php" في قائمة الملفات وانقر عليه
  4. مرر لأسفل للعثور على وسم الإغلاق </body>
  5. الصق كود تضمين Asyntai الخاص بك قبل وسم </body> مباشرة
  6. انقر على "Save"

مهم: ستُفقد التغييرات على ملفات القالب عند تحديث القالب. فكر في استخدام قالب فرعي أو طريقة وحدة HTML المخصصة لحل أكثر ديمومة.

بديل: استخدام إضافة

يمكنك أيضًا استخدام إضافة مجانية لإضافة نصوص برمجية مخصصة:

  1. انتقل إلى دليل إضافات Joomla
  2. قم بتنزيل إضافة "Add Custom Javascript"
  3. في لوحة إدارة Joomla، انتقل إلى System → Install → Extensions
  4. ارفع الإضافة وثبّتها
  5. انتقل إلى Components → Add Custom Javascript
  6. أضف كود التضمين الخاص بـ Asyntai
  7. اضبطها للتحميل في جميع الصفحات

الخطوة 3: التحقق من التثبيت

بعد حفظ التغييرات، قم بزيارة موقعك في علامة تبويب جديدة أو نافذة تصفح خاص. يجب أن ترى زر أداة الدردشة في الزاوية السفلية اليمنى. انقر عليه للتأكد من أنه يفتح ويعمل بشكل صحيح.

لا ترى الأداة؟ امسح ذاكرة التخزين المؤقت لـ Joomla بالانتقال إلى System → Clear Cache والنقر على "Delete All". حاول أيضًا مسح ذاكرة التخزين المؤقت للمتصفح أو العرض في نافذة تصفح خاص.