כיצד להוסיף צ'אטבוט AI של Asyntai ל-TYPO3
מדריך צעד אחר צעד לאתרי TYPO3
שלב 1: קבל את קוד ההטמעה שלך
ראשית, עבור ללוח הבקרה של Asyntai וגלול למטה לחלק "קוד הטמעה". העתק את קוד ההטמעה הייחודי שלך שייראה כך:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
הערה: הקוד למעלה הוא רק דוגמה. עליך להעתיק את קוד ההטמעה הייחודי שלך מלוח הבקרה שלך כיוון שהוא מכיל את מזהה הווידג'ט האישי שלך.
שלב 2: שימוש ב-TypoScript footerData (מומלץ)
הדרך הקלה ביותר להוסיף את הצ'אטבוט לכל הדפים היא באמצעות TypoScript footerData:
- היכנסו לBackend של TYPO3
- עברו אל Web → Template
- בחרו את דף השורש בעץ הדפים
- לחצו על "Edit the whole template record" (או בחרו "Info/Modify" ואז "Setup")
- בשדה Setup, הוסיפו את קוד TypoScript הבא:
page.footerData.99 = TEXT
page.footerData.99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - החלף את
YOUR_WIDGET_IDבמזהה הווידג'ט האמיתי שלך מלוח הבקרה - לחץ על "Save"
- נקו את מטמון TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
טיפ: שימוש ב-footerData ממקם את הסקריפט ממש לפני תגית הסגירה </body>, מה שמומלץ לווידג'טים של צ'אט מכיוון שהוא לא יאט את טעינת הדף.
חלופה: שימוש ב-Site Package (ל-Site Packages)
אם אתם משתמשים ב-site package, ניתן להוסיף את הסקריפט דרך קובץ הגדרות TypoScript שלכם:
- נווטו לתיקיית ה-site package שלכם:
packages/your_sitepackage/Configuration/TypoScript/ - פתחו או צרו setup.typoscript
- הוסף את הקוד הבא:
page.footerData {
99 = TEXT
99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
} - החלף את
YOUR_WIDGET_IDבמזהה הווידג'ט האמיתי שלך - נקו את המטמון ב-backend של TYPO3
חלופה: שימוש בתבנית Fluid (FooterAssets)
לאתרים המשתמשים בתבניות Fluid, ניתן להשתמש בקטע FooterAssets:
- נווטו לקובץ תבנית Fluid שלכם (בדרך כלל ב-
Resources/Private/Templates/) - הוסיפו קטע FooterAssets ב-layout או בתבנית שלכם:
<f:section name="FooterAssets">
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</f:section> - ודאו שה-layout של הדף שלכם מרנדר את קטע FooterAssets:
<f:render section="FooterAssets" optional="true" /> - נקו את מטמון TYPO3
חשוב: תכונת FooterAssets דורשת TYPO3 v8 ומעלה. לגרסאות ישנות יותר, השתמשו בשיטת TypoScript footerData.
חלופה: שימוש ב-AssetCollector (למפתחים)
למפתחי הרחבות, TYPO3 v10.3+ מציע את ה-API של AssetCollector:
- בקוד PHP שלכם (למשל, controller או middleware), הזריקו את AssetCollector
- הוסיפו את הסקריפט עם מאפיינים מותאמים אישית:
use TYPO3\CMS\Core\Page\AssetCollector;
$this->assetCollector->addJavaScript(
'asyntai_chatbot',
'https://asyntai.com/static/js/chat-widget.js',
['async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID']
);
שלב 3: אמת את ההתקנה
לאחר שמירת השינויים וניקוי המטמון, בקר באתר שלך בכרטיסיית דפדפן חדשה או בחלון גלישה פרטית. אתה אמור לראות את כפתור הצ'אט בפינה הימנית התחתונה. לחץ עליו כדי לוודא שהוא נפתח ופועל כראוי.
לא רואה את הווידג'ט? הקפידו לנקות את כל המטמונים: עברו אל Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. נסו גם לנקות את מטמון הדפדפן או לצפות בחלון גלישה פרטית. אם משתמשים ב-TypoScript, ודאו שהתבנית שלכם כלולה כראוי בהיררכיית הדפים.
Weebly