Sådan tilføjer du Asyntai AI-chatbot til Kirby

Trin-for-trin guide til Kirby CMS-websteder

Platform:

Trin 1: Hent din indlejringskode

Gå først til dit Asyntai Dashboard og rul ned til sektionen "Indlejringskode". Kopiér din unikke indlejringskode, der vil se sådan ud:

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

Bemærk: Koden ovenfor er blot et eksempel. Du skal kopiere din egen unikke indlejringskode fra dit Dashboard, da den indeholder dit personlige widget-ID.

Trin 2: Tilføj til Kirby-snippet (anbefalet)

Kirby er et flat-file PHP CMS, der bruger snippets til genanvendelige skabelondele. Den anbefalede tilgang er at oprette et dedikeret snippet til chatbotten:

Opret en ny snippet-fil på site/snippets/asyntai-widget.php
Indsæt din indlejringskode i filen:

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

Inkluder derefter snippetten i din primære skabelon (f.eks. site/templates/default.php) eller dit layout, lige før det afsluttende </body>-tag:

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

Tip: Hvis du bruger et delt layout eller footer-snippet, kan du tilføje snippet-kaldet der, så det automatisk vises på hver side. For eksempel skal du tilføje det til dit footer-snippet lige før </body>.

Alternativ metode 1: Tilføj til footer-snippet

Hvis dit Kirby-websted bruger et footer-snippet, kan du tilføje indlejringskoden direkte der:

Åbn site/snippets/footer.php (opret den, hvis den ikke findes)
Tilføj indlejringskoden før det afsluttende </body>-tag:

    <!-- 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 dine skabeloner inkluderer footer-snippetten:

<?php snippet('footer') ?>

Bemærk: Hvis footer-snippetten allerede er inkluderet i alle dine skabeloner, sikrer tilføjelse af chatbotten her, at den vises på hver side uden at ændre individuelle skabelonfiler.

Alternativ metode 2: Brug af Kirby-plugin

Du kan oprette et Kirby-plugin for automatisk at indsprøjte chatbot-scriptet på hver side uden at ændre nogen skabeloner:

Opret plugin-mappen og filen på site/plugins/asyntai/index.php
Tilføj følgende kode for at bruge Kirbys hooks til at indsprøjte scriptet:

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: Plugin-tilgangen er ideel, hvis du ønsker, at chatbotten automatisk indlæses på hver side uden at redigere nogen skabelon- eller snippet-filer. Det holder også din chatbot-integration modulær og nem at aktivere eller deaktivere.

Alternativ metode 3: Brug af Kirbys js()-hjælper

Kirby tilbyder en indbygget js()-hjælper til indlæsning af JavaScript-filer. Du kan bruge den i din skabelon eller snippet:

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

Eller tilføj scriptet direkte i din skabelons 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>

Bemærk: Hvis du bruger js()-hjælperen, skal du sørge for, at den er placeret inden for <body>-sektionen i din skabelon for at sikre, at chatbotten indlæses korrekt.

Trin 3: Verificér installationen

Besøg dit websted i en ny browserfane eller inkognitovindue efter at have tilføjet indlejringskoden til dit Kirby-websted. Du bør se chat-widget-knappen i det nedre højre hjørne. Klik på den for at sikre, at den åbner og fungerer korrekt.

Ser du ikke widget'en? Sørg for, at du erstattede YOUR_WIDGET_ID med dit faktiske widget-ID fra dashboardet. Bekræft, at snippet- eller plugin-filen er gemt i den korrekte mappe. Hvis du bruger plugin-metoden, skal du sikre, at plugin-mappestrukturen er site/plugins/asyntai/index.php. Ryd din browsercache eller test i inkognitotilstand. Tjek din browsers udviklerkonsol (F12) for eventuelle fejl.