Asyntai AI -chatbotin lisääminen MODX:ään

Vaiheittainen ohje MODX CMS -verkkosivustoille

Alusta:

Vaihe 1: Hanki upotuskoodisi

Siirry ensin Asyntai-hallintapaneeliin ja vieritä alas "Upotuskoodi"-osioon. Kopioi yksilöllinen upotuskoodisi, joka näyttää tältä:

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

Huomautus: Yllä oleva koodi on vain esimerkki. Sinun on kopioitava oma yksilöllinen upotuskoodisi Hallintapaneelistasi, sillä se sisältää henkilökohtaisen widget-tunnuksesi.

Vaihe 2: Lisää MODX-malliin (suositeltu)

Suositeltu tapa lisätä chatbot on muokata MODX-mallia suoraan MODX Managerissa:

Kirjaudu sisään MODX Manageriin (hallintapaneeli)
Siirry vasemmassa sivupalkissa kohtaan Elements > Templates
Avaa sivustosi malli (yleensä nimeltään "BaseTemplate" tai aktiivinen mallisi)
Etsi sulkeva </body>-tagi mallikoodista
Liitä Asyntai-upotuskoodisi juuri ennen sulkevaa </body>-tagia
Napsauta "Save" tallentaaksesi mallin

<!-- Your existing template content -->

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

Vinkki: Koodin lisääminen juuri ennen sulkevaa </body>-tagia varmistaa, että chatbot latautuu kaiken sivun sisällön jälkeen, mikä on suositeltu sijoitus chat-widgeteille eikä hidasta sivun latautumista.

Vaihtoehtoinen menetelmä 1: MODX Chunkin käyttö

Voit käyttää MODX Chunk -elementtiä pitääksesi upotuskoodin erillään ja uudelleenkäytettävänä:

Siirry MODX Managerissa kohtaan Elements > Chunks
Napsauta "New Chunk" luodaksesi uuden chunkin
Nimeä chunk nimellä "asyntaiWidget"
Liitä Asyntai-upotuskoodisi chunkin sisältöalueelle
Napsauta "Save"
Avaa mallisi (kohdassa Elements > Templates)
Lisää chunk-kutsu [[$asyntaiWidget]] juuri ennen sulkevaa </body>-tagia
Tallenna malli

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

Vinkki: Chunkin käyttö helpottaa upotuskoodin hallintaa ja päivittämistä yhdestä paikasta, erityisesti jos käytät useita malleja sivustollasi.

Vaihtoehtoinen menetelmä 2: MODX-järjestelmäasetusten käyttö (HTML Head/Footer)

Joissakin MODX-asennuksissa on paikkamerkit alatunnisteskripteille järjestelmäasetuksissa:

Siirry MODX Managerissa kohtaan System > System Settings
Suodata hakusanalla "htmlhead" tai etsi mukautettua järjestelmäasetusta alatunnisteskripteille
Jos asennuksessasi on paikkamerkki alatunnisteskripteille (kuten [[++footer_scripts]]), voit käyttää sitä
Aseta järjestelmäasetuksen arvoksi Asyntai-upotuskoodisi
Varmista, että vastaava paikkamerkki [[++footer_scripts]] on mallissasi ennen sulkevaa </body>-tagia
Tallenna järjestelmäasetus

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

Huomautus: Tämä menetelmä edellyttää, että MODX-asennuksessasi on mukautettu järjestelmäasetus alatunnisteskripteille. Jos sellaista ei ole, voit luoda mukautetun järjestelmäasetuksen ja viitata siihen mallissasi käyttämällä [[++setting_key]]-syntaksia.

Vaihtoehtoinen menetelmä 3: MODX-lisäosan käyttö (OnWebPagePrerender)

Edistyneempänä lähestymistapana voit luoda MODX-lisäosan, joka lisää chatbot-koodin automaattisesti jokaiselle sivulle:

Siirry MODX Managerissa kohtaan Elements > Plugins
Napsauta "New Plugin" luodaksesi uuden lisäosan
Nimeä lisäosa nimellä "AsyntaiChatbot"
Liitä seuraava PHP-koodi lisäosan koodialueelle:

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

Napsauta "System Events" -välilehteä
Valitse "OnWebPagePrerender" -valintaruutu, jotta lisäosa suoritetaan kyseisessä tapahtumassa
Napsauta "Save"

Tärkeää: Korvaa YOUR_WIDGET_ID todellisella widget-tunnuksellasi Asyntai Dashboard -hallintapaneelista. Tämä lisäosa lisää chatbot-skriptin automaattisesti jokaiselle MODX-sivustosi sivulle ennen sen renderöintiä.

Vaihe 3: Tyhjennä välimuisti ja vahvista

Kun olet lisännyt upotuskoodin jollakin yllä olevista menetelmistä, sinun tulee tyhjentää MODX-välimuisti ja vahvistaa asennus:

Siirry MODX Managerissa kohtaan Manage > Clear Cache (tai napsauta välimuistin tyhjennys -kuvaketta ylävalikossa)
Avaa verkkosivustosi uudessa selaimen välilehdessä tai incognito-ikkunassa
Chat-widgetin painikkeen pitäisi näkyä sivusi oikeassa alakulmassa
Napsauta sitä varmistaaksesi, että se avautuu ja toimii oikein

Etkö näe widgetiä? Varmista, että olet tyhjentänyt MODX-välimuistin kohdasta Manage > Clear Cache MODX Managerissa. Kokeile myös tyhjentää selaimen välimuisti tai katsoa sivustoa incognito-ikkunassa. Jos käytit lisäosamenetelmää, varmista, että \"OnWebPagePrerender\"-järjestelmätapahtuma on valittuna lisäosallesi.