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

Steg-för-steg-guide för October 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 layoutmallen (rekommenderas)

Det rekommenderade sättet att lägga till chattboten är att redigera din standardlayout i October CMS-backend:

Logga in på din October CMS-backend
Gå till CMS > Layouter i huvudmenyn
Öppna din standardlayout (vanligtvis default.htm)
Hitta den avslutande </body> tagg och {% scripts %} platshållare
Lägg till din Asyntai-inbäddningskod precis före {% scripts %} och </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Klicka på "Save" för att tillämpa dina ändringar

Tips: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

Du kan använda October CMS scripts-platshållaren för att injicera chatboten från en sida eller partial:

Öppna valfri sida eller partial i CMS-redigeraren
Lägg till följande kod med hjälp av {% put scripts %} block:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
Ersätt YOUR_WIDGET_ID med ditt faktiska widget-ID från instrumentpanelen
Klicka på "Spara"

Obs! For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

Alternativ metod 2: Använda komponent-PHP

Om du föredrar ett programmatiskt tillvägagångssätt kan du lägga till chattbot-skriptet via en anpassad komponent:

Skapa eller modifiera en komponent i ditt October CMS-plugin
I komponentens onRun()-metod, använd metoden addJs():
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
Ersätt YOUR_WIDGET_ID med ditt faktiska widget-ID
Registrera komponenten på de sidor där du vill att chattboten ska visas

Tips: Att använda en komponent ger dig programmatisk kontroll över när och var chatboten laddas. Du kan lägga till villkorslogik inuti onRun() för att styra laddning baserat på användarroller, sidtyper eller andra kriterier.

Alternativ metod 3: Använda en partial

Du kan skapa en återanvändbar partial för chattwidgeten:

Gå till CMS > Partialer i October CMS-backend
Klicka på "+ Add" för att skapa en ny partial
Namnge den asyntai-widget.htm
Lägg till din Asyntai-inbäddningskod i partial-filen:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Klicka på "Spara"
Öppna din layoutmall och inkludera partialen före </body>:
{% partial 'asyntai-widget' %}
Spara layouten

Tips: Att använda en partial gör det enkelt att aktivera eller inaktivera chatboten på hela din webbplats genom att helt enkelt lägga till eller ta bort partial-inkluderingen från din layout.

Steg 3: Verifiera installationen

Efter att du har sparat dina ändringar, besök din October CMS-webbplats i en ny webbläsarflik eller ett inkognitofönster. Du bör se widgetknappen för chatten 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 sparat alla ändringar i CMS-backend. Rensa webbläsarens cache eller visa sidan i ett inkognitofönster. Om din webbplats använder caching, rensa October CMS-cachen genom att köra php artisan cache:clear från kommandoraden, eller använd alternativet Settings > System > Clear Cache i backend.

Layoutval: Se till att sidorna där du vill att chattboten ska visas använder rätt layout. Du kan kontrollera vilken layout en sida använder genom att öppna sidan i CMS > Sidor och titta på rullgardinsmenyn Layout i sidinställningarna.