Hur du lägger till Asyntai AI-chattbot i MODX

Steg-för-steg-guide för MODX CMS-webbplatser

Plattform:

Steg 1: Hämta din inbäddningskod

Gå först till din Asyntai-instrumentpanel och scrolla ner till avsnittet "Inbäddningskod". Kopiera din unika inbäddningskod som ser ut så här:

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

Obs! Koden ovan är bara ett exempel. Du måste kopiera din egen unika inbäddningskod från din Dashboard eftersom den innehåller ditt personliga widget-ID.

Steg 2: Lägg till i MODX-mallen (rekommenderas)

Det rekommenderade sättet att lägga till chattboten är att redigera din MODX-mall direkt i MODX Manager:

Logga in på din MODX Manager (adminpanel)
I det vänstra sidofältet, gå till Element > Mallar
Öppna din webbplats mall (vanligtvis kallad "BaseTemplate" eller din aktiva mall)
Hitta den avslutande taggen </body> i mallkoden
Klistra in din Asyntai-inbäddningskod precis före den avslutande taggen </body>
Klicka på "Save" för att spara mallen

<!-- Your existing template content -->

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

Tips: Att lägga till koden precis före det avslutande </body>-taggen säkerställer att chattboten laddas efter allt sidinnehåll, vilket är den rekommenderade placeringen för chattwidgetar och inte bromsar sidladdningen.

Alternativ metod 1: Använda ett MODX-chunk

Du kan använda en MODX Chunk för att hålla inbäddningskoden separat och återanvändbar:

I MODX Manager, gå till Element > Bitar
Klicka på "New Chunk" för att skapa en ny chunk
Namnge chunken "asyntaiWidget"
Klistra in din Asyntai-inbäddningskod i chunk-innehållsområdet
Klicka på "Spara"
Öppna din mall (under Element > Mallar)
Lägg till chunk-anropet [[$asyntaiWidget]] precis före det avslutande </body>-taggen
Spara mallen

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

Tips: Att använda en Chunk gör det enkelt att hantera och uppdatera inbäddningskoden på ett ställe, särskilt om du använder flera mallar på din webbplats.

Alternativ metod 2: Använda MODX systeminställningar (HTML-sidhuvud/-sidfot)

Vissa MODX-konfigurationer inkluderar platshållare för sidfotsskript via systeminställningar:

I MODX Manager, gå till System > Systeminställningar
Filtrera efter \"htmlhead\" eller sök efter en anpassad systeminställning för sidfotsskript
Om din konfiguration har en platshållare för sidfotsskript (t.ex. [[++footer_scripts]]) kan du använda den
Ange systemets inställningsvärde till din Asyntai-inbäddningskod
Se till att motsvarande platshållare [[++footer_scripts]] finns i din mall före den avslutande </body>-taggen
Spara systeminställningen

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

Obs! Den här metoden kräver att din MODX-konfiguration har en anpassad systeminställning för sidfotsskript. Om en sådan inte finns kan du skapa en anpassad systeminställning och referera till den i din mall med syntaxen [[++setting_key]].

Alternativ metod 3: Använda ett MODX-plugin (OnWebPagePrerender)

För ett avancerat tillvägagångssätt kan du skapa ett MODX-plugin som automatiskt injicerar chattbotkoden på varje sida:

I MODX Manager, gå till Element > Plugin-program
Klicka på "New Plugin" för att skapa ett nytt tillägg
Namnge tillägget "AsyntaiChatbot"
Klistra in följande PHP-kod i plugin-kodområdet:

$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);

Klicka på fliken "System Events"
Markera rutan bredvid \"OnWebPagePrerender\" för att aktivera detta plugin vid den händelsen
Klicka på "Spara"

Viktigt: Ersätt YOUR_WIDGET_ID med ditt faktiska widget-ID från Asyntai-instrumentpanelen. Detta tillägg injicerar automatiskt chattbotens skript på varje sida på din MODX-webbplats innan den renderas.

Steg 3: Rensa cache och verifiera

Efter att du har lagt till inbäddningskoden med någon av metoderna ovan måste du rensa MODX-cachen och verifiera installationen:

I MODX Manager, gå till Hantera > Rensa cache (eller klicka på ikonen för att rensa cache i toppmenyn)
Öppna din webbplats i en ny webbläsarflik eller ett inkognitofönster
Du bör se chattwidgetknappen i det nedre högra hörnet av din sida
Klicka på den för att kontrollera att den öppnas och fungerar korrekt

Ser du inte widgeten? Se till att du rensat MODX-cachen från Manage > Clear Cache i MODX Manager. Försök även rensa webbläsarens cache eller visa webbplatsen i ett inkognitofönster. Om du använde tilläggsmetoden, kontrollera att systemhändelsen "OnWebPagePrerender" är markerad för ditt tillägg.