Cara Menambah Chatbot AI Asyntai ke Backdrop CMS
Panduan langkah demi langkah untuk laman web Backdrop CMS
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 Templat Tema (Disyorkan)
Backdrop CMS menggunakan fail templat .tpl.php dalam temanya. Pendekatan yang disyorkan adalah menambah kod benam terus ke templat halaman tema aktif anda:
- Akses pemasangan Backdrop CMS anda melalui FTP atau Pengurus Fail
- Navigasi ke direktori tema aktif anda: themes/yourtheme/
- Buka fail page.tpl.php (atau layout.tpl.php bergantung pada tema anda)
- Cari tag penutup </body> atau baris <?php print $page_bottom; ?>
- Tampal kod benam Asyntai anda sejurus sebelum baris tersebut
- Simpan fail
<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>
Petua: Meletakkan kod sejurus sebelum <?php print $page_bottom; ?> atau tag penutup </body> memastikan chatbot dimuat selepas kandungan halaman, memberikan prestasi pemuatan halaman yang lebih baik. Kaedah ini secara automatik menambah chatbot ke setiap halaman yang menggunakan tema ini.
Kaedah Alternatif 1: Menggunakan Modul Tersuai
Anda boleh mencipta modul Backdrop CMS ringkas yang menyuntik skrip chatbot menggunakan backdrop_add_js():
- Cipta direktori modul: modules/custom/asyntai_widget/
- Cipta fail modul asyntai_widget.module dengan kod berikut:
// modules/custom/asyntai_widget/asyntai_widget.module
function asyntai_widget_init() {
backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array(
'type' => 'external',
'scope' => 'footer',
'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'),
));
} - Cipta fail asyntai_widget.info:
name = Asyntai AI Chatbot Widget
description = Adds the Asyntai AI chatbot widget to all pages.
backdrop = 1.x
package = Custom
type = module - Pergi ke Fungsi (admin/modules) dalam panel pentadbir Backdrop anda
- Cari "Asyntai AI Chatbot Widget" di bawah pakej Custom dan aktifkannya
- Klik "Save configuration"
Nota: Gantikan YOUR_WIDGET_ID dalam kod modul dengan ID widget sebenar anda dari Papan Pemuka Asyntai. Pendekatan modul tersuai adalah selamat untuk naik taraf dan tidak akan ditimpa semasa mengemas kini tema anda.
Kaedah Alternatif 2: Menggunakan Modul "Add to Head" Backdrop
Modul sumbangan "Add to Head" menyediakan cara mudah untuk menyuntik skrip tanpa mengedit kod:
- Muat turun dan pasang modul sumbangan "Add to Head" dari laman web Backdrop CMS
- Pergi ke Configuration > Development > Add to Head
- Tambah kod benam Asyntai anda dalam bahagian footer
- Klik "Save configuration"
Petua: Menggunakan modul "Add to Head" adalah kaedah paling mudah jika anda memilih untuk tidak mengedit fail tema atau mencipta modul tersuai. Ia menyediakan antara muka pentadbir yang ringkas untuk mengurus skrip yang disuntik.
Kaedah Alternatif 3: Menggunakan Sistem Blok
Sistem susun atur dan blok Backdrop CMS juga boleh digunakan untuk menambah chatbot:
- Log masuk ke panel pentadbir Backdrop CMS anda
- Pergi ke Structure > Layouts
- Pilih susun atur yang anda mahu edit (cth., susun atur lalai)
- Klik "Add block" dalam kawasan footer
- Pilih "Custom block"
- Tetapkan format blok kepada "Full HTML" atau "Raw HTML"
- Tampal kod benam Asyntai anda ke badan blok
- Berikan blok tajuk (cth., "Asyntai Chatbot") dan secara pilihan tandakan "Hide title"
- Klik "Save block" dan kemudian "Save layout"
Penting: Pastikan format teks ditetapkan kepada "Full HTML" atau "Raw HTML" supaya tag skrip tidak dilucutkan. Format "Filtered HTML" lalai akan membuang tag skrip atas sebab keselamatan.
Langkah 3: Kosongkan Cache dan Sahkan
Selepas membuat perubahan anda, kosongkan cache Backdrop CMS dan sahkan pemasangan:
- Pergi ke Configuration > Performance dalam panel pentadbir anda
- Klik "Clear all caches"
- Buka laman web anda dalam tab pelayar baharu atau tetingkap inkognito
- Anda sepatutnya melihat butang widget sembang di sudut kanan bawah
- Klik padanya untuk memastikan ia terbuka dan berfungsi dengan betul
Tidak nampak widget? Pastikan anda telah mengosongkan cache Backdrop CMS di Configuration > Performance. Cuba lihat tapak anda dalam tetingkap inkognito atau kosongkan cache pelayar anda. Buka konsol pelayar (F12) untuk menyemak sebarang ralat JavaScript. Jika anda menggunakan kaedah modul tersuai, sahkan modul diaktifkan di bawah Fungsi.
Weebly