Како додати Asyntai АИ четбот у MODX

Водич корак по корак за MODX CMS веб-сајтове

Платформа:

Корак 1: Набавите свој код за уграђивање

Прво, идите на своју Asyntai контролну таблу и померите се до одељка „Код за уграђивање". Копирајте свој јединствени код за уграђивање који ће изгледати овако:

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

Напомена: Код изнад је само пример. Морате копирати свој јединствени код за уграђивање са своје Контролне табле јер садржи ваш лични ИД виџета.

Корак 2: Додајте у MODX шаблон (препоручено)

Препоручени начин за додавање чатбота је уређивање вашег MODX шаблона директно у MODX Manager-у:

Пријавите се на свој MODX Manager (администраторски панел)
У левој бочној траци, идите на Елементи > Шаблони
Отворите шаблон вашег сајта (обично се зове "BaseTemplate" или ваш активни шаблон)
Пронађите затварајућу ознаку </body> у коду шаблона
Налепите ваш Asyntai код за уградњу непосредно испред затварајуће ознаке </body>
Кликните „Сачувај“ да сачувате шаблон

<!-- Your existing template content -->

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

Савет: Додавање кода непосредно испред затварајуће ознаке </body> обезбеђује да се чатбот учита после целог садржаја странице, што је препоручени положај за виџете за ћаскање и неће успорити учитавање ваше странице.

Алтернативни метод 1: Коришћење MODX Chunk-а

Можете користити MODX Chunk да задржите уграђени код одвојеним и поново употребљивим:

У MODX Manager-у, идите на Elements > Chunks
Кликните "New Chunk" да креирате нови chunk
Именујте chunk "asyntaiWidget"
Налепите свој Asyntai код за уграђивање у поље за садржај исечка
Кликните „Сачувај"
Отворите свој шаблон (под Elements > Templates)
Додајте позив chunk-а [[$asyntaiWidget]] непосредно испред затварајуће ознаке </body>
Сачувајте шаблон

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

Савет: Коришћење Chunk-а олакшава управљање и ажурирање кода за уградњу на једном месту, посебно ако користите више шаблона на вашем сајту.

Алтернативни метод 2: Коришћење MODX системских подешавања (HTML заглавље/подножје)

Нека MODX подешавања укључују плејсхолдере за скрипте подножја путем системских подешавања:

У MODX Manager-у, идите на Систем > Системска подешавања
Филтрирајте по "htmlhead" или претражите прилагођено системско подешавање за скрипте подножја
Ако ваше подешавање има плејсхолдер за скрипте подножја (као што је [[++footer_scripts]]), можете га користити
Поставите вредност системског подешавања на свој Asyntai код за уграђивање
Проверите да ли је одговарајући плејсхолдер [[++footer_scripts]] присутан у вашем шаблону пре затварајуће ознаке </body>
Сачувајте системско подешавање

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

Напомена: Ова метода зависи од тога да ли ваше MODX подешавање има прилагођено системско подешавање за скрипте подножја. Ако не постоји, можете креирати прилагођено системско подешавање и референцирати га у вашем шаблону користећи синтаксу [[++setting_key]].

Алтернативни метод 3: Коришћење MODX додатка (OnWebPagePrerender)

За напредни приступ, можете креирати MODX додатак који аутоматски убацује код чатбота на сваку страницу:

У MODX Manager-у, идите на Elements > Plugins
Кликните на "New Plugin" да креирате нови додатак
Именујте додатак "AsyntaiChatbot"
Налепите следећи PHP код у поље за код додатка:

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

Кликните на картицу "System Events"
Означите поље поред "OnWebPagePrerender" да бисте покренули овај додатак на том догађају
Кликните „Сачувај"

Важно: Замените YOUR_WIDGET_ID вашим стварним ID-ом виџета са Asyntai контролне табле. Овај додатак ће аутоматски убацити скрипту чатбота на сваку страницу вашег MODX сајта пре него што се рендерује.

Корак 3: Обришите кеш и верификујте

Након додавања кода за уградњу коришћењем било које од горе наведених метода, потребно је да очистите MODX кеш и потврдите инсталацију:

У MODX Manager-у, идите на Manage > Clear Cache (или кликните на иконицу за чишћење кеша у горњем менију)
Отворите ваш веб-сајт у новој картици прегледача или инкогнито прозору
Требало би да видите дугме виџета за ћаскање у доњем десном углу ваше странице
Кликните на њега да проверите да ли се отвара и ради исправно

Не видите виџет? Проверите да ли сте очистили MODX кеш из Manage > Clear Cache у MODX Manager-у. Такође покушајте да обришете кеш прегледача или да прегледате сајт у инкогнито прозору. Ако сте користили методу са додатком, потврдите да је системски догађај "OnWebPagePrerender" означен за ваш додатак.