חזרה ללוח הבקרה

תיעוד

למד כיצד להשתמש ב-Asyntai

כיצד להוסיף צ'אטבוט AI של Asyntai ל-OpenCart

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

קבלת קוד הטמעה

שלב 1: קבל את קוד ההטמעה שלך

ראשית, עבור ללוח הבקרה של Asyntai וגלול למטה לחלק "קוד הטמעה". העתק את קוד ההטמעה הייחודי שלך שייראה כך:

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

הערה: הקוד למעלה הוא רק דוגמה. עליך להעתיק את קוד ההטמעה הייחודי שלך מלוח הבקרה שלך כיוון שהוא מכיל את מזהה הווידג'ט האישי שלך.

שלב 2: עריכת תבנית פוטר (מומלץ)

הדרך הפשוטה ביותר להוסיף את הצ'אטבוט היא על ידי עריכת תבנית הפוטר של התבנית שלכם:

  1. גשו לקבצי OpenCart שלכם דרך FTP או מנהל קבצים
  2. נווטו לתבנית הפוטר של התבנית שלכם:
    • OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
    • OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
  3. פתחו את קובץ הפוטר לעריכה
  4. מצא את תג הסגירה </body>
  5. הדבק את קוד ההטמעה של Asyntai ממש לפני תג </body>
  6. שמור את הקובץ
  7. נקו מטמון OpenCart: Dashboard → סמל גלגל שיניים כחול (למעלה מימין) → Refresh או מחקו את תוכן system/storage/cache/

טיפ: אם אתם משתמשים בתבנית ברירת המחדל, הנתיב יהיה catalog/view/theme/default/template/common/footer.twig. תמיד צרו גיבוי לפני עריכת קבצי תבנית.

חלופה: שימוש באפשרות קוד מותאם אישית של התבנית

תבניות OpenCart מודרניות רבות כוללות אפשרות מובנית לקוד מותאם אישית:

  1. היכנסו ללוח הניהול של OpenCart
  2. עברו אל Extensions → Themes (או Extensions → Extensions → Themes)
  3. לחצו על Edit בתבנית הפעילה שלכם
  4. חפשו קטע "Custom Code", "Footer Scripts", או "Custom JavaScript"
  5. הדבק את קוד ההטמעה של Asyntai
  6. לחץ על "Save"
  7. נקו את המטמון

הערה: לא לכל התבניות יש אפשרות זו. אם לתבנית שלכם אין שדות קוד מותאם אישית, השתמשו בשיטת עריכת התבנית או התקינו הרחבה.

חלופה: שימוש בהרחבת קוד מותאם אישית

ניתן להתקין הרחבה חינמית מ-OpenCart Marketplace כדי להוסיף סקריפטים מותאמים אישית:

  1. עברו אל OpenCart Marketplace
  2. חפשו "Custom Script", "Header Footer Scripts", או "Custom Code"
  3. הורידו והתקינו הרחבה מתאימה
  4. בלוח הניהול שלכם, עברו אל Extensions → Extensions → Modules
  5. מצאו והתקינו את מודול הקוד המותאם אישית
  6. הגדירו את המודול והדביקו את קוד ההטמעה של Asyntai בקטע הפוטר
  7. שמרו ונקו את המטמון

חשוב: שימוש בהרחבות מומלץ על פני עריכת קבצי ליבה, מכיוון שהן שורדות עדכוני OpenCart. הרחבות פופולריות כוללות "Custom Script in Header & Footer" הזמינות ב-marketplace.

חלופה: שימוש בשיטת addScript (למפתחים)

למפתחים, OpenCart 3.x/4.x מספק דרך פרוגרמטית להוספת סקריפטים:

  1. פתחו את catalog/controller/common/footer.php
  2. הוסיפו את השורה הבאה לפני $data['scripts'] = $this->document->getScripts('footer');:
    $this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
  3. עבור מאפיין ה-data, תצטרכו לשנות את footer.twig כדי לכלול אותו ידנית, או להוסיף JavaScript inline לאחר לולאת הסקריפטים

הערה: כדי שהווידג'ט יעבוד כראוי עם מאפיין ה-data, שיטת התבנית פשוטה יותר מכיוון ששיטת addScript לא תומכת במאפיינים מותאמים אישית ישירות.

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

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

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