Cara Menambah Chatbot AI Asyntai ke Kirby

Panduan langkah demi langkah untuk laman web CMS Kirby

Platform:

Langkah 1: Dapatkan Kod Benam Anda

Pertama, pergi ke Papan Pemuka Asyntai anda dan tatal ke bawah ke bahagian "Kod Benam". Salin kod benam unik anda yang akan kelihatan seperti ini:

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

Nota: Kod di atas hanyalah contoh. Anda mesti menyalin kod benam unik anda sendiri dari Papan Pemuka anda kerana ia mengandungi ID widget peribadi anda.

Langkah 2: Tambah ke Coretan Kirby (Disyorkan)

Kirby ialah CMS PHP fail rata yang menggunakan coretan untuk bahagian templat boleh guna semula. Pendekatan yang disyorkan ialah membuat coretan khusus untuk chatbot:

Buat fail coretan baharu di site/snippets/asyntai-widget.php
Tampal kod benam anda ke dalam fail:

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

Kemudian sertakan coretan dalam templat utama anda (contohnya, site/templates/default.php) atau susun atur anda, sejurus sebelum tag penutup </body>:

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

Petua: Jika anda menggunakan susun atur atau coretan footer yang dikongsi, anda boleh menambah panggilan coretan di situ supaya ia muncul secara automatik pada setiap halaman. Contohnya, tambah ia ke coretan footer anda sejurus sebelum </body>.

Kaedah Alternatif 1: Tambah ke Coretan Footer

Jika laman Kirby anda menggunakan coretan footer, anda boleh menambah kod benam terus di situ:

Buka site/snippets/footer.php (buat jika belum wujud)
Tambah kod benam sebelum tag penutup </body>:

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

Pastikan templat anda menyertakan coretan footer:

<?php snippet('footer') ?>

Nota: Jika coretan footer sudah disertakan merentasi semua templat anda, menambah chatbot di sini memastikan ia muncul pada setiap halaman tanpa mengubah suai fail templat individu.

Kaedah Alternatif 2: Menggunakan Plugin Kirby

Anda boleh membuat plugin Kirby untuk menyuntik skrip chatbot secara automatik ke setiap halaman tanpa mengubah suai sebarang templat:

Buat direktori plugin dan fail di site/plugins/asyntai/index.php
Tambah kod berikut untuk menggunakan cangkuk Kirby bagi menyuntik skrip:

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

Petua: Pendekatan plugin adalah ideal jika anda mahu chatbot dimuatkan pada setiap halaman secara automatik tanpa mengedit sebarang fail templat atau coretan. Ia juga mengekalkan integrasi chatbot anda secara modular dan mudah untuk diaktifkan atau dinyahaktifkan.

Kaedah Alternatif 3: Menggunakan Pembantu js() Kirby

Kirby menyediakan pembantu js() terbina dalam untuk memuatkan fail JavaScript. Anda boleh menggunakannya dalam templat atau coretan anda:

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

Atau tambah skrip terus dalam fail PHP templat anda sebelum </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>

Nota: Jika anda menggunakan pembantu js(), pastikan ia diletakkan di dalam bahagian <body> templat anda untuk memastikan chatbot dimuatkan dengan betul.

Langkah 3: Sahkan Pemasangan

Selepas menambah kod benam ke laman Kirby anda, lawati laman web anda dalam tab pelayar baharu atau tetingkap inkognito. Anda sepatutnya melihat butang widget sembang di sudut kanan bawah. Klik untuk memastikan ia terbuka dan berfungsi dengan betul.

Tidak nampak widget? Pastikan anda telah menggantikan YOUR_WIDGET_ID dengan ID widget sebenar anda dari papan pemuka. Sahkan bahawa fail coretan atau plugin disimpan dalam direktori yang betul. Jika menggunakan kaedah plugin, pastikan struktur direktori plugin ialah site/plugins/asyntai/index.php. Kosongkan cache pelayar anda atau uji dalam mod inkognito. Semak konsol pembangun pelayar anda (F12) untuk sebarang ralat.