Hur du lägger till Asyntai AI-chattbot i Backdrop CMS

Steg-för-steg-guide för Backdrop CMS-webbplatser

Plattform:

Steg 1: Hämta din inbäddningskod

Gå först till din Asyntai-instrumentpanel och scrolla ner till avsnittet "Inbäddningskod". Kopiera din unika inbäddningskod som ser ut så här:

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

Obs! Koden ovan är bara ett exempel. Du måste kopiera din egen unika inbäddningskod från din Dashboard eftersom den innehåller ditt personliga widget-ID.

Steg 2: Lägg till i temamallen (rekommenderas)

Backdrop CMS använder .tpl.php-mallfiler i sina teman. Det rekommenderade tillvägagångssättet är att lägga till inbäddningskoden direkt i ditt aktiva temas sidmall:

Åtkomst till din Backdrop CMS-installation via FTP eller filhanteraren
Navigera till ditt aktiva temas katalog: themes/yourtheme/
Öppna filen page.tpl.php (eller layout.tpl.php beroende på ditt tema)
Hitta den avslutande taggen </body> eller raden <?php print $page_bottom; ?>
Klistra in din Asyntai-inbäddningskod precis före den raden
Spara filen

<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>

Tips: Att placera koden precis före <?php print $page_bottom; ?> eller den avslutande </body>-taggen säkerställer att chattboten laddas efter sidinnehållet, vilket ger bättre sidladdningsprestanda. Den här metoden lägger automatiskt till chattboten på varje sida som använder detta tema.

Alternativ metod 1: Använda en anpassad modul

Du kan skapa en enkel Backdrop CMS-modul som injicerar chatbot-scriptet med backdrop_add_js():

Skapa modulkatalogen: modules/custom/asyntai_widget/
Skapa modulfilen asyntai_widget.module med följande kod:
// modules/custom/asyntai_widget/asyntai_widget.module function asyntai_widget_init() { backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array( 'type' => 'external', 'scope' => 'footer', 'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'), )); }
Skapa filen asyntai_widget.info:
name = Asyntai AI Chatbot Widget description = Adds the Asyntai AI chatbot widget to all pages. backdrop = 1.x package = Custom type = module
Gå till Funktionalitet (admin/moduler) i din Backdrop-administratörspanel
Hitta "Asyntai AI Chatbot Widget" under paketet Custom och aktivera det
Klicka på "Spara konfiguration"

Obs! Ersätt YOUR_WIDGET_ID i modulkoden med ditt faktiska widget-ID från Asyntai-instrumentpanelen. Den anpassade modulmetoden är uppgraderingssäker och skrivs inte över när du uppdaterar ditt tema.

Alternativ metod 2: Använda Backdrops "Add to Head"-modul

Den bidragande "Add to Head"-modulen ger ett enkelt sätt att injicera skript utan att redigera kod:

Ladda ner och installera modulen "Add to Head" från Backdrop CMS website
Gå till Configuration > Development > Add to Head
Lägg till din Asyntai-inbäddningskod i footer section
Klicka på "Spara konfiguration"

Tips: Att använda "Add to Head"-modulen är den enklaste metoden om du föredrar att inte redigera temafiler eller skapa anpassade moduler. Den ger ett enkelt admingränssnitt för att hantera injicerade skript.

Alternativ metod 3: Använda blocksystemet

Backdrop CMS layout- och blocksystem kan också användas för att lägga till chattboten:

Logga in på din Backdrop CMS-adminpanel
Gå till Struktur > Layouter
Välj den layout du vill redigera (t.ex. standardlayouten)
Klicka på "Lägg till block" i sidfotsregionen
Välj "Custom block"
Ställ in blockformatet till "Full HTML" eller "Raw HTML"
Klistra in din Asyntai-inbäddningskod i blockkroppen
Ge blocket en titel (t.ex. "Asyntai Chatbot") och markera eventuellt "Hide title"
Klicka på "Spara block" och sedan "Spara layout"

Viktigt: Se till att textformatet är inställt på "Full HTML" eller "Raw HTML" så att script-taggen inte tas bort. Standardformatet "Filtered HTML" tar bort script-taggar av säkerhetsskäl.

Steg 3: Rensa cache och verifiera

Efter att du har gjort dina ändringar, rensa Backdrop CMS-cachen och verifiera installationen:

Gå till Konfiguration > Prestanda i din administratörspanel
Klicka på "Rensa alla cacheminnen"
Öppna din webbplats i en ny webbläsarflik eller ett inkognitofönster
Du bör se chattwidgetknappen i det nedre högra hörnet
Klicka på den för att kontrollera att den öppnas och fungerar korrekt

Ser du inte widgeten? Se till att du har rensat Backdrop CMS cache under Configuration > Performance. Prova att visa din webbplats i ett inkognitofönster eller rensa webbläsarens cache. Öppna webbläsarkonsolen (F12) för att kontrollera eventuella JavaScript-fel. Om du använde den anpassade modulmetoden, verifiera att modulen är aktiverad under Functionality.