Slik legger du til Asyntai AI-chatbot i TYPO3

Trinn-for-trinn-guide for TYPO3-nettsteder

Hent innebyggingskode

Trinn 1: Hent innbyggingskoden din

Gå først til Asyntai-dashbordet ditt og bla ned til «Innbyggingskode»-seksjonen. Kopier din unike innbyggingskode som vil se slik ut:

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

Merk: Koden ovenfor er bare et eksempel. Du må kopiere din egen unike innbyggingskode fra Dashbordet ditt, da den inneholder din personlige widget-ID.

Trinn 2: Bruk av TypoScript footerData (anbefalt)

Den enkleste måten å legge til chatboten på alle sider er å bruke TypoScript footerData:

  1. Logg inn på TYPO3 Backend
  2. Gå til Web → Template
  3. Velg rotsiden din i sidetreet
  4. Klikk på «Edit the whole template record» (eller velg «Info/Modify» og deretter «Setup»)
  5. I Setup-feltet, legg til følgende TypoScript-kode:
    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. Erstatt YOUR_WIDGET_ID med din faktiske widget-ID fra dashbordet
  7. Klikk på «Lagre»
  8. Tøm TYPO3-bufferen: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache

Tips: Bruk av footerData plasserer skriptet rett før den avsluttende </body>-taggen, som anbefales for chatwidgeter da det ikke vil bremse sideinnlastingen din.

Alternativ: Bruk av nettstedspakke (for nettstedspakker)

Hvis du bruker en nettstedspakke, kan du legge til skriptet via TypoScript-konfigurasjonsfilen din:

  1. Naviger til nettstedspakkemappen din: packages/your_sitepackage/Configuration/TypoScript/
  2. Åpne eller opprett setup.typoscript
  3. Legg til følgende kode:
    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. Erstatt YOUR_WIDGET_ID med din faktiske widget-ID
  5. Tøm bufferen i TYPO3 backend

Alternativ: Bruk av Fluid-mal (FooterAssets)

For nettsteder som bruker Fluid-maler, kan du bruke FooterAssets-seksjonen:

  1. Naviger til Fluid-malfilen din (vanligvis i Resources/Private/Templates/)
  2. Legg til en FooterAssets-seksjon i oppsettet eller malen din:
    <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. Forsikre deg om at sideoppsettet ditt gjengir FooterAssets-seksjonen:
    <f:render section="FooterAssets" optional="true" />
  4. Tøm TYPO3-bufferen

Viktig: FooterAssets-funksjonen krever TYPO3 v8 eller nyere. For eldre versjoner, bruk TypoScript footerData-metoden.

Alternativ: Bruk av AssetCollector (for utviklere)

For utvidelseutviklere tilbyr TYPO3 v10.3+ AssetCollector-API-et:

  1. I PHP-koden din (f.eks. en kontroller eller mellomvare), injiser AssetCollector
  2. Legg til skriptet med egendefinerte attributter:
    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']
    );

Trinn 3: Bekreft installasjonen

Etter at du har lagret endringene og tømt hurtigbufferen, besøk nettstedet ditt i en ny nettleserfane eller et inkognitovindu. Du bør se chatwidget-knappen i nedre høyre hjørne. Klikk på den for å sjekke at den åpnes og fungerer riktig.

Ser du ikke widgeten? Forsikre deg om at du tømmer alle buffere: gå til Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Prøv også å tømme nettleserbufferen eller se i et inkognitovindu. Hvis du bruker TypoScript, verifiser at malen din er riktig inkludert i sidehierarkiet.