Slik legger du til Asyntai AI-chatbot i MODX

Trinn-for-trinn-guide for MODX CMS-nettsteder

Plattform:

Trinn 1: Hent innbyggingskoden din

Gå først til Asyntai-dashbordet ditt og bla ned til «Innbyggingskode»-seksjonen. Kopier din unike innbyggingskode som vil se slik ut:

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

Merk: Koden ovenfor er bare et eksempel. Du må kopiere din egen unike innbyggingskode fra Dashbordet ditt, da den inneholder din personlige widget-ID.

Trinn 2: Legg til i MODX-mal (anbefalt)

Den anbefalte måten å legge til chatboten på er å redigere MODX-malen din direkte i MODX Manager:

Logg inn på MODX Manager (adminpanelet)
I venstre sidefelt, gå til Elements > Templates
Åpne nettstedets mal (vanligvis kalt «BaseTemplate» eller din aktive mal)
Finn den avsluttende </body>-taggen i malkoden
Lim inn Asyntai-innbyggingskoden din rett før den avsluttende </body>-taggen
Klikk på «Save» for å lagre malen

<!-- 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: Å legge til koden rett før den avsluttende </body>-taggen sikrer at chatboten lastes inn etter alt sideinnhold, noe som er den anbefalte plasseringen for chat-widgeter og ikke vil bremse sideinnlastingen.

Alternativ metode 1: Bruk av en MODX Chunk

Du kan bruke en MODX Chunk for å holde innbyggingskoden separat og gjenbrukbar:

I MODX Manager, gå til Elements > Chunks
Klikk på «New Chunk» for å opprette en ny chunk
Gi chunken navnet «asyntaiWidget»
Lim inn Asyntai-innbyggingskoden din i chunkens innholdsområde
Klikk på «Lagre»
Åpne malen din (under Elements > Templates)
Legg til chunk-kallet [[$asyntaiWidget]] rett før den avsluttende </body>-taggen
Lagre malen

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

Tips: Å bruke en Chunk gjør det enkelt å administrere og oppdatere innbyggingskoden på ett sted, spesielt hvis du bruker flere maler på nettstedet ditt.

Alternativ metode 2: Bruk av MODX-systeminnstillinger (HTML Head/Footer)

Noen MODX-oppsett inkluderer plassholdere for bunntekstskript via systeminnstillinger:

I MODX Manager, gå til System > System Settings
Filtrer etter «htmlhead» eller søk etter en egendefinert systeminnstilling for bunntekstskript
Hvis oppsettet ditt har en plassholder for bunntekstskript (som [[++footer_scripts]]), kan du bruke den
Sett systeminnstillingsverdien til Asyntai-innbyggingskoden din
Sørg for at den tilhørende plassholderen [[++footer_scripts]] er til stede i malen din før den avsluttende </body>-taggen
Lagre systeminnstillingen

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

Merk: Denne metoden avhenger av at MODX-oppsettet ditt har en egendefinert systeminnstilling for bunntekstskript. Hvis den ikke finnes, kan du opprette en egendefinert systeminnstilling og referere til den i malen din ved hjelp av [[++setting_key]]-syntaksen.

Alternativ metode 3: Bruk av en MODX-plugin (OnWebPagePrerender)

For en avansert tilnærming kan du opprette en MODX-plugin som automatisk injiserer chatbot-koden på hver side:

I MODX Manager, gå til Elements > Plugins
Klikk på «New Plugin» for å opprette en ny utvidelse
Gi utvidelsen navnet «AsyntaiChatbot»
Lim inn følgende PHP-kode i pluginens kodeområde:

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

Klikk på fanen «System Events»
Kryss av boksen ved siden av «OnWebPagePrerender» for å utløse denne utvidelsen ved den hendelsen
Klikk på «Lagre»

Viktig: Erstatt YOUR_WIDGET_ID med din faktiske widget-ID fra Asyntai-dashbordet. Denne utvidelsen vil automatisk injisere chatbot-skriptet på hver side på MODX-nettstedet ditt før den gjengis.

Trinn 3: Tøm hurtigbuffer og bekreft

Etter at du har lagt til innbyggingskoden med en av metodene ovenfor, må du tømme MODX-hurtigbufferen og verifisere installasjonen:

I MODX Manager, gå til Manage > Clear Cache (eller klikk på tøm hurtigbuffer-ikonet i toppmenyen)
Åpne nettstedet ditt i en ny nettleserfane eller et inkognitovindu
Du bør se chat-widget-knappen i nedre høyre hjørne av siden din
Klikk på den for å forsikre deg om at den åpnes og fungerer riktig

Ser du ikke widgeten? Sørg for at du har tømt MODX-hurtigbufferen fra Manage > Clear Cache i MODX Manager. Prøv også å tømme nettleserens hurtigbuffer eller vis nettstedet i et inkognitovindu. Hvis du brukte utvidelsesmetoden, kontroller at systemhendelsen «OnWebPagePrerender» er avkrysset for utvidelsen din.