איך להוסיף צ'אטבוט AI של Asyntai ל-Backdrop CMS
מדריך צעד אחר צעד לאתרי Backdrop CMS
שלב 1: קבל את קוד ההטמעה שלך
ראשית, עבור ללוח הבקרה של Asyntai וגלול למטה לחלק "קוד הטמעה". העתק את קוד ההטמעה הייחודי שלך שייראה כך:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
הערה: הקוד למעלה הוא רק דוגמה. עליך להעתיק את קוד ההטמעה הייחודי שלך מלוח הבקרה שלך כיוון שהוא מכיל את מזהה הווידג'ט האישי שלך.
שלב 2: הוסף לתבנית הנושא (מומלץ)
Backdrop CMS משתמש בקבצי תבנית .tpl.php בנושאים שלו. הגישה המומלצת היא להוסיף את קוד ההטמעה ישירות לתבנית הדף של הנושא הפעיל שלך:
- גש להתקנת Backdrop CMS שלך דרך FTP או מנהל קבצים
- נווט לתיקיית הנושא הפעיל שלך: themes/yourtheme/
- פתח את קובץ page.tpl.php (או layout.tpl.php בהתאם לנושא שלך)
- מצא את תג הסגירה </body> או את השורה <?php print $page_bottom; ?>
- הדבק את קוד ההטמעה של Asyntai ממש לפני שורה זו
- שמור את הקובץ
<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>
טיפ: הצבת הקוד ממש לפני <?php print $page_bottom; ?> או תג הסגירה </body> מבטיחה שהצ'אטבוט ייטען אחרי תוכן הדף, ומספקת ביצועי טעינת דף טובים יותר. שיטה זו מוסיפה אוטומטית את הצ'אטבוט לכל דף שמשתמש בנושא זה.
שיטה חלופית 1: שימוש במודול מותאם אישית
אתה יכול ליצור מודול Backdrop CMS פשוט שמזריק את סקריפט הצ'אטבוט באמצעות backdrop_add_js():
- צור את תיקיית המודול: modules/custom/asyntai_widget/
- צור את קובץ המודול asyntai_widget.module עם הקוד הבא:
// modules/custom/asyntai_widget/asyntai_widget.module
function asyntai_widget_init() {
backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array(
'type' => 'external',
'scope' => 'footer',
'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'),
));
} - צור את קובץ asyntai_widget.info:
name = Asyntai AI Chatbot Widget
description = Adds the Asyntai AI chatbot widget to all pages.
backdrop = 1.x
package = Custom
type = module - עבור ל-Functionality (admin/modules) בפאנל הניהול של Backdrop
- מצא את "Asyntai AI Chatbot Widget" תחת חבילת Custom והפעל אותו
- לחץ על "Save configuration"
הערה: החלף את YOUR_WIDGET_ID בקוד המודול עם מזהה הווידג'ט האמיתי שלך מלוח הבקרה של Asyntai. גישת המודול המותאם אישית בטוחה לשדרוג ולא תידרס בעת עדכון הנושא.
שיטה חלופית 2: שימוש במודול "Add to Head" של Backdrop
המודול התורם "Add to Head" מספק דרך קלה להזריק סקריפטים ללא עריכת קוד:
- הורד והתקן את המודול התורם "Add to Head" מאתר Backdrop CMS
- עבור ל-Configuration > Development > Add to Head
- הוסף את קוד ההטמעה של Asyntai בחלק התחתון
- לחץ על "Save configuration"
טיפ: שימוש במודול "Add to Head" היא השיטה הקלה ביותר אם אתה מעדיף לא לערוך קבצי נושא או ליצור מודולים מותאמים אישית. היא מספקת ממשק ניהול פשוט לניהול סקריפטים מוזרקים.
שיטה חלופית 3: שימוש במערכת בלוקים
מערכת הפריסה והבלוקים של Backdrop CMS יכולה גם היא לשמש להוספת הצ'אטבוט:
- התחבר לפאנל הניהול של Backdrop CMS
- עבור ל-Structure > Layouts
- בחר את הפריסה שברצונך לערוך (למשל, פריסת ברירת המחדל)
- לחץ על "Add block" באזור התחתון
- בחר "Custom block"
- הגדר את פורמט הבלוק ל-"Full HTML" או "Raw HTML"
- הדבק את קוד ההטמעה של Asyntai בגוף הבלוק
- תן לבלוק כותרת (למשל, "Asyntai Chatbot") ואופציונלית סמן "Hide title"
- לחץ על "Save block" ואז "Save layout"
חשוב: ודא שפורמט הטקסט מוגדר ל-"Full HTML" או "Raw HTML" כדי שתג הסקריפט לא יוסר. פורמט "Filtered HTML" של ברירת המחדל יסיר תגי סקריפט מסיבות אבטחה.
שלב 3: נקה מטמון ואמת
לאחר ביצוע השינויים שלך, נקה את המטמון של Backdrop CMS ואמת את ההתקנה:
- עבור ל-Configuration > Performance בפאנל הניהול שלך
- לחץ על "Clear all caches"
- פתח את האתר שלך בלשונית דפדפן חדשה או חלון גלישה פרטית
- אתה אמור לראות את כפתור ווידג'ט הצ'אט בפינה הימנית התחתונה
- לחץ עליו כדי לוודא שהוא נפתח ועובד כראוי
לא רואה את הווידג'ט? ודא שניקית את המטמון של Backdrop CMS ב-Configuration > Performance. נסה לצפות באתר שלך בחלון גלישה פרטית או נקה את מטמון הדפדפן. פתח את קונסולת הדפדפן (F12) כדי לבדוק שגיאות JavaScript. אם השתמשת בשיטת המודול המותאם אישית, ודא שהמודול מופעל תחת Functionality.
Weebly