Hoe voegt u de Asyntai AI-chatbot toe aan OpenCart

Stapsgewijze handleiding voor OpenCart-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: Voettekst-template bewerken (aanbevolen)

De meest eenvoudige manier om de chatbot toe te voegen is door de voettekst-template van uw thema te bewerken:

Open uw OpenCart-bestanden via FTP of bestandsbeheer
Navigeer naar de voettekst-template van uw thema:
- OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
- OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
Open het voettekstbestand om te bewerken
Zoek de afsluitende </body>-tag
Plak uw Asyntai-insluitcode net vóór de </body>-tag
Sla het bestand op
Wis de OpenCart-cache: Dashboard → Blauw tandwielpictogram (rechtsboven) → Vernieuwen of verwijder de inhoud van system/storage/cache/

Tip: Als u het standaardthema gebruikt, is het pad catalog/view/theme/default/template/common/footer.twig. Maak altijd een back-up voordat u templatebestanden bewerkt.

Alternatief: De optie Aangepaste code van het thema gebruiken

Many modern OpenCart themes include a built-in option for custom code:

Log in op uw OpenCart-beheerpaneel
Ga naar Extensions → Themes (of Extensions → Extensions → Themes)
Klik op Edit bij uw actieve thema
Zoek naar een sectie "Custom Code", "Footer Scripts" of "Custom JavaScript"
Plak uw Asyntai-insluitcode
Klik op "Save"
Wis de cache

Opmerking: Niet alle thema's hebben deze optie. Als uw thema geen velden voor aangepaste code bevat, gebruik dan de template-bewerkingsmethode of installeer een extensie.

Alternatief: Een extensie voor aangepaste code gebruiken

U kunt een gratis extensie installeren vanuit de OpenCart Marketplace om aangepaste scripts toe te voegen:

Ga naar de OpenCart Marketplace
Zoek naar "Custom Script", "Header Footer Scripts" of "Custom Code"
Download en installeer een geschikte extensie
Ga in uw beheerpaneel naar Extensions → Extensions → Modules
Zoek en installeer de module voor aangepaste code
Configureer de module en plak uw Asyntai-insluitcode in de voettekstsectie
Sla op en wis de cache

Belangrijk: Het gebruik van extensies heeft de voorkeur boven het bewerken van kernbestanden, aangezien ze OpenCart-updates overleven. Populaire extensies zijn onder andere "Custom Script in Header & Footer" die beschikbaar is op de marketplace.

Alternatief: De addScript-methode gebruiken (voor ontwikkelaars)

Voor ontwikkelaars biedt OpenCart 3.x/4.x een programmatische manier om scripts toe te voegen:

Open catalog/controller/common/footer.php
Voeg de volgende regel toe vóór $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Voor het data-attribuut moet u de footer.twig handmatig aanpassen om het op te nemen, of inline JavaScript toevoegen na de scripts-lus

Opmerking: Om de widget correct te laten werken met het data-attribuut is de template-methode eenvoudiger, aangezien de addScript-methode geen aangepaste attributen rechtstreeks ondersteunt.

Stap 3: Installatie verifiëren

Na het opslaan van uw wijzigingen en het wissen van de cache, bezoek uw winkel 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 de OpenCart-cache wist. Ga naar uw beheerpaneel, klik op het blauwe tandwielpictogram in de rechterbovenhoek en klik op de vernieuwknoppen. Probeer ook uw browsercache te wissen of bekijk de site in een incognitovenster. Als u het verkeerde templatebestand hebt gewijzigd, controleer dan of uw thema het bestand gebruikt dat u hebt bewerkt.