Kuidas lisada Asyntai AI vestlusrobotit Kirbyle

Samm-sammuline juhend Kirby CMS-i veebisaitide jaoks

Platvorm:

1. samm: hankige oma manuskood

Esmalt minge oma Asyntai juhtpaneelile ja kerige alla jaotiseni "Manuskood". Kopeerige oma unikaalne manuskood, mis näeb välja selline:

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

Märkus: Ülalolev kood on vaid näide. Peate kopeerima oma unikaalse manuskoodi oma juhtpaneelilt, kuna see sisaldab teie isiklikku vidina ID-d.

2. samm: Lisage Kirby lõigule (soovitatav)

Kirby on lamedate failide PHP CMS, mis kasutab lõike korduvkasutatavate malliosade jaoks. Soovitatav lähenemine on luua vestlusroboti jaoks pühendatud lõik:

Looge uus lõigufail asukohta site/snippets/asyntai-widget.php
Kleepige oma manuskood faili:

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

Seejärel lisage lõik oma põhimallile (nt site/templates/default.php) või paigutusse, vahetult enne sulgevat </body> silti:

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

Vihje: Kui kasutate jagatud paigutuse või jaluse lõiku, saate lõigu kutse sinna lisada, nii et see ilmub automaatselt igale lehele. Näiteks lisage see oma jaluse lõigule vahetult enne </body>.

Alternatiivne meetod 1: lisage jaluse lõigule

Kui teie Kirby sait kasutab jaluse lõiku, saate manuskoodi otse sinna lisada:

Avage site/snippets/footer.php (looge see, kui seda ei eksisteeri)
Lisage manuskood enne sulgevat </body> silti:

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

Veenduge, et teie mallid sisaldavad jaluse lõiku:

<?php snippet('footer') ?>

Märkus: Kui jaluse lõik on juba kõigis teie mallides kaasatud, tagab vestlusroboti siia lisamine selle ilmumise igale lehele ilma üksikuid mallifaile muutmata.

Alternatiivne meetod 2: Kirby pistikprogrammi kasutamine

Saate luua Kirby pistikprogrammi, et vestlusroboti skripti automaatselt igale lehele süstida ilma ühtegi malli muutmata:

Looge pistikprogrammi kataloog ja fail asukohta site/plugins/asyntai/index.php
Lisage järgmine kood Kirby konksude kasutamiseks skripti süstimiseks:

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

Vihje: Pistikprogrammi lähenemine on ideaalne, kui soovite, et vestlusrobot laaditaks automaatselt igale lehele ilma malli- või lõigufaile muutmata. See hoiab ka teie vestlusroboti integratsiooni modulaarse ja lihtsalt lubatava või keelatavana.

Alternatiivne meetod 3: Kirby js() abifunktsiooni kasutamine

Kirby pakub sisseehitatud abifunktsiooni js() JavaScripti failide laadimiseks. Saate seda kasutada oma mallis või lõigus:

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

Või lisage skript otse oma malli PHP-faili enne </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>

Märkus: Kui kasutate abifunktsiooni js(), veenduge, et see on paigutatud oma malli jaotisesse <body>, et vestlusrobot laaditaks korrektselt.

3. samm: kontrollige paigaldust

Pärast manuskoodi lisamist oma Kirby saidile külastage oma veebisaiti uues brauseri vahekaardil või inkognito aknas. Peaksite nägema vestlusvidina nuppu alumises paremas nurgas. Klõpsake sellel, et veenduda, et see avaneb ja töötab korrektselt.

Ei näe vidinat? Veenduge, et asendasite YOUR_WIDGET_ID oma tegeliku vidina ID-ga juhtpaneelilt. Kontrollige, et lõigu- või pistikprogrammi fail on salvestatud õigesse kataloogi. Pistikprogrammi meetodi kasutamisel veenduge, et pistikprogrammi kataloogistruktuur on site/plugins/asyntai/index.php. Tühjendage brauseri vahemälu või testige inkognito režiimis. Kontrollige brauseri arenduskonsooli (F12) vigade suhtes.