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

מדריך צעד אחר צעד לאתרי Kentico CMS

פלטפורמה:

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

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

<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: הוספת קוד לתבנית Master Page (מומלץ)

להוספת הצ'אטבוט לכל עמודי אתר Kentico שלך בבת אחת, השתמש בשיטת תבנית Master Page:

התחבר ל-Kentico Admin שלך ונווט לאפליקציית Page templates
אתר ופתח את תבנית Master page שלך (התבנית שמשמשת בכל העמודים)
לחץ על כרטיסיית Header בעורך התבנית
בחלק ה-header, הדבק את קוד ההטמעה של Asyntai
לחלופין, הוסף את הקוד לפריסת התבנית לפני תגית הסגירה </head>
לחץ על Save כדי להחיל את השינויים
נקה את מטמון האתר שלך ואמת את השינויים באתר החי

טיפ: שימוש בתבנית Master Page מבטיח שהצ'אטבוט מופיע בכל עמוד שיורש מתבנית זו. זו השיטה היעילה ביותר לפריסה כוללת באתר ב-Kentico.

שיטה חלופית 1: Header של תבנית עמוד

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

עבור לאפליקציית Page templates ב-Kentico Admin
בחר את תבנית העמוד הספציפית שברצונך לערוך
לחץ על כרטיסיית Header
הוסף את קוד ההטמעה של Asyntai באמצעות תגית script:

<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>

לחץ על Save
כל העמודים שמשתמשים בתבנית זו יכללו כעת את הצ'אטבוט

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

שיטה חלופית 2: HEAD HTML Web Part

לשליטה מדויקת יותר בעמודים ספציפיים או ל-JavaScript ניתן לירושה בעמודי משנה:

פתח את העמוד שברצונך לערוך ב-עורך העמודים של Kentico
הוסף web part חדש לעמוד (עדיף בעמוד הורה לירושה)
חפש ובחר את web part HEAD HTML
בתצורת ה-web part, הדבק את קוד ההטמעה של Asyntai
הגדר את ה-web part כניתן לירושה אם ברצונך שעמודי משנה יכללו את הצ'אטבוט
לחץ על OK כדי לשמור את ה-web part
שמור ופרסם את העמוד

טיפ: ה-HEAD HTML web part מושלם להוספת קוד לעמוד הורה שיתפשט אוטומטית לכל עמודי המשנה, וייצור התקנה לכל החלק.

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

למפתחים שמעדיפים לנהל סקריפטים כקבצים:

בפרויקט Kentico שלך, נווט לתיקייה ~/CMSScripts/Custom/
צור קובץ JavaScript חדש (למשל, asyntai-widget.js)
הוסף קוד לטעינה דינמית של ווידג'ט Asyntai שלך:

(function() {
    var script = document.createElement('script');
    script.src = 'https://asyntai.com/static/js/chat-widget.js';
    script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
    script.async = true;
    document.head.appendChild(script);
})();

הפנה לקובץ זה ב-header של תבנית Master Page שלך:

<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

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

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

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

לא רואה את הווידג'ט? ודא ששמרת את כל השינויים וניקית את מטמון Kentico (Settings > System > Clear cache). נסה לצפות באתר שלך בחלון גלישה פרטית. בדוק במסוף הדפדפן (F12) אם יש שגיאות JavaScript שעלולות למנוע את טעינת הווידג'ט.