Sådan tilføjer du Asyntai AI-chatbot til TYPO3

Trin-for-trin-vejledning til TYPO3-websteder

Hent indlejringskode

Trin 1: Hent din indlejringskode

Gå først til dit Asyntai Dashboard og rul ned til sektionen "Indlejringskode". Kopiér din unikke indlejringskode, der vil se sådan ud:

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

Bemærk: Koden ovenfor er blot et eksempel. Du skal kopiere din egen unikke indlejringskode fra dit Dashboard, da den indeholder dit personlige widget-ID.

Trin 2: Brug af TypoScript footerData (anbefalet)

Den nemmeste måde at tilføje chatbotten til alle sider er ved at bruge TypoScript footerData:

  1. Log ind på din TYPO3-backend
  2. Gå til Web → Skabelon
  3. Vælg din rodside i sidetræet
  4. Klik på "Rediger hele skabelonposten" (eller vælg "Info/Modificer" og derefter "Opsætning")
  5. I feltet Opsætning tilføjer du 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. Erstat YOUR_WIDGET_ID med dit faktiske widget-ID fra dashboardet
  7. Klik på "Gem"
  8. Ryd TYPO3-cachen: Adminværktøjer → Vedligeholdelse → Tøm TYPO3 og PHP-cache

Tip: Brug af footerData placerer scriptet lige før det afsluttende </body>-tag, hvilket anbefales til chat-widgets, da det ikke vil bremse din sideindlæsning.

Alternativ: Brug af webstedspakke (til webstedspakker)

Hvis du bruger en webstedspakke, kan du tilføje scriptet via din TypoScript-konfigurationsfil:

  1. Naviger til din webstedspakkemappe: packages/your_sitepackage/Configuration/TypoScript/
  2. Åbn eller opret setup.typoscript
  3. Tilføj 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. Erstat YOUR_WIDGET_ID med dit faktiske widget-ID
  5. Ryd cachen i TYPO3-backend

Alternativ: Brug af Fluid-skabelon (FooterAssets)

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

  1. Naviger til din Fluid-skabelonfil (normalt i Resources/Private/Templates/)
  2. Tilføj et FooterAssets-afsnit i dit layout eller din skabelon:
    <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. Sørg for, at dit sidelayout renderer FooterAssets-afsnittet:
    <f:render section="FooterAssets" optional="true" />
  4. Ryd TYPO3-cachen

Vigtigt: FooterAssets-funktionen kræver TYPO3 v8 eller nyere. Til ældre versioner skal du bruge TypoScript footerData-metoden.

Alternativ: Brug af AssetCollector (til udviklere)

Til udvidelsesudviklere tilbyder TYPO3 v10.3+ AssetCollector API:

  1. I din PHP-kode (f.eks. en controller eller middleware) injicerer du AssetCollector
  2. Tilføj scriptet med brugerdefinerede 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']
    );

Trin 3: Verificér installationen

Efter at have gemt dine ændringer og ryddet cachen skal du besøge dit websted i en ny browserfane eller et inkognitovindue. Du bør se chat-widget-knappen i nederste højre hjørne. Klik på den for at sikre, at den åbner og fungerer korrekt.

Ser du ikke widget'en? Sørg for at rydde alle caches: gå til Adminværktøjer → Vedligeholdelse → Tøm TYPO3 og PHP-cache. Prøv også at rydde din browsercache eller se siden i et inkognitovindue. Hvis du bruger TypoScript, skal du bekræfte, at din skabelon er korrekt inkluderet i sidehierarkiet.