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

תיעוד

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

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

מדריך צעד אחר צעד ל-ExpressionEngine CMS

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

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

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

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

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

שלב 2: הוספה לפריסת התבנית (מומלץ)

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

  1. בלוח הבקרה של EE, עבור אל Developer > Templates > Template Groups
  2. פתח את קבוצת התבניות הראשית שלך (בדרך כלל "site") וערוך את תבנית הפריסה (או התבנית שעוטפת את כל העמודים)
  3. מצא את תג הסגירה </body>
  4. הדבק את קוד ההטמעה של Asyntai ממש לפני תגית </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  5. שמור את התבנית

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

שיטה חלופית 1: שימוש ב-Template Partials של EE

Template Partials של ExpressionEngine מאפשרים לך ליצור קטעי קוד לשימוש חוזר שניתן לכלול בתבניות:

  1. עבור אל Developer > Templates > Template Partials
  2. לחץ על "New" כדי ליצור partial חדש בשם _asyntai_widget
  3. הדבק את קוד ההטמעה של Asyntai בתוכן ה-partial:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  4. שמור את ה-partial
  5. כלול אותו בתבנית הפריסה שלך ממש לפני תגית הסגירה </body>:
    {embed="_asyntai_widget"} </body>

הערה: שימוש ב-Template Partials שומר על הקוד שלך מאורגן ומקל על עדכון קוד ההטמעה של הצ'אטבוט במקום אחד בכל האתר.

שיטה חלופית 2: שימוש ב-HTML Header/Footer של EE

חלק מהגדרות ExpressionEngine מספקות חלק footer גלובלי להוספת סקריפטים:

  1. עבור אל Settings > Content & Design > Global Template Preferences
  2. אם הגדרת EE שלך כוללת חלק footer גלובלי, הדבק את קוד ההטמעה של Asyntai שם
  3. אם אין חלק footer גלובלי זמין, ערוך את תבנית הפריסה הראשית שלך ישירות והוסף את קוד ההטמעה לפני תגית הסגירה </body>:
    <!-- Asyntai AI Chatbot --> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </body>
  4. שמור את השינויים שלך

שיטה חלופית 3: שימוש ב-config.php

למשתמשים מתקדמים, ניתן להזריק את סקריפט הצ'אטבוט דרך תצורת ExpressionEngine או על ידי יצירת תוסף מותאם אישית:

  1. גש לקבצי פרויקט ExpressionEngine שלך דרך FTP, SSH או עורך הקוד שלך
  2. נווט לתיקייה system/user/config/ ופתח את config.php
  3. להזרקת JavaScript מותאמת אישית, שקול ליצור תוסף/הרחבה פשוטה של EE שמתחברת ל-hook של template_post_parse כדי להזריק את הסקריפט בעיבוד העמוד:
    // In your custom extension public function template_post_parse($final_template, $is_partial, $site_id) { $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>'; $final_template = str_replace('</body>', $script . '</body>', $final_template); return $final_template; }
  4. החלף את YOUR_WIDGET_ID במזהה הווידג'ט האמיתי שלך מלוח הבקרה

חשוב: שיטת config.php והתוסף מיועדת למשתמשים מתקדמים שמרגישים בנוח עם פיתוח ExpressionEngine. לרוב המשתמשים, שיטת פריסת התבנית (שלב 2) או שיטת Template Partials (שיטה חלופית 1) מומלצת.

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

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

לא רואה את הווידג'ט? ודא ששמרת את התבנית ושאתה עורך את תבנית הפריסה הנכונה שהעמודים שלך משתמשים בה. נקה את מטמון הדפדפן או צפה בחלון גלישה פרטית. אם מטמון תבניות ExpressionEngine מופעל, נקה את המטמון מלוח הבקרה תחת Developer > Utilities > Cache Manager.