Како додати Asyntai AI чатбот на October CMS

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

Платформа:

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

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

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

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

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

Препоручени начин за додавање чатбота је уређивање вашег подразумеваног распореда у October CMS позадини:

Пријавите се на вашу October CMS позадину
Идите на CMS > Layouts у главном менију
Отворите ваш подразумевани распоред (обично default.htm)
Пронађите затварајућу </body> ознаку </body> ознаку и {% scripts %} плејсхолдер
Додајте свој Asyntai код за уградњу непосредно пре {% scripts %} и </body>:
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> {% scripts %} </body>
Кликните на "Save" да примените ваше измене

Савет: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

Можете користити October CMS плејсхолдер за скрипте да убаците чатбот са странице или парцијала:

Отворите било коју страницу или парцијал у CMS уређивачу
Додајте следећи код користећи {% put scripts %} блок:
{% put scripts %} <script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script> {% endput %}
Замените YOUR_WIDGET_ID стварним ИД-ом виџета са контролне табле
Кликните „Сачувај"

Напомена: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

Алтернативна метода 2: Коришћење Component PHP

Ако преферирате програмски приступ, можете додати скрипту чатбота путем прилагођене компоненте:

Креирајте или модификујте компоненту у вашем October CMS додатку
У методи onRun() компоненте, користите методу addJs():
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
Замените YOUR_WIDGET_ID стварним ИД-ом виџета
Региструјте компоненту на страницама где желите да се чатбот појави

Савет: Коришћење компоненте вам даје програмску контролу над тим када и где се чатбот учитава. Можете додати условну логику унутар onRun() за контролу учитавања на основу корисничких улога, типова страница или других критеријума.

Алтернативна метода 3: Коришћење парцијала

Можете креирати парцијал за поновну употребу за виџет чатбота:

Идите на CMS > Partials у October CMS позадини
Кликните на "+ Add" да креирате нови парцијал
Именујте га asyntai-widget.htm
Додајте ваш Asyntai код за уградњу у парцијал:
<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>
Кликните „Сачувај"
Отворите ваш шаблон распореда и укључите парцијал пре </body>:
{% partial 'asyntai-widget' %}
Сачувајте распоред

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

Корак 3: Верификујте инсталацију

Након чувања промена, посетите ваш October CMS веб-сајт у новој картици прегледача или инкогнито прозору. Требало би да видите дугме виџета за ћаскање у доњем десном углу. Кликните на њега да проверите да ли се отвара и ради исправно.

Не видите виџет? Проверите да ли сте сачували све измене у CMS позадини. Обришите кеш прегледача или прегледајте у инкогнито прозору. Ако ваш сајт користи кеширање, очистите October CMS кеш покретањем php artisan cache:clear из командне линије, или користите опцију Settings > System > Clear Cache у позадини.

Избор распореда: Проверите да ли странице на којима желите да се чатбот појави користе исправан распоред. Можете проверити који распоред страница користи отварањем странице у CMS > Pages и гледањем падајућег менија Layout у подешавањима странице.