Hoe u de Asyntai AI-chatbot toevoegt aan Concrete CMS

Stapsgewijze handleiding voor Concrete CMS (voorheen Concrete5) 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: Code toevoegen aan de themafooter (aanbevolen)

De beste manier om de chatbot aan alle pagina's van uw Concrete CMS-website toe te voegen is door het footerbestand van uw thema te bewerken:

Ga naar uw Concrete CMS-installatie via FTP of Bestandsbeheer
Navigeer naar de map /application/themes/your_theme_name/
Zoek en open het bestand footer.php (of het equivalente footertemplate)
Zoek de regel met de afsluitende </body>-tag
Plak uw Asyntai-insluitcode net vóór de </body>-tag
Sla het bestand op en upload het terug naar uw server als u lokaal bewerkt
Wis de Concrete CMS-cache: Dashboard → System & Settings → Clear Cache

Tip: Het toevoegen van de code vóór de afsluitende </body>-tag zorgt ervoor dat de chatbot na uw 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: HTML-blok (eenvoudigst voor niet-ontwikkelaars)

Als u liever geen themabestanden bewerkt, kunt u het ingebouwde HTML-blok van Concrete CMS gebruiken:

Log in op uw Concrete CMS Dashboard
Navigeer naar de pagina waar u de chatbot wilt toevoegen
Klik op Edit Page (potloodpictogram in de werkbalk)
Klik op Add Block in het gebied waar u de code wilt plaatsen
Zoek en selecteer het HTML-blok
Plak uw Asyntai-insluitcode in de HTML-editor
Klik op Add om het blok op te slaan
Klik op Publish om de wijzigingen live te zetten

Opmerking: De HTML-blokmethode is uitstekend geschikt om de chatbot aan specifieke pagina's toe te voegen. Voor een sitewijde installatie moet u het HTML-blok aan elke pagina toevoegen, of de hierboven beschreven themafooter-methode gebruiken. De visuele plaatsing van het blok beïnvloedt niet waar de chatbot verschijnt - deze wordt nog steeds in de rechteronderhoek weergegeven.

Alternatieve methode 2: Thema-headerbestand

U kunt de code ook toevoegen aan het headerbestand van uw thema voor een sitewijde installatie:

Ga naar uw Concrete CMS-bestanden via FTP of Bestandsbeheer
Navigeer naar /application/themes/your_theme_name/
Open het bestand header.php (of elements/header.php)
Zoek de afsluitende </head>-tag
Plak uw Asyntai-insluitcode net vóór de </head>-tag
Sla het bestand op en upload het
Wis de cache vanuit het Dashboard

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

Tip: Zorg ervoor dat u de vereiste header-elementen opneemt met <?php View::element('header_required'); ?> in uw header.php-bestand zodat Concrete CMS correct functioneert.

Alternatieve methode 3: Aangepast template (geavanceerd)

Voor ontwikkelaars die meer controle willen, kunt u een aangepast paginatemplate maken:

Maak een nieuw paginatemplatebestand aan in /application/themes/your_theme_name/
Of kopieer een bestaand template (bijv. default.php) en hernoem het
Voeg uw Asyntai-insluitcode toe aan het templatebestand vóór </body>
Ga in het Concrete CMS Dashboard naar Pages & Themes
Klik op Page Types
Selecteer het paginatype waarmee u dit template wilt gebruiken
Wijs uw aangepaste template toe aan het paginatype
Alle pagina's die dit paginatype gebruiken, bevatten nu de chatbot

Belangrijk: Maak altijd een back-up van uw themabestanden voordat u wijzigingen aanbrengt. Test uw aanpassingen indien mogelijk eerst op een testsite. Onjuiste bewerkingen van themabestanden kunnen de lay-out of functionaliteit van uw site verstoren.

Stap 3: Installatie verifiëren

Open na het aanbrengen van uw wijzigingen en het wissen van de cache 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 functioneert.

Ziet u de widget niet? Zorg ervoor dat u de cache van Concrete CMS hebt gewist (Dashboard → System & Settings → Clear Cache). Probeer uw site te bekijken in een incognitovenster. Controleer of u alle bestandswijzigingen hebt opgeslagen en geüpload. Open de browserconsole (F12) om te controleren op JavaScript-fouten.