Sådan tilføjer du Asyntai AI-chatbot til TYPO3
Trin-for-trin-vejledning til TYPO3-websteder
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:
- Log ind på din TYPO3-backend
- Gå til Web → Skabelon
- Vælg din rodside i sidetræet
- Klik på "Rediger hele skabelonposten" (eller vælg "Info/Modificer" og derefter "Opsætning")
- 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> - Erstat
YOUR_WIDGET_IDmed dit faktiske widget-ID fra dashboardet - Klik på "Gem"
- 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:
- Naviger til din webstedspakkemappe:
packages/your_sitepackage/Configuration/TypoScript/ - Åbn eller opret setup.typoscript
- 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>
} - Erstat
YOUR_WIDGET_IDmed dit faktiske widget-ID - Ryd cachen i TYPO3-backend
Alternativ: Brug af Fluid-skabelon (FooterAssets)
For sites using Fluid templates, you can use the FooterAssets section:
- Naviger til din Fluid-skabelonfil (normalt i
Resources/Private/Templates/) - 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> - Sørg for, at dit sidelayout renderer FooterAssets-afsnittet:
<f:render section="FooterAssets" optional="true" /> - 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:
- I din PHP-kode (f.eks. en controller eller middleware) injicerer du AssetCollector
- 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.
Weebly