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

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

المنصة:

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

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

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

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

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

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

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

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

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

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

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

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

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

Go to the Joomla Extensions Directory
قم بتنزيل إضافة "Add Custom Javascript"
في لوحة إدارة Joomla، انتقل إلى System → Install → Extensions
ارفع الإضافة وثبّتها
انتقل إلى Components → Add Custom Javascript
أضف كود التضمين الخاص بـ Asyntai
اضبطها للتحميل في جميع الصفحات

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

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