Kā pievienot Asyntai MI tērzēšanas robotu Kirby

Soli pa solim ceļvedis Kirby CMS tīmekļa vietnēm

Platforma:

1. solis: Iegūstiet savu iegulto kodu

Vispirms dodieties uz savu Asyntai vadības paneli un ritiniet uz leju līdz sadaļai "Iegultais kods". Nokopējiet savu unikālo iegulto kodu, kas izskatīsies šādi:

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

Piezīme: Iepriekš minētais kods ir tikai piemērs. Jums jānokopē savs unikālais iegultais kods no sava Vadības paneļa, jo tas satur jūsu personīgo logrīka ID.

2. solis: Pievienojiet Kirby fragmentam (ieteicams)

Kirby ir plakano failu PHP CMS, kas izmanto fragmentus atkārtoti lietojamām veidņu daļām. Ieteicamā pieeja ir izveidot speciālu fragmentu tērzēšanas robotam:

Izveidojiet jaunu fragmenta failu site/snippets/asyntai-widget.php
Ielīmējiet savu iegulto kodu failā:

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

Pēc tam iekļaujiet fragmentu savā galvenajā veidnē (piemēram, site/templates/default.php) vai izkārtojumā, tieši pirms noslēdzošā </body> taga:

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

Padoms: Ja izmantojat kopīgu izkārtojumu vai kājenes fragmentu, fragmenta izsaukumu var pievienot tur, lai tas automātiski parādītos katrā lapā. Piemēram, pievienojiet to savam kājenes fragmentam tieši pirms </body>.

Alternatīvā metode 1: Pievienot kājenes fragmentam

Ja jūsu Kirby vietne izmanto kājenes fragmentu, iegulto kodu var pievienot tieši tur:

Atveriet site/snippets/footer.php (izveidojiet, ja tas neeksistē)
Pievienojiet iegulto kodu pirms noslēdzošā </body> taga:

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

Pārliecinieties, ka jūsu veidnes iekļauj kājenes fragmentu:

<?php snippet('footer') ?>

Piezīme: Ja kājenes fragments jau ir iekļauts visās jūsu veidnēs, tērzēšanas robota pievienošana šeit nodrošina, ka tas parādās katrā lapā, nemodificējot atsevišķus veidņu failus.

Alternatīvā metode 2: Kirby spraudņa izmantošana

Jūs varat izveidot Kirby spraudni, lai automātiski injicētu tērzēšanas robota skriptu katrā lapā, nemodificējot nevienu veidni:

Izveidojiet spraudņa direktoriju un failu site/plugins/asyntai/index.php
Pievienojiet šādu kodu, lai izmantotu Kirby āķus skripta injicēšanai:

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

Padoms: Spraudņa pieeja ir ideāla, ja vēlaties, lai tērzēšanas robots ielādētos katrā lapā automātiski, nerediģējot nevienu veidnes vai fragmenta failu. Tā arī saglabā jūsu tērzēšanas robota integrāciju modulāru un viegli iespējojamu vai atspējojamu.

Alternatīvā metode 3: Kirby js() palīga izmantošana

Kirby nodrošina iebūvētu js() palīgu JavaScript failu ielādei. Varat to izmantot savā veidnē vai fragmentā:

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

Vai pievienojiet skriptu tieši savā veidnes PHP failā pirms </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>

Piezīme: Ja izmantojat js() palīgu, pārliecinieties, ka tas ir novietots veidnes <body> sadaļā, lai nodrošinātu pareizu tērzēšanas robota ielādi.

3. solis: Pārbaudiet instalēšanu

Pēc iegultā koda pievienošanas savai Kirby vietnei apmeklējiet savu tīmekļa vietni jaunā pārlūkprogrammas cilnē vai inkognito logā. Jums vajadzētu redzēt tērzēšanas logrīka pogu apakšējā labajā stūrī. Noklikšķiniet uz tās, lai pārliecinātos, ka tā atveras un darbojas pareizi.

Neredzat logrīku? Pārliecinieties, ka aizstājāt YOUR_WIDGET_ID ar savu reālo logrīka ID no vadības paneļa. Pārbaudiet, vai fragmenta vai spraudņa fails ir saglabāts pareizajā direktorijā. Ja izmantojat spraudņa metodi, pārliecinieties, ka spraudņa direktoriju struktūra ir site/plugins/asyntai/index.php. Notīriet pārlūkprogrammas kešatmiņu vai testējiet inkognito režīmā. Pārbaudiet pārlūkprogrammas izstrādātāja konsoli (F12), vai nav kļūdu.