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

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

פלטפורמה:

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

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

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

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

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

הדרך המומלצת להוסיף את הצ'אטבוט היא על ידי עריכת תבנית MODX ישירות ב-MODX Manager:

היכנסו לMODX Manager (לוח ניהול)
בסרגל הצד השמאלי, עברו אל Elements > Templates
פתחו את תבנית האתר שלכם (בדרך כלל נקראת "BaseTemplate" או התבנית הפעילה שלכם)
מצאו את תגית הסגירה </body> בקוד התבנית
הדביקו את קוד ההטמעה של Asyntai ממש לפני תגית הסגירה </body>
לחצו על "Save" כדי לשמור את התבנית

<!-- Your existing template content -->

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

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

שיטה חלופית 1: שימוש ב-Chunk של MODX

ניתן להשתמש ב-Chunk של MODX כדי לשמור את קוד ההטמעה בנפרד ולשימוש חוזר:

ב-MODX Manager, עברו אל Elements > Chunks
לחצו על "New Chunk" כדי ליצור chunk חדש
תנו ל-chunk את השם "asyntaiWidget"
הדביקו את קוד ההטמעה של Asyntai באזור תוכן ה-chunk
לחץ על "Save"
פתחו את התבנית שלכם (תחת Elements > Templates)
הוסיפו את קריאת ה-chunk [[$asyntaiWidget]] ממש לפני תגית הסגירה </body>
שמור את התבנית

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

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

שיטה חלופית 2: שימוש בהגדרות מערכת MODX (HTML Head/Footer)

חלק מהתקנות MODX כוללות מצייני מקום לסקריפטים בפוטר דרך הגדרות מערכת:

ב-MODX Manager, עברו אל System > System Settings
סננו לפי "htmlhead" או חפשו הגדרת מערכת מותאמת אישית לסקריפטים בפוטר
אם ההתקנה שלכם כוללת מציין מקום לסקריפטים בפוטר (כמו [[++footer_scripts]]), ניתן להשתמש בו
הגדירו את ערך הגדרת המערכת לקוד ההטמעה של Asyntai
ודאו שמציין המקום המתאים [[++footer_scripts]] נמצא בתבנית שלכם לפני תגית הסגירה </body>
שמרו את הגדרת המערכת

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

הערה: שיטה זו תלויה בכך שהתקנת MODX שלכם כוללת הגדרת מערכת מותאמת אישית לסקריפטים בפוטר. אם אחת כזו לא קיימת, ניתן ליצור הגדרת מערכת מותאמת אישית ולהפנות אליה בתבנית באמצעות התחביר [[++setting_key]].

שיטה חלופית 3: שימוש בתוסף MODX (OnWebPagePrerender)

לגישה מתקדמת, ניתן ליצור תוסף MODX שמזריק אוטומטית את קוד הצ'אטבוט לכל דף:

ב-MODX Manager, עברו אל Elements > Plugins
לחצו על "New Plugin" כדי ליצור תוסף חדש
תנו לתוסף את השם "AsyntaiChatbot"
הדביקו את קוד ה-PHP הבא באזור קוד התוסף:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

לחצו על לשונית "System Events"
סמנו את התיבה ליד "OnWebPagePrerender" כדי להפעיל את התוסף באירוע זה
לחץ על "Save"

חשוב: החליפו את YOUR_WIDGET_ID במזהה הווידג'ט האמיתי שלכם מלוח הבקרה של Asyntai. תוסף זה יזריק אוטומטית את סקריפט הצ'אטבוט לכל דף באתר ה-MODX שלכם לפני הרינדור.

שלב 3: נקה מטמון ואמת

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

ב-MODX Manager, עברו אל Manage > Clear Cache (או לחצו על סמל ניקוי המטמון בתפריט העליון)
פתחו את האתר שלכם בלשונית דפדפן חדשה או בחלון גלישה פרטית
אתם אמורים לראות את כפתור ווידג'ט הצ'אט בפינה הימנית התחתונה של הדף
לחצו עליו כדי לוודא שהוא נפתח ופועל כראוי

לא רואה את הווידג'ט? ודאו שניקיתם את מטמון MODX מ-Manage > Clear Cache ב-MODX Manager. נסו גם לנקות את מטמון הדפדפן או לצפות באתר בחלון גלישה פרטית. אם השתמשתם בשיטת התוסף, ודאו שאירוע המערכת "OnWebPagePrerender" מסומן עבור התוסף שלכם.