איך להוסיף צ'אטבוט AI של Asyntai ל-Craft CMS
מדריך צעד אחר צעד לאתרי Craft CMS
שלב 1: קבל את קוד ההטמעה שלך
ראשית, עבור ללוח הבקרה של Asyntai וגלול למטה לחלק "קוד הטמעה". העתק את קוד ההטמעה הייחודי שלך שייראה כך:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
הערה: הקוד למעלה הוא רק דוגמה. עליך להעתיק את קוד ההטמעה הייחודי שלך מלוח הבקרה שלך כיוון שהוא מכיל את מזהה הווידג'ט האישי שלך.
שלב 2: עריכת תבנית הפריסה שלך (מומלץ)
הדרך הקלה ביותר להוסיף את הצ'אטבוט לכל העמודים היא על ידי עריכת תבנית הפריסה הראשית שלך:
- גש לקבצי פרויקט Craft CMS שלך דרך FTP, SSH או עורך הקוד שלך
- נווט לתיקיית
templates/ - מצא את קובץ הפריסה הראשי שלך (בדרך כלל נקרא
_layout.twig,_layout.html, או נמצא ב-templates/_layouts/) - מצא את תג הסגירה
</body> - הדבק את קוד ההטמעה של Asyntai ממש לפני תג
</body> - שמור את הקובץ
טיפ: הוספת הסקריפט לפני תגית הסגירה </body> מבטיחה שהוא נטען לאחר תוכן העמוד, מה שמומלץ לווידג'טים של צ'אט ולא יאט את טעינת העמוד שלך.
Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)
Craft CMS מספק תגית Twig מובנית לרישום JavaScript:
- פתח את תבנית הפריסה הראשית שלך
- הוסף את הקוד הבא לפני תגית הסגירה
</body>:{% js %} (function() { var script = document.createElement('script'); script.async = true; script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); document.body.appendChild(script); })(); {% endjs %} - החלף את
YOUR_WIDGET_IDבמזהה הווידג'ט האמיתי שלך - שמור את הקובץ
הערה: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.
חלופה: יצירת קובץ include נפרד
לארגון טוב יותר, צור קובץ include ייעודי:
- צור קובץ חדש:
templates/_includes/chatbot.twig(או.html) - הוסף את קוד ההטמעה של Asyntai לקובץ זה:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - בתבנית הפריסה הראשית שלך, כלול קובץ זה לפני
</body>:{% include '_includes/chatbot' %} - שמור את שני הקבצים
טיפ: שימוש בקובץ include מקל על הפעלה/השבתה של הצ'אטבוט בכל האתר על ידי הפיכת שורה בודדת להערה.
חלופה: טעינה מותנית
לטעינת הצ'אטבוט רק בעמודים או בחלקים ספציפיים:
- בתבנית הפריסה או העמוד שלך, השתמש בתנאי Twig:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %} - או בדוק עבור חלקים ספציפיים:
{% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
שלב 3: אמת את ההתקנה
לאחר שמירת השינויים שלך, בקר באתר Craft CMS שלך בכרטיסיית דפדפן חדשה או בחלון גלישה פרטית. אתה אמור לראות את כפתור הצ'אט בפינה הימנית התחתונה. לחץ עליו כדי לוודא שהוא נפתח ופועל כראוי.
לא רואה את הווידג'ט? ודא ששמרת את קובץ התבנית ושאתה עורך את תבנית הפריסה הנכונה שהעמודים שלך משתמשים בה. נקה את מטמון הדפדפן או צפה בחלון גלישה פרטית. אם אתה משתמש במטמון תבניות, נקה את מטמון Craft CMS מלוח הבקרה תחת Utilities > Clear Caches.
מיקום התבנית: מיקומי תבניות Craft CMS עשויים להשתנות בהתאם להגדרת הפרויקט שלך. מיקומים נפוצים כוללים templates/_layout.twig, templates/_layouts/main.twig או templates/_base.twig. בדוק את התבניות הקיימות שלך כדי למצוא היכן תגית </body> מוגדרת.
Weebly