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

Trin-for-trin-vejledning til Backdrop CMS-hjemmesider

Platform:

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: Tilføj til temaskabelon (anbefalet)

Backdrop CMS bruger .tpl.php-skabelonfiler i sine temaer. Den anbefalede tilgang er at tilføje indlejringskoden direkte til dit aktive temas sideskabelon:

Tilgå din Backdrop CMS-installation via FTP eller Filhåndtering
Naviger til dit aktive temas mappe: themes/ditatema/
Åbn filen page.tpl.php (eller layout.tpl.php afhængigt af dit tema)
Find det afsluttende </body>-tag eller linjen <?php print $page_bottom; ?>
Indsæt din Asyntai indlejringskode lige inden den linje
Gem 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>

Tip: Placering af koden lige inden <?php print $page_bottom; ?> eller det afsluttende </body>-tag sikrer, at chatbotten indlæses efter sideindholdet, hvilket giver bedre sideindlæsningsydelse. Denne metode tilføjer automatisk chatbotten til alle sider, der bruger dette tema.

Alternativ metode 1: Brug af et brugerdefineret modul

Du kan oprette et simpelt Backdrop CMS-modul, der injicerer chatbot-scriptet ved hjælp af backdrop_add_js():

Opret modulets mappe: modules/custom/asyntai_widget/
Opret modulfilen asyntai_widget.module med følgende kode:
// 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'), )); }
Opret 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å til Funktionalitet (admin/modules) i dit Backdrop-adminpanel
Find "Asyntai AI Chatbot Widget" under Brugerdefineret-pakken og aktivér den
Klik på "Gem konfiguration"

Bemærk: Erstat YOUR_WIDGET_ID i modulkoden med dit faktiske widget-ID fra Asyntai Dashboard. Den brugerdefinerede modultilgang er opgraderingssikker og vil ikke blive overskrevet, når du opdaterer dit tema.

Alternativ metode 2: Brug af Backdrops "Tilføj til head"-modul

Det bidragende "Tilføj til head"-modul giver en nem måde at injicere scripts på uden at redigere kode:

Download og installer det bidragende modul "Tilføj til head" fra Backdrop CMS-hjemmesiden
Gå til Konfiguration > Udvikling > Tilføj til head
Tilføj din Asyntai indlejringskode i sidefodsektionen
Klik på "Gem konfiguration"

Tip: Brug af "Tilføj til head"-modulet er den nemmeste metode, hvis du foretrækker ikke at redigere temafiler eller oprette brugerdefinerede moduler. Det giver en simpel administratorgrænseflade til håndtering af injicerede scripts.

Alternativ metode 3: Brug af bloksystem

Backdrop CMS's layout- og bloksystem kan også bruges til at tilføje chatbotten:

Log ind på dit Backdrop CMS-adminpanel
Gå til Struktur > Layouts
Vælg det layout, du vil redigere (f.eks. standardlayoutet)
Klik på "Tilføj blok" i sidefodsregionen
Vælg "Brugerdefineret blok"
Indstil blokformatet til "Fuld HTML" eller "Rå HTML"
Indsæt din Asyntai indlejringskode i blokindholdet
Giv blokken en titel (f.eks. "Asyntai Chatbot") og marker eventuelt "Skjul titel"
Klik på "Gem blok" og derefter "Gem layout"

Vigtigt: Sørg for, at tekstformatet er indstillet til "Fuld HTML" eller "Rå HTML", så script-tagget ikke fjernes. Standardformatet "Filtreret HTML" fjerner script-tags af sikkerhedsmæssige årsager.

Trin 3: Ryd cache og verificér

Når du har foretaget dine ændringer, skal du rydde Backdrop CMS's cache og verificere installationen:

Gå til Konfiguration > Ydeevne i dit adminpanel
Klik på "Ryd alle caches"
Åbn din hjemmeside 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 du har ryddet Backdrop CMS's cache under Konfiguration > Ydeevne. Prøv at se dit websted i et inkognitovindue eller ryd din browsers cache. Åbn browserkonsollen (F12) for at tjekke for JavaScript-fejl. Hvis du brugte den brugerdefinerede modulmetode, skal du verificere, at modulet er aktiveret under Funktionalitet.