Cara Menambahkan Chatbot AI Asyntai ke Concrete CMS

Panduan langkah demi langkah untuk situs web Concrete CMS (sebelumnya Concrete5)

Platform:

Langkah 1: Dapatkan Kode Embed Anda

Pertama, buka Dasbor Asyntai dan gulir ke bawah ke bagian "Kode Embed". Salin kode embed unik Anda yang akan terlihat seperti ini:

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

Catatan: Kode di atas hanya contoh. Anda harus menyalin kode embed unik Anda sendiri dari Dasbor karena berisi ID widget personal Anda.

Langkah 2: Tambahkan Kode ke Footer Tema (Disarankan)

Cara terbaik untuk menambahkan chatbot ke semua halaman situs web Concrete CMS Anda adalah dengan mengedit file footer tema Anda:

Akses instalasi Concrete CMS Anda melalui FTP atau File Manager
Navigasi ke direktori /application/themes/your_theme_name/
Temukan dan buka file footer.php (atau templat footer yang setara)
Temukan baris dengan tag penutup </body>
Tempel kode embed Asyntai Anda tepat sebelum tag </body>
Simpan file dan unggah kembali ke server Anda jika mengedit secara lokal
Bersihkan cache Concrete CMS: Dashboard → System & Settings → Clear Cache

Tip: Menambahkan kode sebelum tag penutup </body> memastikan chatbot dimuat setelah konten halaman Anda, yang memberikan performa muat halaman yang lebih baik. Metode ini secara otomatis menambahkan chatbot ke setiap halaman yang menggunakan tema ini.

Metode Alternatif 1: Blok HTML (Termudah untuk Non-Pengembang)

Jika Anda tidak ingin mengedit file tema, Anda dapat menggunakan blok HTML bawaan Concrete CMS:

Masuk ke Dasbor Concrete CMS Anda
Navigasi ke halaman di mana Anda ingin menambahkan chatbot
Klik Edit Page (ikon pensil di toolbar)
Klik Add Block di area di mana Anda ingin menempatkan kode
Cari dan pilih blok HTML
Tempel kode embed Asyntai Anda ke editor HTML
Klik Add untuk menyimpan blok
Klik Publish untuk membuat perubahan ditayangkan

Catatan: Metode blok HTML cocok untuk menambahkan chatbot ke halaman tertentu. Untuk instalasi di seluruh situs, Anda perlu menambahkan blok HTML ke setiap halaman, atau gunakan metode footer tema yang dijelaskan di atas. Penempatan visual blok tidak memengaruhi di mana chatbot muncul - chatbot tetap akan muncul di pojok kanan bawah.

Metode Alternatif 2: File Header Tema

Anda juga dapat menambahkan kode ke file header tema Anda untuk instalasi di seluruh situs:

Akses file Concrete CMS Anda melalui FTP atau File Manager
Navigasi ke /application/themes/your_theme_name/
Buka file header.php (atau elements/header.php)
Temukan tag penutup </head>
Tempelkan kode embed Asyntai Anda tepat sebelum tag </head>
Simpan dan unggah file
Bersihkan cache dari Dashboard

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

Tip: Pastikan untuk menyertakan elemen header yang diperlukan menggunakan <?php View::element('header_required'); ?> di file header.php Anda agar Concrete CMS berfungsi dengan baik.

Metode Alternatif 3: Template Kustom (Lanjutan)

Untuk pengembang yang menginginkan kontrol lebih, Anda dapat membuat template halaman kustom:

Buat file template halaman baru di /application/themes/your_theme_name/
Atau salin template yang sudah ada (misalnya, default.php) dan ubah namanya
Tambahkan kode embed Asyntai Anda ke file template sebelum </body>
Di Dashboard Concrete CMS, buka Pages & Themes
Klik pada Page Types
Pilih tipe halaman yang ingin Anda gunakan dengan template ini
Tetapkan template kustom Anda ke tipe halaman
Semua halaman yang menggunakan tipe halaman ini sekarang akan menyertakan chatbot

Penting: Selalu cadangkan file tema Anda sebelum melakukan perubahan. Uji modifikasi Anda di situs staging terlebih dahulu jika memungkinkan. Pengeditan yang salah pada file tema dapat merusak tata letak atau fungsionalitas situs Anda.

Langkah 3: Verifikasi Instalasi

Setelah melakukan perubahan dan membersihkan cache, buka situs web Anda di tab browser baru atau jendela penyamaran. Anda akan melihat tombol widget obrolan di pojok kanan bawah. Klik untuk memastikan widget terbuka dan berfungsi dengan benar.

Tidak melihat widget? Pastikan Anda telah membersihkan cache Concrete CMS (Dashboard → System & Settings → Clear Cache). Coba lihat situs Anda di jendela penyamaran. Periksa bahwa Anda telah menyimpan dan mengunggah semua perubahan file. Buka konsol browser (F12) untuk memeriksa kesalahan JavaScript.