Jak přidat Asyntai AI chatbota do Kirby

Podrobný návod pro weby na platformě Kirby CMS

Platforma:

Krok 1: Získejte svůj vkládací kód

Nejprve přejděte na svůj Asyntai Dashboard a přejděte dolů k sekci „Embed Code". Zkopírujte svůj unikátní kód pro vložení, který bude vypadat takto:

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

Poznámka: Kód výše je pouze příklad. Musíte zkopírovat svůj vlastní unikátní kód pro vložení z vašeho Dashboardu, protože obsahuje vaše osobní ID widgetu.

Krok 2: Přidání do snippetu Kirby (Doporučeno)

Kirby je CMS zalozeny na souborech v PHP, který používá snippety pro znovupouzitelne casti šablon. Doporučený postup je vytvořit vyhrazeny snippet pro chatbota:

Vytvořte nový soubor snippetu na site/snippets/asyntai-widget.php
Vložte svůj vložený kód do souboru:

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

Poté zahrňte snippet do své hlavní šablony (např. site/templates/default.php) nebo do svého rozložení, těsně před uzavírací tag </body>:

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

Tip: Pokud používáte sdílené rozložení nebo snippet zápatí, můžete tam volání snippetu přidat, aby se automaticky zobrazoval na každé stránce. Například jej přidejte do snippetu zápatí těsně před </body>.

Alternativní metoda 1: Přidání do snippetu zápatí

Pokud váš web Kirby používá snippet zápatí, můžete tam vložený kód přidat přímo:

Otevřete site/snippets/footer.php (vytvořte jej, pokud neexistuje)
Přidejte embed kód před uzavírací značku </body>:

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

Ujistěte se, že vaše šablony zahrnují snippet zápatí:

<?php snippet('footer') ?>

Poznámka: Pokud je snippet zápatí již zahrnut ve všech vašich šablonách, přidáním chatbota sem zajistíte jeho zobrazení na každé stránce bez nutnosti upravovat jednotlivé soubory šablon.

Alternativní metoda 2: Použití pluginu Kirby

Můžete vytvořit plugin Kirby pro automatické vložení skriptu chatbota na každou stránku bez nutnosti upravovat šablony:

Vytvořte adresář a soubor pluginu na site/plugins/asyntai/index.php
Přidejte následující kód pro použití hooků Kirby k vložení 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: Přístup přes plugin je ideální, pokud chcete, aby se chatbot načítal na každé stránce automaticky bez úpravy jakýchkoli souborů šablon nebo snippetů. Zároveň udržuje integraci chatbota modulární a snadno zapnutelnou či vypnutelnou.

Alternativní metoda 3: Použití pomocné funkce js() v Kirby

Kirby poskytuje vestavěnou pomocnou funkci js() pro načítání souborů JavaScript. Můžete ji použít ve své šabloně nebo snippetu:

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

Nebo přidejte skript přímo do svého PHP souboru šablony před </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: Pokud používáte pomocnou funkci js(), ujistěte se, že je umístěna uvnitř sekce <body> vaší šablony, aby se chatbot správně načetl.

Krok 3: Ověřte instalaci

Po přidání vloženého kódu na svůj web Kirby navštivte svůj web v nové kartě prohlížeče nebo v anonymním okně. V pravém dolním rohu byste měli vidět tlačítko chatového widgetu. Klikněte na něj a ověřte, že se správně otevírá a funguje.

Nevidíte widget? Ujistěte se, že jste nahradili YOUR_WIDGET_ID svým skutečným ID widgetu z nástěnkového panelu. Ověřte, že je soubor snippetu nebo pluginu uložen ve správném adresáři. Pokud používáte metodu pluginu, ujistěte se, že je struktura adresáře pluginu site/plugins/asyntai/index.php. Vymažte mezipaměť prohlížeče nebo testujte v anonymním režimu. Zkontrolujte vývojářskou konzoli prohlížeče (F12), zda nejsou nějaké chyby.