Kako dodati klepetalnik Asyntai z UI v MODX

Vodič po korakih za spletne strani MODX CMS

Platforma:

Korak 1: Pridobite svojo vdelovalno kodo

Najprej pojdite na svojo Nadzorno ploščo Asyntai in se pomaknite navzdol do razdelka "Vdelovalna koda". Kopirajte svojo edinstveno vdelovalno kodo, ki bo videti takole:

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

Opomba: Zgornja koda je le primer. Svojo edinstveno vdelovalno kodo morate kopirati iz svoje Nadzorne plošče, saj vsebuje vaš osebni ID klepetalnika.

Korak 2: Dodajanje v predlogo MODX (priporočeno)

Priporoceni način dodajanja klepetalnika je urejanje predloge MODX neposredno v upravitelju MODX:

Prijavite se v svoj upravitelj MODX (skrbniški panel)
V levi stranski vrstici pojdite na Elementi > Predloge
Odprite predlogo svojega spletnega mesta (običajno se imenuje "BaseTemplate" ali vaša aktivna predloga)
Poišcite zaključno oznako </body> v kodi predloge
Prilepite svojo vdelano kodo Asyntai tik pred zaključno oznako </body>
Kliknite "Shrani" za shranitev predloge

<!-- Your existing template content -->

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

Nasvet: Dodajanje kode tik pred zaključno oznako </body> zagotavlja, da se klepetalnik naloži po vsej vsebini strani, kar je priporočena umestitev za pripomocke za klepet in ne bo upočasnilo nalaganja vaše strani.

Alternativni način 1: Uporaba dela MODX (Chunk)

Uporabite lahko MODX Chunk, da ohranite vdelano kodo ločeno in ponovno uporabno:

V upravitelju MODX pojdite na Elementi > Deli (Chunks)
Kliknite "Nov del" za ustvarjanje novega dela
Poimenujte del "asyntaiWidget"
Prilepite svojo vdelano kodo Asyntai v podrocje vsebine dela
Kliknite "Shrani"
Odprite svojo predlogo (pod Elementi > Predloge)
Dodajte klic dela [[$asyntaiWidget]] tik pred zaključno oznako </body>
Shranite predlogo

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

Nasvet: Uporaba dela olajša upravljanje in posodabljanje vdelane kode na enem mestu, še posebej če uporabljate več predlog na svojem spletnem mestu.

Alternativni način 2: Uporaba sistemskih nastavitev MODX (HTML glava/noga)

Nekatere nastavitve MODX vkljucujejo ograde za skripte v nogi strani prek sistemskih nastavitev:

V upravitelju MODX pojdite na Sistem > Sistemske nastavitve
Filtrirajte po "htmlhead" ali poiščite sistemsko nastavitev po meri za skripte v nogi strani
Če ima vaša nastavitev ogrado za skripte v nogi strani (kot je [[++footer_scripts]]), jo lahko uporabite
Nastavite vrednost sistemske nastavitve na svojo vdelano kodo Asyntai
Prepričajte se, da je ustrezna ograda [[++footer_scripts]] prisotna v vaši predlogi pred zaključno oznako </body>
Shranite sistemsko nastavitev

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

Opomba: Ta način je odvisen od tega, ali ima vaša nastavitev MODX sistemsko nastavitev po meri za skripte v nogi strani. Če ne obstaja, jo lahko ustvarite in se nanjo sklicujete v svoji predlogi z uporabo skladnje [[++setting_key]].

Alternativni način 3: Uporaba vtičnika MODX (OnWebPagePrerender)

Za napreden pristop lahko ustvarite vtičnik MODX, ki samodejno vstavi kodo klepetalnika na vsako stran:

V upravitelju MODX pojdite na Elementi > Vtičniki
Kliknite "Nov vtičnik" za ustvarjanje novega vtičnika
Poimenujte vtičnik "AsyntaiChatbot"
Prilepite naslednjo kodo PHP v področje kode vtičnika:

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

Kliknite zavihek "Sistemski dogodki"
Označite potrditveno polje poleg "OnWebPagePrerender", da se vtičnik sproži ob tem dogodku
Kliknite "Shrani"

Pomembno: Zamenjajte YOUR_WIDGET_ID s svojim dejanskim ID-jem pripomočka iz nadzorne plošče Asyntai. Ta vtičnik bo samodejno vstavil skripto klepetalnika na vsako stran vašega spletnega mesta MODX, preden se upodobi.

Korak 3: Počistite predpomnilnik in preverite

Po dodajanju vdelane kode z uporabo katerega koli od zgornjih načinov morate počistiti predpomnilnik MODX in preveriti namestitev:

V upravitelju MODX pojdite na Upravljanje > Počisti predpomnilnik (ali kliknite ikono za čiščenje predpomnilnika v zgornjem meniju)
Odprite svoje spletno mesto v novem zavihku brskalnika ali oknu brez beleženja
V spodnjem desnem kotu strani bi morali videti gumb pripomočka za klepet
Kliknite nanj, da se prepričajte, da se odpre in pravilno deluje

Ne vidite klepetalnika? Prepričajte se, da ste počistili predpomnilnik MODX prek Upravljanje > Počisti predpomnilnik v upravitelju MODX. Poskusite tudi počistiti predpomnilnik brskalnika ali si spletno mesto ogledati v oknu brez beleženja. Če ste uporabili način z vtičnikom, preverite, da je sistemski dogodek "OnWebPagePrerender" označen za vaš vtičnik.