Hoe u de Asyntai AI-chatbot toevoegt aan Backdrop CMS

Stapsgewijze handleiding voor Backdrop CMS-websites

Platform:

Stap 1: Uw insluitcode ophalen

Ga eerst naar uw Asyntai Dashboard en scroll naar het gedeelte "Insluitcode". Kopieer uw unieke insluitcode die er als volgt uitziet:

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

Opmerking: De bovenstaande code is slechts een voorbeeld. U moet uw eigen unieke insluitcode kopiëren vanuit uw Dashboard omdat deze uw persoonlijke widget-ID bevat.

Stap 2: Toevoegen aan themasjabloon (aanbevolen)

Backdrop CMS gebruikt .tpl.php-sjabloonbestanden in zijn thema's. De aanbevolen aanpak is om de insluitcode rechtstreeks toe te voegen aan het paginasjabloon van uw actieve thema:

Ga naar uw Backdrop CMS-installatie via FTP of Bestandsbeheer
Navigeer naar de map van uw actieve thema: themes/yourtheme/
Open het bestand page.tpl.php (of layout.tpl.php afhankelijk van uw thema)
Zoek de sluitende </body>-tag of de regel <?php print $page_bottom; ?>
Plak uw Asyntai-insluitcode vlak voor die regel
Sla het bestand op

<!-- 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: Door de code vlak voor <?php print $page_bottom; ?> of de sluitende </body>-tag te plaatsen, zorgt u ervoor dat de chatbot na de pagina-inhoud wordt geladen, wat betere laadprestaties oplevert. Deze methode voegt de chatbot automatisch toe aan elke pagina die dit thema gebruikt.

Alternatieve methode 1: Een aangepaste module gebruiken

U kunt een eenvoudige Backdrop CMS-module maken die het chatbotscript injecteert met backdrop_add_js():

Maak de modulemap aan: modules/custom/asyntai_widget/
Maak het modulebestand asyntai_widget.module aan met de volgende code:
// 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'), )); }
Maak het bestand asyntai_widget.info aan:
name = Asyntai AI Chatbot Widget description = Adds the Asyntai AI chatbot widget to all pages. backdrop = 1.x package = Custom type = module
Ga naar Functionaliteit (admin/modules) in uw Backdrop-beheerpaneel
Zoek "Asyntai AI Chatbot Widget" onder het pakket Aangepast en schakel het in
Klik op "Configuratie opslaan"

Opmerking: Vervang YOUR_WIDGET_ID in de modulecode door uw werkelijke widget-ID uit het Asyntai Dashboard. De aanpak met een aangepaste module is upgradebestendig en wordt niet overschreven bij het bijwerken van uw thema.

Alternatieve methode 2: Backdrop's "Add to Head"-module gebruiken

De bijgedragen "Add to Head"-module biedt een eenvoudige manier om scripts te injecteren zonder code te bewerken:

Download en installeer de bijgedragen module "Add to Head" van de Backdrop CMS-website
Ga naar Configuratie > Ontwikkeling > Toevoegen aan Head
Voeg uw Asyntai-insluitcode toe in de footersectie
Klik op "Configuratie opslaan"

Tip: Het gebruik van de "Add to Head"-module is de eenvoudigste methode als u liever geen themabestanden bewerkt of aangepaste modules maakt. Het biedt een eenvoudige beheerinterface voor het beheren van geïnjecteerde scripts.

Alternatieve methode 3: Het bloksysteem gebruiken

Het lay-out- en bloksysteem van Backdrop CMS kan ook worden gebruikt om de chatbot toe te voegen:

Log in op uw Backdrop CMS-beheerpaneel
Ga naar Structure > Layouts
Selecteer de lay-out die u wilt bewerken (bijv. de standaard lay-out)
Klik op "Add block" in het footer-gedeelte
Kies "Custom block"
Stel het blokformaat in op "Full HTML" of "Raw HTML"
Plak uw Asyntai-insluitcode in de blokinhoud
Geef het blok een titel (bijv. "Asyntai Chatbot") en vink optioneel "Hide title" aan
Klik op "Save block" en vervolgens op "Save layout"

Belangrijk: Zorg ervoor dat het tekstformaat is ingesteld op "Full HTML" of "Raw HTML", zodat de scripttag niet wordt verwijderd. Het standaard "Filtered HTML"-formaat verwijdert scripttags om veiligheidsredenen.

Stap 3: Cache wissen en verifiëren

Wis na het aanbrengen van uw wijzigingen de cache van Backdrop CMS en verifieer de installatie:

Ga naar Configuration > Performance in uw beheerpaneel
Klik op "Clear all caches"
Open uw website in een nieuw browsertabblad of incognitovenster
U zou de chatwidgetknop in de rechteronderhoek moeten zien
Klik erop om te controleren of deze correct opent en werkt

Ziet u de widget niet? Zorg ervoor dat u de cache van Backdrop CMS hebt gewist via Configuration > Performance. Probeer uw site te bekijken in een incognitovenster of wis uw browsercache. Open de browserconsole (F12) om te controleren op JavaScript-fouten. Als u de aangepaste module-methode hebt gebruikt, controleer dan of de module is ingeschakeld onder Functionality.