Sådan tilføjer du Asyntai AI-chatbot til MODX

Trin-for-trin vejledning til MODX CMS-websteder

Platform:

Trin 1: Hent din indlejringskode

Gå først til dit Asyntai Dashboard og rul ned til sektionen "Indlejringskode". Kopiér din unikke indlejringskode, der vil se sådan ud:

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

Bemærk: Koden ovenfor er blot et eksempel. Du skal kopiere din egen unikke indlejringskode fra dit Dashboard, da den indeholder dit personlige widget-ID.

Trin 2: Tilføj til MODX-skabelon (anbefalet)

Den anbefalede måde at tilføje chatbotten på er ved at redigere din MODX-skabelon direkte i MODX Manager:

Log ind på din MODX Manager (adminpanel)
I venstre sidepanel skal du gå til Elements > Templates
Åbn dit websteds skabelon (normalt kaldet "BaseTemplate" eller din aktive skabelon)
Find det afsluttende </body>-tag i skabelonkoden
Indsæt din Asyntai-indlejringskode lige før det afsluttende </body>-tag
Klik på "Gem" for at gemme skabelonen

<!-- 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: Tilføjelse af koden lige før det afsluttende </body>-tag sikrer, at chatbotten indlæses efter alt sideindhold, hvilket er den anbefalede placering for chat-widgets og ikke vil bremse din sides indlæsning.

Alternativ metode 1: Brug af en MODX-chunk

Du kan bruge en MODX Chunk til at holde indlejringskoden separat og genbrugelig:

I MODX Manager skal du gå til Elementer > Chunks
Klik på "Ny chunk" for at oprette en ny chunk
Navngiv chunken "asyntaiWidget"
Indsæt din Asyntai-indlejringskode i chunkens indholdsområde
Klik på "Gem"
Åbn din skabelon (under Elementer > Skabeloner)
Tilføj chunk-kaldet [[$asyntaiWidget]] lige før det afsluttende </body>-tag
Gem skabelonen

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

Tip: Brug af en chunk gør det nemt at administrere og opdatere indlejringskoden ét sted, især hvis du bruger flere skabeloner på dit websted.

Alternativ metode 2: Brug af MODX-systemindstillinger (HTML head/footer)

Nogle MODX-opsætninger inkluderer pladsholdere til sidefodsskripter via Systemindstillinger:

I MODX Manager skal du gå til System > System Settings
Filtrer efter "htmlhead" eller søg efter en brugerdefineret systemindstilling til sidefodsskripter
Hvis din opsætning har en pladsholder til sidefodsskripter (såsom [[++footer_scripts]]), kan du bruge den
Angiv systemindstillingens værdi til din Asyntai-indlejringskode
Sørg for, at den tilsvarende pladsholder [[++footer_scripts]] er til stede i din skabelon før det afsluttende </body>-tag
Gem systemindstillingen

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

Bemærk: Denne metode afhænger af, at din MODX-opsætning har en brugerdefineret systemindstilling til sidefodsskripter. Hvis der ikke eksisterer en, kan du oprette en brugerdefineret systemindstilling og referere til den i din skabelon ved hjælp af [[++setting_key]]-syntaksen.

Alternativ metode 3: Brug af et MODX-plugin (OnWebPagePrerender)

For en avanceret tilgang kan du oprette et MODX-plugin, der automatisk injicerer chatbot-koden på hver side:

I MODX Manager skal du gå til Elementer > Plugins
Klik på "Nyt plugin" for at oprette et nyt plugin
Navngiv pluginnet "AsyntaiChatbot"
Indsæt følgende PHP-kode i plugin-kodeområ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);

Klik på fanen "Systemhændelser"
Markér afkrydsningsfeltet ud for "OnWebPagePrerender" for at aktivere dette plugin ved den pågældende hændelse
Klik på "Gem"

Vigtigt: Erstat YOUR_WIDGET_ID med dit faktiske widget-ID fra Asyntai Dashboard. Dette plugin vil automatisk injicere chatbot-skriptet på hver side på dit MODX-websted, før den bliver renderet.

Trin 3: Ryd cache og verificér

Efter at have tilføjet indlejringskoden ved hjælp af en af metoderne ovenfor skal du rydde MODX-cachen og verificere installationen:

I MODX Manager skal du gå til Administrer > Ryd cache (eller klikke på ikonet for at rydde cache i topmenuen)
Åbn dit websted i en ny browserfane eller et inkognitovindue
Du bør se chat-widget-knappen i nederste højre hjørne af din side
Klik på den for at sikre, at den åbner og fungerer korrekt

Ser du ikke widget'en? Sørg for, at du har ryddet MODX-cachen fra Administrer > Ryd cache i MODX Manager. Prøv også at rydde din browsercache eller se webstedet i et inkognitovindue. Hvis du brugte Plugin-metoden, skal du verificere, at systemhændelsen "OnWebPagePrerender" er markeret for dit plugin.