Cara Menambah Chatbot AI Asyntai ke Drupal

Panduan langkah demi langkah untuk laman web Drupal

Dapatkan Kod Benam

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: Menggunakan Modul Header and Footer Scripts (Disyorkan)

Cara paling mudah untuk menambah chatbot ialah menggunakan modul "Header and Footer Scripts":

  1. Log masuk ke panel pentadbir Drupal anda
  2. Pergi ke Extend dan klik "Install new module"
  3. Cari "Header and Footer Scripts" atau muat turun dari Drupal.org
  4. Pasang dan aktifkan modul
  5. Pergi ke Configuration → Development → Header and Footer Scripts
  6. Klik pada tab "Footer"
  7. Tampal kod benam Asyntai anda dalam kawasan teks skrip footer
  8. Klik "Save configuration"

Petua: Menambah kod ke bahagian footer memastikan ia dimuatkan selepas kandungan halaman, yang disyorkan untuk widget sembang.

Alternatif: Edit Templat Tema

Anda boleh menambah kod terus ke fail templat tema anda:

  1. Navigasi ke folder tema anda: themes/your_theme/
  2. Buka fail html.html.twig (atau buat satu jika belum wujud)
  3. Cari tag penutup </body>
  4. Tampal kod benam Asyntai anda sejurus sebelum tag </body>
  5. Simpan fail
  6. Kosongkan cache Drupal: Configuration → Performance → Clear all caches

Penting: Perubahan pada fail tema mungkin ditimpa apabila mengemas kini tema anda. Pertimbangkan untuk menggunakan tema anak atau modul Header and Footer Scripts untuk penyelesaian yang lebih kekal.

Alternatif: Menggunakan Pustaka (Untuk Pembangun)

Untuk pembangun yang lebih suka menggunakan sistem pustaka aset Drupal:

  1. Buat atau edit fail *.libraries.yml tema anda
  2. Tambah entri pustaka baharu:
    asyntai-chatbot:
    js:
    https://asyntai.com/static/js/chat-widget.js: { type: external, attributes: { async: true, data-asyntai-id: YOUR_WIDGET_ID } }
  3. Lampirkan pustaka dalam fail *.info.yml tema anda:
    libraries:
    - your_theme/asyntai-chatbot
  4. Kosongkan cache Drupal

Langkah 3: Sahkan Pemasangan

Selepas menyimpan perubahan anda dan mengosongkan cache, 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 mengosongkan cache Drupal dengan pergi ke Configuration → Performance → Clear all caches. Juga cuba kosongkan cache pelayar anda atau lihat dalam tetingkap inkognito.