Kaip pridėti Asyntai DI pokalbių robotą prie Kirby

Žingsnis po žingsnio vadovas Kirby CMS svetainėms

Platforma:

1 žingsnis: Gaukite savo įterpimo kodą

Pirma, eikite į savo Asyntai valdymo skydelį ir slinkite žemyn iki "Įterpimo kodas" skyriaus. Nukopijuokite savo unikalų įterpimo kodą, kuris atrodys taip:

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

Pastaba: Aukščiau pateiktas kodas yra tik pavyzdys. Turite nukopijuoti savo unikalų įterpimo kodą iš savo Valdymo skydelio, nes jame yra jūsų asmeninis valdiklio ID.

2 žingsnis: Pridėkite prie Kirby fragmento (Rekomenduojama)

Kirby yra failais pagrįsta PHP TVS, naudojanti fragmentus pakartotinai naudojamoms šablonų dalims. Rekomenduojamas būdas yra sukurti skirtą fragmentą pokalbių robotui:

Sukurkite naują fragmento failą site/snippets/asyntai-widget.php
Įklijuokite įterpimo kodą į failą:

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

Tada įtraukite fragmentą į pagrindinį šabloną (pvz., site/templates/default.php) arba išdėstymą, prieš pat uždaromąjį </body> žymą:

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

Patarimas: Jei naudojate bendrą išdėstymą ar poraštės fragmentą, galite pridėti fragmento kvietimą ten, kad jis automatiškai atsirastų kiekviename puslapyje. Pavyzdžiui, pridėkite jį prie poraštės fragmento prieš pat </body>.

Alternatyvus metodas 1: Pridėkite prie poraštės fragmento

Jei Kirby svetainė naudoja poraštės fragmentą, galite pridėti įterpimo kodą tiesiai ten:

Atidarykite site/snippets/footer.php (sukurkite, jei jo nėra)
Pridėkite įterpimo kodą prieš uždaromąjį </body> žymą:

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

Įsitikinkite, kad šablonai įtraukia poraštės fragmentą:

<?php snippet('footer') ?>

Pastaba: Jei poraštės fragmentas jau įtrauktas visuose šablonuose, pokalbių roboto pridėjimas čia užtikrina, kad jis bus rodomas kiekviename puslapyje nekeičiant atskirų šablonų failų.

Alternatyvus metodas 2: Kirby papildinio naudojimas

Galite sukurti Kirby papildinį, kad automatiškai įterptumėte pokalbių roboto skriptą į kiekvieną puslapį nekeičiant jokių šablonų:

Sukurkite papildinio katalogą ir failą site/plugins/asyntai/index.php
Pridėkite šį kodą, kad naudotumėte Kirby kabliukus skriptui įterpti:

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

Patarimas: Papildinio būdas idealus, jei norite, kad pokalbių robotas automatiškai krautųsi kiekviename puslapyje neredaguojant jokių šablonų ar fragmentų failų. Tai taip pat palaiko pokalbių roboto integraciją moduliarią ir lengvai įjungiamą ar išjungiamą.

Alternatyvus metodas 3: Kirby js() pagalbininko naudojimas

Kirby teikia integruotą js() pagalbininką JavaScript failams įkelti. Galite jį naudoti šablone ar fragmente:

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

Arba pridėkite skriptą tiesiai šablono PHP faile prieš </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>

Pastaba: Jei naudojate js() pagalbininką, įsitikinkite, kad jis patalpintas šablono <body> skyriuje, kad pokalbių robotas tinkamai krautųsi.

3 žingsnis: Patikrinkite diegimą

Pridėję įterpimo kodą prie Kirby svetainės, apsilankykite svetainėje naujame naršyklės skirtuke arba inkognito lange. Turėtumėte matyti pokalbių valdiklio mygtuką apatiniame dešiniajame kampe. Spustelėkite jį, kad įsitikintumėte, jog jis atsidaro ir veikia teisingai.

Nematote valdiklio? Įsitikinkite, kad pakeitėte YOUR_WIDGET_ID savo tikruoju valdiklio ID iš valdymo skydelio. Patikrinkite, ar fragmento ar papildinio failas išsaugotas teisingame kataloge. Jei naudojate papildinio metodą, įsitikinkite, kad papildinio katalogo struktūra yra site/plugins/asyntai/index.php. Išvalykite naršyklės talpyklą arba testuokite inkognito režimu. Patikrinkite naršyklės kūrėjo konsolę (F12) dėl klaidų.