Kako dodati klepetalnik Asyntai AI v TYPO3

Vodič po korakih za spletna mesta TYPO3

Platforma:

Korak 1: Pridobite svojo vdelovalno kodo

Najprej pojdite na svojo Nadzorno ploščo Asyntai in se pomaknite navzdol do razdelka "Vdelovalna koda". Kopirajte svojo edinstveno vdelovalno kodo, ki bo videti takole:

<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>

Opomba: Zgornja koda je le primer. Svojo edinstveno vdelovalno kodo morate kopirati iz svoje Nadzorne plošče, saj vsebuje vaš osebni ID klepetalnika.

Korak 2: Uporaba TypoScript footerData (priporočeno)

Najlažji način za dodajanje klepetalnika na vse strani je uporaba TypoScript footerData:

Prijavite se v svoje zaledje TYPO3
Pojdite na Splet → Predloga
Izberite svojo korensko stran v drevesu strani
Kliknite na "Uredi celoten zapis predloge" (ali izberite "Info/Spremeni" in nato "Nastavitev")
V polje Nastavitev dodajte naslednjo kodo 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>
Zamenjajte YOUR_WIDGET_ID s svojim dejanskim ID-jem klepetalnika z nadzorne plošče
Kliknite "Shrani"
Počistite predpomnilnik TYPO3: Skrbniška orodja → Vzdrževanje → Počisti predpomnilnik TYPO3 in PHP

Nasvet: Uporaba footerData umesti skripto tik pred zaključno oznako </body>, kar je priporočeno za pripomočke za klepet, saj ne bo upočasnilo nalaganja vaše strani.

Alternativa: Uporaba paketa spletnega mesta (za pakete spletnih mest)

Če uporabljate paket spletnega mesta, lahko dodate skripto prek svoje konfiguracijske datoteke TypoScript:

Pojdite v mapo paketa spletnega mesta: packages/your_sitepackage/Configuration/TypoScript/
Odprite ali ustvarite setup.typoscript
Dodajte naslednjo kodo:
page.footerData { 99 = TEXT 99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> }
Replace YOUR_WIDGET_ID with your actual widget ID
Počistite predpomnilnik v zaledju TYPO3

Alternativa: Uporaba predloge Fluid (FooterAssets)

For sites using Fluid templates, you can use the FooterAssets section:

Pojdite do svoje datoteke predloge Fluid (običajno v Resources/Private/Templates/)
Dodajte razdelek FooterAssets v svojo postavitev ali predlogo:
<f:section name="FooterAssets"> <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> </f:section>
Prepričajte se, da vaša postavitev strani upodablja razdelek FooterAssets:
<f:render section="FooterAssets" optional="true" />
Počistite predpomnilnik TYPO3

Pomembno: Funkcija FooterAssets zahteva TYPO3 v8 ali novejši. Za starejše različice uporabite način z TypoScript footerData.

Alternativa: Uporaba AssetCollector (za razvijalce)

Za razvijalce razširitev TYPO3 v10.3+ ponuja API AssetCollector:

V svoji kodi PHP (npr. krmilnik ali vmesna programska oprema) vstavite AssetCollector
Dodajte skripto z atributi po meri:
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'] );

Korak 3: Preverite namestitev

Po shranjevanju sprememb in čiščenju predpomnilnika obiščite svojo spletno stran v novem zavihku brskalnika ali oknu brez beleženja. V spodnjem desnem kotu bi morali videti gumb klepetalnika. Kliknite ga, da preverite, ali se pravilno odpre in deluje.

Ne vidite klepetalnika? Počistite vse predpomnilnike: pojdite na Skrbniška orodja → Vzdrževanje → Počisti predpomnilnik TYPO3 in PHP. Poskusite tudi počistiti predpomnilnik brskalnika ali stran ogledati v oknu brez beleženja. Če uporabljate TypoScript, preverite, da je vaša predloga pravilno vključena v hierarhijo strani.