Hoe voegt u de Asyntai AI-chatbot toe aan MODX

Stapsgewijze handleiding voor MODX 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 MODX-template (aanbevolen)

De aanbevolen manier om de chatbot toe te voegen is door uw MODX-template rechtstreeks in de MODX Manager te bewerken:

Log in op uw MODX Manager (beheerpaneel)
Ga in de linkerzijbalk naar Elements > Templates
Open de template van uw site (meestal "BaseTemplate" genoemd of uw actieve template)
Zoek de afsluitende </body>-tag in de templatecode
Plak uw Asyntai-insluitcode net voor de afsluitende </body>-tag
Klik op "Save" om de template op te slaan

<!-- Your existing template content -->

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

Tip: Het toevoegen van de code net voor de afsluitende </body>-tag zorgt ervoor dat de chatbot wordt geladen na alle pagina-inhoud. Dit is de aanbevolen plaatsing voor chatwidgets en vertraagt het laden van uw pagina niet.

Alternatieve methode 1: Een MODX-chunk gebruiken

U kunt een MODX Chunk gebruiken om de insluitcode apart en herbruikbaar te houden:

Ga in de MODX Manager naar Elements > Chunks
Klik op "Nieuw Chunk" om een nieuw chunk aan te maken
Noem de chunk "asyntaiWidget"
Plak uw Asyntai-insluitcode in het inhoudsveld van de chunk
Klik op "Save"
Open uw template (onder Elements > Templates)
Voeg de chunk-aanroep [[$asyntaiWidget]] toe net voor de afsluitende </body>-tag
Sla het sjabloon op

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

Tip: Het gebruik van een chunk maakt het eenvoudig om de insluitcode op één plek te beheren en bij te werken, vooral als u meerdere templates op uw site gebruikt.

Alternatieve methode 2: MODX-systeeminstellingen gebruiken (HTML Head/Footer)

Sommige MODX-installaties bevatten tijdelijke aanduidingen voor footerscripts via systeeminstellingen:

Ga in de MODX Manager naar Systeem > Systeeminstellingen
Filter op "htmlhead" of zoek naar een aangepaste systeeminstelling voor footerscripts
Als uw installatie een tijdelijke aanduiding heeft voor footerscripts (zoals [[++footer_scripts]]), kunt u deze gebruiken
Stel de waarde van de systeeminstelling in op uw Asyntai-insluitcode
Zorg ervoor dat de bijbehorende tijdelijke aanduiding [[++footer_scripts]] aanwezig is in uw template voor de afsluitende </body>-tag
Sla de systeeminstelling op

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Opmerking: Deze methode is afhankelijk van het feit dat uw MODX-installatie een aangepaste systeeminstelling heeft voor footerscripts. Als er geen bestaat, kunt u een aangepaste systeeminstelling maken en ernaar verwijzen in uw template met de [[++setting_key]]-syntaxis.

Alternatieve methode 3: Een MODX-plugin gebruiken (OnWebPagePrerender)

Voor een geavanceerde aanpak kunt u een MODX-plugin maken die de chatbotcode automatisch op elke pagina injecteert:

Ga in de MODX Manager naar Elements > Plugins
Klik op "Nieuwe Plugin" om een nieuwe plugin aan te maken
Noem de plugin "AsyntaiChatbot"
Plak de volgende PHP-code in het codeveld van de plugin:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

Klik op het tabblad "System Events"
Vink het vakje aan naast "OnWebPagePrerender" om deze plugin bij dat evenement te activeren
Klik op "Save"

Belangrijk: Vervang YOUR_WIDGET_ID door uw daadwerkelijke widget-ID uit het Asyntai Dashboard. Deze plugin injecteert automatisch het chatbotscript op elke pagina van uw MODX-site voordat deze wordt weergegeven.

Stap 3: Cache wissen en verifiëren

Na het toevoegen van de insluitcode met een van de bovenstaande methoden, moet u de MODX-cache wissen en de installatie verifiëren:

Ga in de MODX Manager naar Manage > Clear Cache (of klik op het pictogram cache wissen in het bovenste menu)
Open uw website in een nieuw browsertabblad of incognitovenster
U zou de chatwidgetknop rechtsonder in de hoek van uw pagina moeten zien
Klik erop om te controleren of deze correct opent en werkt

Ziet u de widget niet? Zorg ervoor dat u de MODX-cache hebt gewist via Manage > Clear Cache in de MODX Manager. Probeer ook uw browsercache te wissen of bekijk de site in een incognitovenster. Als u de pluginmethode hebt gebruikt, controleer dan of het systeemevenement "OnWebPagePrerender" is aangevinkt voor uw plugin.