Cum să adăugați Chatbot-ul AI Asyntai în TYPO3
Ghid pas cu pas pentru site-uri TYPO3
Pasul 1: Obțineți codul de încorporare
Mai întâi, accesați panoul de control Asyntai și derulați în jos până la secțiunea "Cod de integrare". Copiați codul dvs. unic de integrare, care va arăta astfel:
<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>
Notă: Codul de mai sus este doar un exemplu. Trebuie să copiați propriul cod unic de încorporare din Tabloul de bord, deoarece conține ID-ul personal al widgetului dvs.
Pasul 2: Utilizarea TypoScript footerData (recomandat)
Cea mai ușoară modalitate de a adăuga chatbotul pe toate paginile este utilizarea TypoScript footerData:
- Conectați-vă la Backend-ul TYPO3
- Accesați Web → Șablon
- Selectați pagina rădăcină în arborele de pagini
- Faceți clic pe "Editați întreaga înregistrare de șablon" (sau selectați "Informații/Modificare" și apoi "Configurare")
- În câmpul Setup, adăugați următorul cod 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> - Înlocuiți
YOUR_WIDGET_IDcu ID-ul real al widget-ului din tabloul de bord - Faceți clic pe "Salvare"
- Goliți memoria cache TYPO3: Instrumente admin → Întreținere → Golire cache TYPO3 și PHP
Sfat: Utilizarea footerData plasează scriptul chiar înainte de eticheta de închidere </body>, ceea ce este recomandat pentru widgeturile de chat deoarece nu va încetini încărcarea paginii.
Alternativă: Utilizarea pachetului de site (pentru pachete de site)
Dacă utilizați un pachet de site, puteți adăuga scriptul prin fișierul de configurare TypoScript:
- Navigați la folderul pachetului de site:
packages/your_sitepackage/Configuration/TypoScript/ - Deschideți sau creați setup.typoscript
- Adăugați următorul cod:
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>
} - Înlocuiți
YOUR_WIDGET_IDcu ID-ul real al widget-ului dvs. - Goliți memoria cache în backend-ul TYPO3
Alternativă: Utilizarea șablonului Fluid (FooterAssets)
Pentru site-urile care utilizează șabloane Fluid, puteți utiliza secțiunea FooterAssets:
- Navigați la fișierul șablonului Fluid (de obicei în
Resources/Private/Templates/) - Adăugați o secțiune FooterAssets în layout-ul sau șablonul dvs.:
<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> - Asigurați-vă că layout-ul paginii dvs. randează secțiunea FooterAssets:
<f:render section="FooterAssets" optional="true" /> - Goliți memoria cache TYPO3
Important: Funcționalitatea FooterAssets necesită TYPO3 v8 sau mai recent. Pentru versiuni mai vechi, utilizați metoda TypoScript footerData.
Alternativă: Utilizarea AssetCollector (pentru dezvoltatori)
Pentru dezvoltatorii de extensii, TYPO3 v10.3+ oferă API-ul AssetCollector:
- În codul dvs. PHP (de ex., un controller sau middleware), injectați AssetCollector
- Adăugați scriptul cu atribute personalizate:
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']
);
Pasul 3: Verificați instalarea
După ce ați salvat modificările și ați golit cache-ul, vizitați site-ul dvs. într-o filă nouă de browser sau într-o fereastră incognito. Ar trebui să vedeți butonul widget-ului de chat în colțul din dreapta jos. Faceți clic pe el pentru a vă asigura că se deschide și funcționează corect.
Nu vedeți widgetul? Asigurați-vă că goliți toate cache-urile: accesați Instrumente admin → Întreținere → Golire cache TYPO3 și PHP. De asemenea, încercați să goliți memoria cache a browserului sau să vizualizați într-o fereastră incognito. Dacă utilizați TypoScript, verificați dacă șablonul dvs. este inclus corect în ierarhia paginilor.
Weebly