Asyntai AI -chatbotin lisääminen TYPO3:een

Vaiheittainen opas TYPO3-verkkosivustoille

Hae upotuskoodi

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:

  1. Kirjaudu TYPO3-hallintapaneeliin
  2. Siirry kohtaan Web → Template
  3. Valitse juurisivu sivupuusta
  4. Napsauta "Edit the whole template record" (tai valitse "Info/Modify" ja sitten "Setup")
  5. 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>
  6. Korvaa YOUR_WIDGET_ID todellisella widget-tunnuksellasi hallintapaneelista
  7. Napsauta "Save"
  8. 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:

  1. Siirry sivustopakettikansioosi: packages/your_sitepackage/Configuration/TypoScript/
  2. Avaa tai luo setup.typoscript
  3. 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>
    }
  4. Korvaa YOUR_WIDGET_ID todellisella widget-tunnuksellasi
  5. Tyhjennä välimuisti TYPO3-hallintapaneelissa

Vaihtoehto: Fluid-mallin käyttö (FooterAssets)

Fluid-malleja käyttäville sivustoille voit käyttää FooterAssets-osiota:

  1. Siirry Fluid-mallitiedostoosi (yleensä kansiossa Resources/Private/Templates/)
  2. 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>
  3. Varmista, että sivun asettelu renderöi FooterAssets-osion:
    <f:render section="FooterAssets" optional="true" />
  4. 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:

  1. Lisää PHP-koodissasi (esim. kontrollerissa tai middlewaressa) AssetCollector
  2. 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.