Slik legger du til Asyntai AI-chatbot på Kirby

Trinn-for-trinn-guide for Kirby CMS-nettsteder

Plattform:

Trinn 1: Hent innbyggingskoden din

Gå først til Asyntai-dashbordet ditt og bla ned til «Innbyggingskode»-seksjonen. Kopier din unike innbyggingskode som vil se slik ut:

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

Merk: Koden ovenfor er bare et eksempel. Du må kopiere din egen unike innbyggingskode fra Dashbordet ditt, da den inneholder din personlige widget-ID.

Trinn 2: Legg til i Kirby-snutt (anbefalt)

Kirby er et flatfil-PHP-CMS som bruker snutter for gjenbrukbare maldeler. Den anbefalte tilnærmingen er å opprette en dedikert snutt for chatboten:

Opprett en ny snuttfil på site/snippets/asyntai-widget.php
Lim inn innbyggingskoden i filen:

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

Deretter inkluderer du snutten i hovedmalen din (f.eks. site/templates/default.php) eller layouten din, rett før den avsluttende </body>-taggen:

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

Tips: Hvis du bruker en delt layout eller bunntekstsnutt, kan du legge til snuttanropet der slik at det automatisk vises på hver side. Legg det for eksempel til i bunntekstsnutten rett før </body>.

Alternativ metode 1: Legg til i bunntekstsnutt

Hvis Kirby-nettstedet ditt bruker en bunntekstsnutt, kan du legge til innbyggingskoden direkte der:

Åpne site/snippets/footer.php (opprett den hvis den ikke finnes)
Legg til innbyggingskoden før den avsluttende </body>-taggen:

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

Sørg for at malene dine inkluderer bunntekstsnutten:

<?php snippet('footer') ?>

Merk: Hvis bunntekstsnutten allerede er inkludert i alle malene dine, sikrer det at chatboten vises på hver side uten å endre individuelle malfiler.

Alternativ metode 2: Bruk av Kirby-utvidelse

Du kan opprette en Kirby-utvidelse for automatisk å injisere chatbot-skriptet på hver side uten å endre noen maler:

Opprett utvidelseskatalogen og filen på site/plugins/asyntai/index.php
Legg til følgende kode for å bruke Kirbys kroker til å injisere skriptet:

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: Utvidelsestilnærmingen er ideell hvis du vil at chatboten skal lastes på hver side automatisk uten å redigere noen mal- eller snuttfiler. Den holder også chatbot-integrasjonen modulær og enkel å aktivere eller deaktivere.

Alternativ metode 3: Bruk av Kirbys js()-hjelper

Kirby tilbyr en innebygd js()-hjelper for å laste JavaScript-filer. Du kan bruke den i malen eller snutten din:

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

Eller legg til skriptet direkte i malens PHP-fil før </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>

Merk: Hvis du bruker js()-hjelperen, sørg for at den er plassert inne i <body>-seksjonen av malen din for å sikre at chatboten lastes riktig.

Trinn 3: Bekreft installasjonen

Etter at du har lagt til innbyggingskoden på Kirby-nettstedet ditt, besøk nettstedet i en ny nettleserfane eller i et inkognitovindu. Du bør se chat-widget-knappen nederst til høyre. Klikk på den for å forsikre deg om at den åpnes og fungerer riktig.

Ser du ikke widgeten? Sørg for at du erstattet YOUR_WIDGET_ID med din faktiske widget-ID fra dashbordet. Verifiser at snutt- eller utvidelsefilen er lagret i riktig katalog. Hvis du bruker utvidelsesmetoden, sørg for at utvidelsens katalogstruktur er site/plugins/asyntai/index.php. Tøm nettleserens hurtigbuffer eller test i inkognitomodus. Sjekk nettleserens utviklerkonsoll (F12) for eventuelle feil.