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

Trin-for-trin vejledning til October CMS-websteder

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 layoutskabelon (anbefalet)

Den anbefalede måde at tilføje chatbotten på er ved at redigere dit standardlayout i October CMS-backend:

Log ind på din October CMS-backend
Gå til CMS > Layouts i hovedmenuen
Åbn dit standardlayout (normalt default.htm)
Find det afsluttende </body> tag og {% scripts %} pladsholder
Tilføj din Asyntai-indlejringskode lige før {% scripts %} og </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Klik på "Gem" for at anvende dine ændringer

Tip: 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 bruge October CMS's skript-pladsholder til at injicere chatbotten fra en side eller en partial:

Åbn en hvilken som helst side eller partial i CMS-editoren
Tilføj følgende kode ved hjælp af {% put scripts %} blok:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
Erstat YOUR_WIDGET_ID med dit faktiske widget-ID fra dashboardet
Klik på "Gem"

Bemærk: 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 metode 2: Brug af komponent-PHP

Hvis du foretrækker en programmatisk tilgang, kan du tilføje chatbot-skriptet via en brugerdefineret komponent:

Opret eller modificer en komponent i dit October CMS-plugin
I komponentens onRun()-metode skal du bruge addJs()-metoden:
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
Erstat YOUR_WIDGET_ID med dit faktiske widget-ID
Registrer komponenten på de sider, hvor du ønsker, at chatbotten skal vises

Tip: Brug af en komponent giver dig programmatisk kontrol over, hvornår og hvor chatbotten indlæses. Du kan tilføje betinget logik inde i onRun() for at styre indlæsning baseret på brugerroller, sidetyper eller andre kriterier.

Alternativ metode 3: Brug af en partial

Du kan oprette en genanvendelig partial til chatbot-widget'en:

Gå til CMS > Partials i October CMS-backend
Klik på "+ Tilføj" for at oprette en ny partial
Navngiv den asyntai-widget.htm
Tilføj din Asyntai-indlejringskode til partialen:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Klik på "Gem"
Åbn din layoutskabelon og inkluder partialen før </body>:
{% partial 'asyntai-widget' %}
Gem layoutet

Tip: Brug af en partial gør det nemt at aktivere eller deaktivere chatbotten på hele dit websted ved blot at tilføje eller fjerne partial-inkluderingen fra dit layout.

Trin 3: Verificér installationen

Efter at have gemt dine ændringer skal du besøge dit October CMS-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 du har gemt alle ændringer i CMS-backend. Ryd din browsercache eller se siden i et inkognitovindue. Hvis dit websted bruger caching, skal du rydde October CMS-cachen ved at køre php artisan cache:clear fra kommandolinjen eller bruge indstillingen Indstillinger > System > Ryd cache i backend.

Layoutvalg: Sørg for, at de sider, hvor du ønsker, at chatbotten skal vises, bruger det korrekte layout. Du kan kontrollere, hvilket layout en side bruger, ved at åbne siden i CMS > Sider og se på Layout-rullemenuen i sideindstillingerne.