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

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

פלטפורמה:

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

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

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

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

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

הדרך המומלצת להוסיף את הצ'אטבוט היא על ידי עריכת ה-layout הברירת מחדל ב-backend של October CMS:

היכנסו לbackend של October CMS
עברו אל CMS > Layouts בתפריט הראשי
פתחו את ה-layout הברירת מחדל (בדרך כלל default.htm)
מצאו את תגית הסגירה </body> ואת {% scripts %} מציין המקום
הוסף את קוד ההטמעה של Asyntai ממש לפני {% scripts %} ו-</body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
לחצו על "Save" כדי להחיל את השינויים

טיפ: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

ניתן להשתמש במציין מקום הסקריפטים של October CMS כדי להזריק את הצ'אטבוט מדף או partial:

פתחו כל דף או partial בעורך ה-CMS
הוסף את הקוד הבא באמצעות {% put scripts %} בלוק:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
החלף את YOUR_WIDGET_ID במזהה הווידג'ט האמיתי שלך מלוח הבקרה
לחץ על "Save"

הערה: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

שיטה חלופית 2: שימוש ב-Component PHP

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

צרו או שנו component בתוסף October CMS שלכם
בשיטת onRun() של ה-component, השתמשו בשיטת addJs():
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
החלף את YOUR_WIDGET_ID במזהה הווידג'ט האמיתי שלך
רשמו את ה-component בדפים שבהם אתם רוצים שהצ'אטבוט יופיע

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

שיטה חלופית 3: שימוש ב-Partial

ניתן ליצור partial לשימוש חוזר עבור ווידג'ט הצ'אטבוט:

עברו אל CMS > Partials ב-backend של October CMS
לחצו על "+ Add" כדי ליצור partial חדש
תנו לו את השם asyntai-widget.htm
הוסיפו את קוד ההטמעה של Asyntai ל-partial:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
לחץ על "Save"
פתחו את תבנית ה-layout וכללו את ה-partial לפני </body>:
{% partial 'asyntai-widget' %}
שמרו את ה-layout

טיפ: שימוש ב-partial מקל על הפעלה או השבתה של הצ'אטבוט בכל האתר על ידי הוספה או הסרה של ה-partial מה-layout.

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

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

לא רואה את הווידג'ט? ודאו ששמרתם את כל השינויים ב-backend של ה-CMS. נקו את מטמון הדפדפן או צפו בחלון גלישה פרטית. אם האתר שלכם משתמש במטמון, נקו את מטמון October CMS על ידי הרצת php artisan cache:clear משורת הפקודה, או השתמשו באפשרות Settings > System > Clear Cache ב-backend.

בחירת Layout: ודאו שהדפים שבהם אתם רוצים שהצ'אטבוט יופיע משתמשים ב-layout הנכון. ניתן לבדוק באיזה layout דף משתמש על ידי פתיחת הדף ב-CMS > Pages והסתכלות על התפריט הנפתח Layout בהגדרות הדף.