Hoe voegt u de Asyntai AI-chatbot toe aan October CMS

Stapsgewijze handleiding voor October 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 layouttemplate (aanbevolen)

De aanbevolen manier om de chatbot toe te voegen is door uw standaardlayout te bewerken in de October CMS-backend:

Log in op uw October CMS-backend
Ga naar CMS > Layouts in het hoofdmenu
Open uw standaardlayout (meestal default.htm)
Zoek de afsluitende </body> tag en de {% scripts %} tijdelijke aanduiding
Voeg uw Asyntai-insluitcode toe net voor {% scripts %} en </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Klik op "Save" om uw wijzigingen toe te passen

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

U kunt de scripts-tijdelijke aanduiding van October CMS gebruiken om de chatbot vanuit een pagina of partial te injecteren:

Open een willekeurige pagina of partial in de CMS-editor
Voeg de volgende code toe met behulp van de {% put scripts %} blok:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
Vervang YOUR_WIDGET_ID door uw daadwerkelijke widget-ID uit het dashboard
Klik op "Save"

Opmerking: 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.

Alternatieve methode 2: Component-PHP gebruiken

Als u de voorkeur geeft aan een programmatische aanpak, kunt u het chatbotscript toevoegen via een aangepast component:

Maak een component aan of wijzig het in uw October CMS-plugin
Gebruik in de onRun()-methode van het component de addJs()-methode:
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
Vervang YOUR_WIDGET_ID door uw werkelijke widget-ID
Registreer het component op de pagina's waar u de chatbot wilt laten verschijnen

Tip: Het gebruik van een component geeft u programmatische controle over wanneer en waar de chatbot wordt geladen. U kunt voorwaardelijke logica toevoegen binnen onRun() om het laden te regelen op basis van gebruikersrollen, paginatypes of andere criteria.

Alternatieve methode 3: Een partial gebruiken

U kunt een herbruikbare partial aanmaken voor de chatbot-widget:

Ga naar CMS > Partials in de October CMS-backend
Klik op "+ Add" om een nieuwe partial aan te maken
Noem het asyntai-widget.htm
Voeg uw Asyntai-insluitcode toe aan de partial:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Klik op "Save"
Open uw layout-template en voeg de partial toe vóór </body>:
{% partial 'asyntai-widget' %}
Sla de layout op

Tip: Het gebruik van een partial maakt het eenvoudig om de chatbot op uw gehele site in of uit te schakelen door simpelweg de partial-include toe te voegen aan of te verwijderen uit uw layout.

Stap 3: Installatie verifiëren

Na het opslaan van uw wijzigingen, bezoek uw October CMS-website in een nieuw browsertabblad of incognitovenster. U zou de chatwidget-knop 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 alle wijzigingen in de CMS-backend hebt opgeslagen. Wis uw browsercache of bekijk de site in een incognitovenster. Als uw site caching gebruikt, wis dan de October CMS-cache door php artisan cache:clear uit te voeren vanaf de opdrachtregel, of gebruik de optie Settings > System > Clear Cache in de backend.

Layoutselectie: Zorg ervoor dat de pagina's waar u de chatbot wilt laten verschijnen de juiste layout gebruiken. U kunt controleren welke layout een pagina gebruikt door de pagina te openen in CMS > Pages en te kijken naar het Layout-dropdown in de pagina-instellingen.