Hur du lägger till Asyntai AI-chattbot i Kirby

Steg-för-steg-guide för Kirby CMS-webbplatser

Plattform:

Steg 1: Hämta din inbäddningskod

Gå först till din Asyntai-instrumentpanel och scrolla ner till avsnittet "Inbäddningskod". Kopiera din unika inbäddningskod som ser ut så här:

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

Obs! Koden ovan är bara ett exempel. Du måste kopiera din egen unika inbäddningskod från din Dashboard eftersom den innehåller ditt personliga widget-ID.

Steg 2: Lägg till i Kirby-snippet (rekommenderas)

Kirby är ett flat-file PHP-CMS som använder snippets för återanvändbara malldelar. Det rekommenderade tillvägagångssättet är att skapa ett dedikerat snippet för chattboten:

Skapa en ny snippetfil på site/snippets/asyntai-widget.php
Klistra in din inbäddningskod i filen:

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

Inkludera sedan utdraget i din huvudmall (t.ex. site/templates/default.php) eller din layout, precis före den avslutande </body>-taggen:

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

Tips: Om du använder en delad layout- eller sidfotssnutt kan du lägga till snutt-anropet där så att det automatiskt visas på varje sida. Lägg till det till exempel i din sidfotssnutt precis innan </body>.

Alternativ metod 1: Lägg till i sidfot-snippet

Om din Kirby-webbplats använder en sidfotssnutt kan du lägga till inbäddningskoden direkt där:

Öppna site/snippets/footer.php (skapa filen om den inte finns)
Lägg till inbäddningskoden före den avslutande </body>-taggen:

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

Se till att dina mallar inkluderar footer-fragmentet:

<?php snippet('footer') ?>

Obs! Om sidfotssnutten redan ingår i alla dina mallar säkerställer det att chattboten visas på varje sida utan att behöva ändra enskilda mallfiler.

Alternativ metod 2: Använda Kirby-plugin

Du kan skapa ett Kirby-tillägg för att automatiskt injicera chatbot-scriptet på varje sida utan att ändra några mallar:

Skapa plugin-katalogen och filen på site/plugins/asyntai/index.php
Lägg till följande kod för att injicera skriptet dynamiskt:

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);
        }
    ]
]);

Tips: Plugin-metoden är idealisk om du vill att chattboten ska laddas på varje sida automatiskt utan att redigera mall- eller utdragsfiler. Det håller också din chattbotintegration modulär och enkel att aktivera eller inaktivera.

Alternativ metod 3: Använda Kirbys js()-hjälpfunktion

Kirby tillhandahåller en inbyggd js()-hjälpfunktion för att ladda JavaScript-filer. Du kan använda den i din mall eller i ditt snippet:

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

Eller lägg till skriptet direkt i din mall-PHP-fil före </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>

Obs! Om du använder hjälpfunktionen js(), se till att den placeras inuti <body>-sektionen i din mall för att säkerställa att chattboten laddas korrekt.

Steg 3: Verifiera installationen

Efter att du har lagt till inbäddningskoden på din Kirby-webbplats, besök din webbplats i en ny webbläsarflik eller ett inkognitofönster. Du bör se widgetknappen för chatten i det nedre högra hörnet. Klicka på den för att kontrollera att den öppnas och fungerar korrekt.

Ser du inte widgeten? Se till att du ersatte YOUR_WIDGET_ID med ditt faktiska widget-ID från instrumentpanelen. Kontrollera att kodfragmentet eller plugin-filen är sparad i rätt katalog. Om du använder plugin-metoden, se till att plugin-katalogstrukturen är site/plugins/asyntai/index.php. Rensa webbläsarens cache eller testa i inkognitoläge. Kontrollera webbläsarens utvecklarkonsol (F12) för eventuella fel.