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

פלטפורמה:

TYPO3

HTML/Custom WordPress Shopify WooCommerce BigCommerce Ecwid Wix Squarespace Webflow Weebly HubSpot Tilda Adobe Experience Manager Duda Google Sites Bludit Plesk Concrete CMS Craft CMS Contentful Docusaurus Strapi Joomla Kentico Drupal Magento Blogger Bitrix TYPO3 PrestaShop OpenCart Ghost Hugo Statamic Umbraco Volusion Moodle SilverStripe Grav October CMS ProcessWire Sanity ExpressionEngine Sylius Backdrop CMS MODX Bagisto PayloadCMS e107 CrafterCMS Kirby MedusaCMS DatoCMS GoDaddy Framer Bubble Carrd Jimdo Strikingly Kajabi Teachable Thinkific ClickFunnels Hostinger Unbounce Leadpages Systeme.io Instapage

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

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

שלב 2: שימוש ב-TypoScript footerData (מומלץ)

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

1. היכנסו לBackend של TYPO3
2. עברו אל Web → Template
3. בחרו את דף השורש בעץ הדפים
4. לחצו על "Edit the whole template record" (או בחרו "Info/Modify" ואז "Setup")
5. בשדה Setup, הוסיפו את קוד TypoScript הבא:
   page.footerData.99 = TEXT
page.footerData.99.value = <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>
6. החלף את YOUR_WIDGET_ID במזהה הווידג'ט האמיתי שלך מלוח הבקרה
7. לחץ על "Save"
8. נקו את מטמון TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

חלופה: שימוש ב-Site Package (ל-Site Packages)

אם אתם משתמשים ב-site package, ניתן להוסיף את הסקריפט דרך קובץ הגדרות TypoScript שלכם:

1. נווטו לתיקיית ה-site package שלכם: packages/your_sitepackage/Configuration/TypoScript/
2. פתחו או צרו setup.typoscript
3. הוסף את הקוד הבא:
   page.footerData {
  99 = TEXT
  99.value = <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>
}
4. החלף את YOUR_WIDGET_ID במזהה הווידג'ט האמיתי שלך
5. נקו את המטמון ב-backend של TYPO3

חלופה: שימוש בתבנית Fluid (FooterAssets)

לאתרים המשתמשים בתבניות Fluid, ניתן להשתמש בקטע FooterAssets:

1. נווטו לקובץ תבנית Fluid שלכם (בדרך כלל ב-Resources/Private/Templates/)
2. הוסיפו קטע FooterAssets ב-layout או בתבנית שלכם:
   <f:section name="FooterAssets">
  <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>
</f:section>
3. ודאו שה-layout של הדף שלכם מרנדר את קטע FooterAssets:
   <f:render section="FooterAssets" optional="true" />
4. נקו את מטמון TYPO3

חלופה: שימוש ב-AssetCollector (למפתחים)

למפתחי הרחבות, TYPO3 v10.3+ מציע את ה-API של AssetCollector:

1. בקוד PHP שלכם (למשל, controller או middleware), הזריקו את AssetCollector
2. הוסיפו את הסקריפט עם מאפיינים מותאמים אישית:
   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: אמת את ההתקנה

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