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

Водич корак по корак за Kirby 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: Додајте у Kirby исечак (препоручено)

Kirby је PHP CMS са равним фајловима који користи исечке за делове шаблона за поновну употребу. Препоручени приступ је креирање наменског исечка за четбот:

Креирајте нови фајл исечка на site/snippets/asyntai-widget.php
Налепите код за уграђивање у фајл:

<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>

Затим укључите исечак у свој главни шаблон (нпр. site/templates/default.php) или распоред, непосредно пре затварајуће </body> ознаке:

<?php snippet('asyntai-widget') ?>
</body>
</html>

Савет: Ако користите заједнички распоред или исечак подножја, можете додати позив исечка тамо тако да се аутоматски појављује на свакој страници. На пример, додајте га у свој исечак подножја непосредно пре </body>.

Алтернативни метод 1: Додајте у исечак подножја

Ако ваш Kirby сајт користи исечак подножја, можете директно тамо додати код за уграђивање:

Отворите site/snippets/footer.php (креирајте га ако не постоји)
Додајте код за уградњу пре затварајуће ознаке </body>:

    <!-- Footer content -->
    <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>
</html>

Уверите се да ваши шаблони укључују исечак подножја:

<?php snippet('footer') ?>

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

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

Можете креирати Kirby додатак за аутоматско убацивање скрипте четбота на сваку страницу без мењања шаблона:

Креирајте директоријум и фајл додатка на site/plugins/asyntai/index.php
Додајте следећи код за коришћење Kirby кукица за убацивање скрипте:

Kirby::plugin('custom/asyntai', [
    'hooks' => [
        'page.render:after' => function ($contentType, $body) {
            $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>';
            return str_replace('</body>', $script . '</body>', $body);
        }
    ]
]);

Савет: Приступ са додатком је идеалан ако желите да се четбот аутоматски учитава на свакој страници без уређивања фајлова шаблона или исечака. Такође одржава интеграцију четбота модуларном и лаком за омогућавање или онемогућавање.

Алтернативни метод 3: Коришћење Kirby js() помоћне функције

Kirby обезбеђује уграђену js() помоћну функцију за учитавање JavaScript фајлова. Можете је користити у свом шаблону или исечку:

<?= js('https://asyntai.com/static/js/chat-widget.js', ['async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID']) ?>

Или додајте скрипту директно у свом PHP фајлу шаблона пре </body>:

<?php // site/templates/default.php ?>
<html>
<head>
    <!-- head content -->
</head>
<body>
    <!-- page content -->
    <?php snippet('header') ?>
    <main>
        <?= $page->text()->kirbytext() ?>
    </main>
    <?php snippet('footer') ?>

    <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>
</html>

Напомена: Ако користите js() помоћну функцију, уверите се да је постављена унутар <body> одељка шаблона да би се четбот исправно учитао.

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

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

Не видите виџет? Уверите се да сте заменили YOUR_WIDGET_ID стварним ИД-ом виџета са контролне табле. Верификујте да је фајл исечка или додатка сачуван у тачном директоријуму. Ако користите метод додатка, уверите се да је структура директоријума додатка site/plugins/asyntai/index.php. Обришите кеш претраживача или тестирајте у инкогнито режиму. Проверите развојну конзолу претраживача (F12) за евентуалне грешке.