Kaip pridėti Asyntai DI pokalbių robotą prie MODX

Žingsnis po žingsnio vadovas MODX CMS svetainėms

Platforma:

1 žingsnis: Gaukite savo įterpimo kodą

Pirma, eikite į savo Asyntai valdymo skydelį ir slinkite žemyn iki "Įterpimo kodas" skyriaus. Nukopijuokite savo unikalų įterpimo kodą, kuris atrodys taip:

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

Pastaba: Aukščiau pateiktas kodas yra tik pavyzdys. Turite nukopijuoti savo unikalų įterpimo kodą iš savo Valdymo skydelio, nes jame yra jūsų asmeninis valdiklio ID.

2 žingsnis: Pridėjimas prie MODX šablono (Rekomenduojama)

Rekomenduojamas būdas pridėti pokalbių robotą yra redaguoti MODX šabloną tiesiogiai MODX Manager aplinkoje:

Prisijunkite prie savo MODX Manager (valdymo skydelio)
Kairėje šoninėje juostoje eikite į Elements > Templates
Atidarykite savo svetainės šabloną (paprastai vadinamą "BaseTemplate" arba jūsų aktyvų šabloną)
Raskite uždaromąjį </body> žymą šablono kode
Įklijuokite savo Asyntai įterpimo kodą prieš pat uždaromąjį </body> žymą
Spustelėkite "Išsaugoti", kad išsaugotumėte šabloną

<!-- Your existing template content -->

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

Patarimas: Kodo pridėjimas prieš pat uždaromąjį </body> žymą užtikrina, kad pokalbių robotas įkeliamas po viso puslapio turinio, kas yra rekomenduojama pokalbių valdiklių vieta ir nesulėtins jūsų puslapio įkėlimo.

Alternatyvus metodas 1: MODX Chunk naudojimas

Galite naudoti MODX Chunk, kad įterpimo kodas būtų atskiras ir pakartotinai naudojamas:

MODX Manager aplinkoje eikite į Elements > Chunks
Spustelėkite "New Chunk", kad sukurtumėte naują fragmentą
Pavadinkite chunk "asyntaiWidget"
Įklijuokite savo Asyntai įterpimo kodą į chunk turinio sritį
Spustelėkite "Išsaugoti"
Atidarykite savo šabloną (skiltyje Elements > Templates)
Pridėkite chunk iškvietimą [[$asyntaiWidget]] prieš pat uždaromąjį </body> žymą
Išsaugokite šabloną

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

Patarimas: Chunk naudojimas palengvina įterpimo kodo valdymą ir atnaujinimą vienoje vietoje, ypač jei naudojate kelis šablonus savo svetainėje.

Alternatyvus metodas 2: MODX sistemos nustatymų naudojimas (HTML Head/Footer)

Kai kuriuose MODX nustatymuose yra poraštės scenarijų vietos žymekliai per sistemos nustatymus:

MODX Manager aplinkoje eikite į System > System Settings
Filtruokite pagal "htmlhead" arba ieškokite individualaus sistemos nustatymo poraštės scenarijams
Jei jūsų nustatymuose yra vietos žymeklis poraštės scenarijams (pvz., [[++footer_scripts]]), galite jį naudoti
Nustatykite sistemos nustatymo reikšmę kaip savo Asyntai įterpimo kodą
Įsitikinkite, kad atitinkamas vietos žymeklis [[++footer_scripts]] yra jūsų šablone prieš uždaromąjį </body> žymą
Išsaugokite sistemos nustatymą

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

Pastaba: Šis metodas priklauso nuo to, ar jūsų MODX nustatymuose yra individualus sistemos nustatymas poraštės scenarijams. Jei jo nėra, galite sukurti individualų sistemos nustatymą ir nurodyti jį savo šablone naudodami [[++setting_key]] sintaksę.

Alternatyvus metodas 3: MODX papildinio naudojimas (OnWebPagePrerender)

Pažangiam būdui galite sukurti MODX papildinį, kuris automatiškai įterpia pokalbių roboto kodą į kiekvieną puslapį:

MODX Manager aplinkoje eikite į Elements > Plugins
Spustelėkite "New Plugin", kad sukurtumėte naują papildinį
Pavadinkite papildinį "AsyntaiChatbot"
Įklijuokite šį PHP kodą į papildinio kodo sritį:

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

Spustelėkite "System Events" skirtuką
Pažymėkite langelį šalia "OnWebPagePrerender", kad šis papildinys būtų aktyvuotas tuo įvykiu
Spustelėkite "Išsaugoti"

Svarbu: Pakeiskite YOUR_WIDGET_ID savo tikruoju valdiklio ID iš Asyntai valdymo skydelio. Šis papildinys automatiškai įterps pokalbių roboto scenarijų į kiekvieną jūsų MODX svetainės puslapį prieš jo atvaizdavimą.

3 žingsnis: Išvalykite talpyklą ir patikrinkite

Pridėję įterpimo kodą bet kuriuo iš aukščiau aprašytų metodų, turite išvalyti MODX talpyklą ir patikrinti diegimą:

MODX Manager aplinkoje eikite į Manage > Clear Cache (arba spustelėkite talpyklos valymo piktogramą viršutiniame meniu)
Atidarykite savo svetainę naujame naršyklės skirtuke arba inkognito lange
Turėtumėte matyti pokalbių valdiklio mygtuką apatiniame dešiniajame puslapio kampe
Spustelėkite jį, kad įsitikintumėte, jog jis atsidaro ir veikia teisingai

Nematote valdiklio? Įsitikinkite, kad išvalėte MODX talpyklą per Manage > Clear Cache MODX Manager aplinkoje. Taip pat pabandykite išvalyti naršyklės talpyklą arba peržiūrėti svetainę inkognito lange. Jei naudojote papildinio metodą, patikrinkite, ar sistemos įvykis "OnWebPagePrerender" yra pažymėtas jūsų papildiniui.