Asyntai AI -chatbotin lisääminen TYPO3:een
Vaiheittainen opas TYPO3-verkkosivustoille
Vaihe 1: Hanki upotuskoodisi
Siirry ensin Asyntai-hallintapaneeliin ja vieritä alas "Upotuskoodi"-osioon. Kopioi yksilöllinen upotuskoodisi, joka näyttää tältä:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Huomautus: Yllä oleva koodi on vain esimerkki. Sinun on kopioitava oma yksilöllinen upotuskoodisi Hallintapaneelistasi, sillä se sisältää henkilökohtaisen widget-tunnuksesi.
Vaihe 2: TypoScript footerDatan käyttö (suositeltu)
Helpoin tapa lisätä chatbot kaikille sivuille on käyttää TypoScript footerDataa:
- Kirjaudu TYPO3-hallintapaneeliin
- Siirry kohtaan Web → Template
- Valitse juurisivu sivupuusta
- Napsauta "Edit the whole template record" (tai valitse "Info/Modify" ja sitten "Setup")
- Lisää Setup-kenttään seuraava TypoScript-koodi:
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> - Korvaa
YOUR_WIDGET_IDtodellisella widget-tunnuksellasi hallintapaneelista - Napsauta "Save"
- Tyhjennä TYPO3-välimuisti: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
Vinkki: footerData sijoittaa skriptin juuri ennen sulkevaa </body>-tagia, mikä on suositeltavaa chat-widgeteille, koska se ei hidasta sivun latautumista.
Vaihtoehto: Sivustopaketin käyttö (sivustopaketeille)
Jos käytät sivustopakettia, voit lisätä skriptin TypoScript-konfiguraatiotiedostosi kautta:
- Siirry sivustopakettikansioosi:
packages/your_sitepackage/Configuration/TypoScript/ - Avaa tai luo setup.typoscript
- Lisää seuraava koodi:
page.footerData {
99 = TEXT
99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
} - Korvaa
YOUR_WIDGET_IDtodellisella widget-tunnuksellasi - Tyhjennä välimuisti TYPO3-hallintapaneelissa
Vaihtoehto: Fluid-mallin käyttö (FooterAssets)
Fluid-malleja käyttäville sivustoille voit käyttää FooterAssets-osiota:
- Siirry Fluid-mallitiedostoosi (yleensä kansiossa
Resources/Private/Templates/) - Lisää FooterAssets-osio asettelu- tai mallitiedostoosi:
<f:section name="FooterAssets">
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</f:section> - Varmista, että sivun asettelu renderöi FooterAssets-osion:
<f:render section="FooterAssets" optional="true" /> - Tyhjennä TYPO3-välimuisti
Tärkeää: FooterAssets-ominaisuus vaatii TYPO3 v8:n tai uudemman. Vanhemmille versioille käytä TypoScript footerData -menetelmää.
Vaihtoehto: AssetCollectorin käyttö (kehittäjille)
Laajennuskehittäjille TYPO3 v10.3+ tarjoaa AssetCollector API:n:
- Lisää PHP-koodissasi (esim. kontrollerissa tai middlewaressa) AssetCollector
- Lisää skripti mukautetuilla attribuuteilla:
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']
);
Vaihe 3: Vahvista asennus
Kun olet tallentanut muutokset ja tyhjentänyt välimuistin, avaa verkkosivustosi uudessa selaimen välilehdessä tai incognito-ikkunassa. Chat-painikkeen pitäisi näkyä oikeassa alakulmassa. Napsauta sitä varmistaaksesi, että se avautuu ja toimii oikein.
Etkö näe widgetiä? Varmista, että tyhjennät kaikki välimuistit: siirry kohtaan Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Kokeile myös tyhjentää selaimen välimuisti tai tarkastella incognito-ikkunassa. Jos käytät TypoScriptiä, varmista, että mallisi on sisällytetty oikein sivuhierarkiaan.
Weebly