Cum să adăugați chatbotul AI Asyntai pe TYPO3
Ghid pas cu pas pentru site-uri TYPO3
Pasul 1: Obțineți codul de încorporare
Mai întâi, accesați Tabloul de bord Asyntai și derulați în jos până la secțiunea "Cod de încorporare". Copiați codul unic de încorporare care va arăta astfel:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></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 async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></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 async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></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)
For sites using Fluid templates, you can use the FooterAssets section:
- 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 async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></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