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

תיעוד

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

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

מדריך צעד אחר צעד לאתרי Concrete CMS (לשעבר Concrete5)

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

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

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

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

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

שלב 2: הוסף קוד לתחתית הנושא (מומלץ)

הדרך הטובה ביותר להוסיף את הצ'אטבוט לכל דפי אתר Concrete CMS שלך היא על ידי עריכת קובץ התחתית של הנושא:

  1. גש להתקנת Concrete CMS שלך דרך FTP או מנהל קבצים
  2. נווט לתיקייה /application/themes/your_theme_name/
  3. אתר ופתח את קובץ footer.php (או תבנית תחתית מקבילה)
  4. מצא את השורה עם תג הסגירה </body>
  5. הדבק את קוד ההטמעה של Asyntai ממש לפני תג </body>
  6. שמור את הקובץ והעלה אותו בחזרה לשרת שלך אם עורך מקומית
  7. נקה מטמון Concrete CMS: Dashboard → System & Settings → Clear Cache

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

שיטה חלופית 1: בלוק HTML (הכי קל ללא-מפתחים)

אם אתה מעדיף לא לערוך קבצי נושא, אתה יכול להשתמש בבלוק HTML המובנה של Concrete CMS:

  1. התחבר ללוח הבקרה של Concrete CMS
  2. נווט לדף שבו אתה רוצה להוסיף את הצ'אטבוט
  3. לחץ על Edit Page (אייקון עיפרון בסרגל הכלים)
  4. לחץ על Add Block באזור שבו אתה רוצה למקם את הקוד
  5. חפש ובחר את בלוק HTML
  6. הדבק את קוד ההטמעה של Asyntai בעורך ה-HTML
  7. לחץ על Add כדי לשמור את הבלוק
  8. לחץ על Publish כדי להפוך את השינויים לחיים

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

שיטה חלופית 2: קובץ כותרת נושא

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

  1. גש לקבצי Concrete CMS שלך דרך FTP או File Manager
  2. נווט אל /application/themes/your_theme_name/
  3. פתח את קובץ header.php (או elements/header.php)
  4. מצא את תגית הסגירה </head>
  5. הדבק את קוד ההטמעה של Asyntai ממש לפני תגית </head>
  6. שמור והעלה את הקובץ
  7. נקה את המטמון מלוח הבקרה
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </head>

טיפ: הקפד לכלול את רכיבי ה-header הנדרשים באמצעות <?php View::element('header_required'); ?> בקובץ header.php שלך כדי ש-Concrete CMS יפעל כראוי.

שיטה חלופית 3: תבנית מותאמת אישית (מתקדם)

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

  1. צור קובץ תבנית עמוד חדש ב-/application/themes/your_theme_name/
  2. או העתק תבנית קיימת (למשל, default.php) ושנה את שמה
  3. הוסף את קוד ההטמעה של Asyntai לקובץ התבנית לפני </body>
  4. בלוח הבקרה של Concrete CMS, עבור אל Pages & Themes
  5. לחץ על Page Types
  6. בחר את סוג העמוד שבו ברצונך להשתמש עם תבנית זו
  7. הקצה את התבנית המותאמת אישית שלך לסוג העמוד
  8. כל העמודים שמשתמשים בסוג עמוד זה יכללו כעת את הצ'אטבוט

חשוב: תמיד גבה את קבצי ערכת העיצוב שלך לפני ביצוע שינויים. בדוק את השינויים שלך באתר בדיקה תחילה אם אפשר. עריכות שגויות בקבצי ערכת העיצוב עלולות לשבור את המבנה או הפונקציונליות של האתר שלך.

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

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

לא רואה את הווידג'ט? ודא שניקית את המטמון של Concrete CMS (Dashboard → System & Settings → Clear Cache). נסה לצפות באתר שלך בחלון גלישה פרטית. בדוק ששמרת והעלית את כל שינויי הקבצים. פתח את מסוף הדפדפן (F12) כדי לבדוק אם יש שגיאות JavaScript.