Ako pridať Asyntai AI chatbota do Kirby

Návod krok za krokom pre webové stránky Kirby CMS

Platforma:

Krok 1: Získajte svoj vkladací kód

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii „Vkladací kód“. Skopírujte svoj jedinečný vkladací kód, ktorý bude vyzerať takto:

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

Poznámka: Kód vyššie je len príklad. Musíte skopírovať svoj vlastný jedinečný vkladací kód zo svojho Dashboardu, pretože obsahuje vaše osobné ID widgetu.

Krok 2: Pridanie do snippetu Kirby (odporúčané)

Kirby je PHP CMS s plochymi súbormi, ktory pouziva snippety pre opakovane pouzitelne casti šablón. Odporucany prístup je vytvorit vyhradeny snippet pre chatbota:

Vytvorte novy súbor snippetu na site/snippets/asyntai-widget.php
Vložte svoj vkladací kód do súboru:

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

Potom zahrnte snippet do svojej hlavnej šablóny (napr. site/templates/default.php) alebo do svojho rozloženia, tesne pred uzatvaracim tagom </body>:

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

Tip: Ak používate zdiealane rozloženie alebo snippet paty, môžete tam pridat volanie snippetu, aby sa automaticky zobrazoval na kazdej stránke. Napriklad ho pridajte do svojho snippetu paty tesne pred </body>.

Alternativna metoda 1: Pridanie do snippetu paty

Ak vasa stranka Kirby pouziva snippet paty, môžete tam priamo pridat vkladací kod:

Otvorte site/snippets/footer.php (vytvorte ho, ak neexistuje)
Pridajte vkladací kod pred uzatvaraci tag </body>:

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

Uistite sa, ze vase šablóny zahrnaju snippet paty:

<?php snippet('footer') ?>

Poznámka: Ak je snippet paty uz zahrnuty naprieč vsetkymi vasimi šablónami, pridanie chatbota sem zabezpeci, ze sa zobrazi na kazdej stránke bez upravy jednotlivych súborov šablón.

Alternativna metoda 2: Použitie pluginu Kirby

Môžete vytvorit plugin Kirby na automaticke vloženie skriptu chatbota na kazdu stránku bez upravy akychkolvek šablón:

Vytvorte priečinok pluginu a súbor na site/plugins/asyntai/index.php
Pridajte nasledujuci kod na použitie hookov Kirby na vloženie skriptu:

Kirby::plugin('custom/asyntai', [
    'hooks' => [
        'page.render:after' => function ($contentType, $body) {
            $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
            return str_replace('</body>', $script . '</body>', $body);
        }
    ]
]);

Tip: Pristup s pluginom je idealny, ak chcete, aby sa chatbot nacital na kazdej stránke automaticky bez upravy akychkolvek súborov šablón alebo snippetov. Tiež udrzuje vasu integraciu chatbota modularnu a jednoduchu na povolenie alebo zakazanie.

Alternativna metoda 3: Použitie helpera js() od Kirby

Kirby poskytuje vstavany helper js() na nacitanie JavaScript súborov. Môžete ho pouzit vo vasej šablóne alebo snippete:

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

Alebo pridajte skript priamo do vasho súboru šablóny PHP pred </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 async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</body>
</html>

Poznámka: Ak používate helper js(), uistite sa, ze je umiestneny vo vnutri sekcie <body> vasej šablóny, aby sa chatbot nacital správne.

Krok 3: Overenie inštalácie

Po pridani vkladacieho kodu na vasu stránku Kirby navštívte svoju webovú stránku v novej karte prehliadača alebo v okne inkognito. Mali by ste vidiet tlačidlo chatoveho widgetu v pravom dolnom rohu. Kliknite nan, aby ste sa uistili, ze sa otvara a funguje správne.

Nevidíte widget? Uistite sa, ze ste nahradili YOUR_WIDGET_ID vasim skutocnym ID widgetu z dashboardu. Overte, ze súbor snippetu alebo pluginu je ulozeny v spravnom priečinku. Ak používate metodu s pluginom, uistite sa, ze struktura priečinka pluginu je site/plugins/asyntai/index.php. Vymažte vyrovnávaciu pamat prehliadača alebo testujte v rezime inkognito. Skontrolujte vyvojarsku konzolu prehliadača (F12) kvoli pripadnym chybam.