Kako dodati Asyntai AI chatbot na Kirby

Vodič korak po korak za Kirby CMS web stranice

Platforma:

Korak 1: Nabavite svoj kod za ugradnju

Prvo idite na svoju Asyntai nadzornu ploču i pomaknite se prema dolje do odjeljka "Kod za ugradnju". Kopirajte svoj jedinstveni kod za ugradnju koji će izgledati ovako:

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

Napomena: Gornji kod je samo primjer. Morate kopirati svoj vlastiti jedinstveni kod za ugradnju sa svoje Nadzorne ploče jer sadrži vaš osobni ID widgeta.

Korak 2: Dodajte u Kirby isječak (Preporučeno)

Kirby je PHP CMS temeljen na datotekama koji koristi isjecke za visekratne dijelove predlozaka. Preporuceni pristup je izrada namjenskog isjecka za chatbot:

Izradite novu datoteku isjecka na site/snippets/asyntai-widget.php
Zalijepite svoj ugradni kod u datoteku:

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

Zatim ukljucite isjecak u svoj glavni predlozak (npr. site/templates/default.php) ili raspored, neposredno prije zavrsne oznake </body>:

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

Savjet: Ako koristite zajednicki raspored ili isjecak podnozja, mozete dodati poziv isjecka tamo kako bi se automatski pojavljivao na svakoj stranici. Na primjer, dodajte ga u isjecak podnozja neposredno prije </body>.

Alternativna metoda 1: Dodajte u isječak podnožja

Ako vasa Kirby stranica koristi isjecak podnozja, mozete dodati ugradni kod izravno tamo:

Otvorite site/snippets/footer.php (izradite ga ako ne postoji)
Dodajte ugradni kod prije završne oznake </body>:

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

Provjerite uključuju li vaši predlošci isječak podnožja:

<?php snippet('footer') ?>

Napomena: Ako je isjecak podnozja vec ukljucen u svim vasim predloscima, dodavanje chatbota ovdje osigurava pojavljivanje na svakoj stranici bez mijenjanja pojedinacnih datoteka predlozaka.

Alternativna metoda 2: Korištenje Kirby dodatka

Mozete izraditi Kirby dodatak za automatsko ubacivanje skripte chatbota na svaku stranicu bez mijenjanja predlozaka:

Izradite direktorij dodatka i datoteku na site/plugins/asyntai/index.php
Dodajte sljedeći kod za korištenje Kirbyjevih kukica za ubacivanje skripte:

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

Savjet: Pristup s dodatkom idealan je ako zelite da se chatbot automatski ucitava na svakoj stranici bez uredivanja datoteka predlozaka ili isjecaka. Takoder drzi integraciju chatbota modularnom i lakom za omogucavanje ili onemogucavanje.

Alternativna metoda 3: Korištenje Kirbyjevog js() pomoćnika

Kirby pruza ugradeni pomocnik js() za ucitavanje JavaScript datoteka. Mozete ga koristiti u svom predlosku ili isjecku:

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

Ili dodajte skriptu izravno u svoju PHP datoteku predloska prije </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>

Napomena: Ako koristite pomocnik js(), provjerite je li postavljen unutar odjeljka <body> vaseg predloska kako bi se chatbot ispravno ucitao.

Korak 3: Provjerite instalaciju

Nakon dodavanja ugradnog koda na vasu Kirby stranicu, posjetite svoju web stranicu u novoj kartici preglednika ili anonimnom prozoru. Trebali biste vidjeti gumb widgeta za razgovor u donjem desnom kutu. Kliknite ga kako biste provjerili otvara li se i radi li ispravno.

Ne vidite widget? Provjerite jeste li zamijenili YOUR_WIDGET_ID svojim stvarnim ID-jem widgeta s nadzorne ploce. Potvrdite da je datoteka isjecka ili dodatka spremljena u ispravnom direktoriju. Ako koristite metodu dodatka, provjerite strukturu direktorija dodatka site/plugins/asyntai/index.php. Ocistite predmemoriju preglednika ili testirajte u anonimnom nacinu. Provjerite konzolu za programere preglednika (F12) za greske.