איך להוסיף צ'אטבוט AI של Asyntai ל-Drupal

מדריך צעד אחר צעד לאתרי Drupal

פלטפורמה:

שלב 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: שימוש בתוסף Header and Footer Scripts (מומלץ)

הדרך הקלה ביותר להוסיף את הצ'אטבוט היא באמצעות תוסף "Header and Footer Scripts":

התחבר לפאנל הניהול של Drupal שלך
עבור אל Extend ולחץ על "Install new module"
Search for "Header and Footer Scripts" or download it from Drupal.org
התקן והפעל את התוסף
עבור אל Configuration → Development → Header and Footer Scripts
לחץ על כרטיסיית "Footer"
הדבק את קוד ההטמעה של Asyntai באזור הטקסט של סקריפטי ה-footer
לחץ על "Save configuration"

טיפ: הוספת הקוד לחלק ה-footer מבטיחה שהוא נטען לאחר תוכן העמוד, מה שמומלץ לווידג'טים של צ'אט.

חלופה: עריכת תבנית ערכת העיצוב

ניתן להוסיף את הקוד ישירות לקובץ התבנית של ערכת העיצוב שלך:

נווט לתיקיית ערכת העיצוב שלך: themes/your_theme/
פתח את קובץ html.html.twig (או צור אחד אם הוא לא קיים)
מצא את תג הסגירה </body>
הדבק את קוד ההטמעה של Asyntai ממש לפני תג </body>
שמור את הקובץ
נקה את מטמון Drupal: Configuration → Performance → Clear all caches

חשוב: שינויים בקבצי ערכת העיצוב עלולים להידרס בעת עדכון ערכת העיצוב. שקול להשתמש בערכת עיצוב ילד או בתוסף Header and Footer Scripts לפתרון קבוע יותר.

חלופה: שימוש בספריות (למפתחים)

למפתחים שמעדיפים להשתמש במערכת ספריות הנכסים של Drupal:

צור או ערוך את קובץ *.libraries.yml של ערכת העיצוב שלך
הוסף רשומת ספרייה חדשה:
asyntai-chatbot: js: https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
צרף את הספרייה בקובץ *.info.yml של ערכת העיצוב שלך:
libraries: - your_theme/asyntai-chatbot
נקה את מטמון Drupal

שלב 3: אמת את ההתקנה

לאחר שמירת השינויים וניקוי המטמון, בקר באתר שלך בכרטיסיית דפדפן חדשה או בחלון גלישה פרטית. אתה אמור לראות את כפתור הצ'אט בפינה הימנית התחתונה. לחץ עליו כדי לוודא שהוא נפתח ופועל כראוי.