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

Водич корак по корак за ProcessWire 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: Додајте у фајл шаблона (препоручено)

ProcessWire користи PHP фајлове шаблона који се налазе у директоријуму site/templates/. Најлакши приступ је додавање кода за уградњу директно у ваш главни фајл шаблона:

Приступите вашим ProcessWire инсталационим фајловима путем FTP-а, SSH-а или вашег менаџера фајлова
Навигирајте до site/templates/
Отворите ваш главни фајл шаблона — ово је често _main.php или basic-page.php у зависности од профила вашег сајта
Ако користите стратегију одложеног излаза (подразумевано за већину профила сајтова), отворите _main.php
Пронађите затварајућу </body> ознаку
Налепите ваш 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>

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

Алтернативна метода 1: Коришћење _foot.inc или _main.php Append фајла

Ако ваш ProcessWire сајт користи приступ са append фајлом (уобичајен у многим профилима сајтова), можете додати код за уградњу у дељено укључивање подножја:

Навигирајте до site/templates/
Отворите _foot.inc (или ваш еквивалентни фајл за укључивање подножја)
Налепите ваш Asyntai код за уградњу непосредно испред затварајуће ознаке </body>
Сачувајте фајл

ProcessWire стратегија одложеног излаза обично ради са три кључна фајла:

_init.php — покреће се пре сваког шаблона, иницијализује променљиве
Ваш фајл шаблона (нпр. basic-page.php) — попуњава променљиве садржаја
_main.php — исписује коначни HTML код користећи те променљиве

Ако ваш сајт користи овај приступ, додавање скрипте у _main.php пре </body> обезбеђује да се појави на свакој страници.

Напомена: Имена фајлова _init.php и _main.php конфигурисана су у вашем site/config.php путем подешавања $config->prependTemplateFile и $config->appendTemplateFile. Проверите вашу конфигурацију ако су ваши фајлови другачије именовани.

Алтернативна метода 2: Коришћење низа $config->scripts

ProcessWire пружа $config->scripts FilenameArray који можете користити за управљање JavaScript фајловима. У вашем _init.php или појединачном фајлу шаблона, додајте:

<?php
$config->scripts->add('https://asyntai.com/static/js/chat-widget.js');
?>

Затим у вашем _main.php (или укључивању подножја), итерирајте кроз низ скрипти да их испишете:

<?php foreach($config->scripts as $file): ?>
<script src="<?php echo $file; ?>"></script>
<?php endforeach; ?>

Важно: Приступ $config->scripts обрађује атрибут src скрипте, али атрибут data-asyntai-id треба обрадити одвојено. Мораћете или ручно додати data атрибут у излазу петље, или користити методу директне script ознаке из Корака 2 за најједноставније подешавање.

Алтернативна метода 3: Коришћење Hook-а (ready.php)

За напреднији приступ, можете користити ProcessWire hook систем да аутоматски убаците скрипту чатбота на сваку страницу. Додајте следеће у ваш фајл site/ready.php:

<?php
$wire->addHookAfter('Page::render', function(HookEvent $event) {
    $html = $event->return;
    $script = '<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>';
    $html = str_replace('</body>', $script . '</body>', $html);
    $event->return = $html;
});
?>

Овај hook пресреће рендеровани HTML излаз сваке странице и аутоматски убацује Asyntai скрипту непосредно испред затварајуће ознаке </body>.

Савет: Приступ са ready.php hook-ом је идеалан ако желите чатбот на свакој страници без модификовања било каквих фајлова шаблона. Такође преживљава измене шаблона и ажурирања теме јер се налази изван фајлова шаблона.

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

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

Не видите виџет? Проверите да ли сте сачували све модификоване фајлове. Покушајте да обришете кеш прегледача или да прегледате у инкогнито прозору. Ако је кеш шаблона ProcessWire-а омогућен, можда ћете морати да га очистите одласком на Modules → Core → Template Engine Cache или додавањем ?nocache=1 у ваш URL. Такође потврдите да ваш фајл шаблона заиста користе странице које прегледате.