Cara Menambah Chatbot AI Asyntai ke Umbraco
Panduan langkah demi langkah untuk laman web Umbraco 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: Edit Templat Master (Disyorkan)
Cara paling mudah untuk menambah chatbot ke semua halaman adalah dengan mengedit templat Master anda:
- Log masuk ke Backoffice Umbraco anda
- Pergi ke Settings dalam bar sisi kiri
- Kembangkan Templates
- Klik pada templat Master anda (atau templat layout utama yang digunakan oleh laman anda)
- Cari tag penutup
</body> - Tampal kod benam Asyntai anda sejurus sebelum tag
</body> - Klik "Save"
Petua: Menambah skrip sebelum tag penutup </body> memastikan ia dimuatkan selepas kandungan halaman, yang disyorkan untuk widget sembang dan tidak akan melambatkan pemuatan halaman anda.
Alternatif: Menggunakan Jenis Dokumen Tetapan Laman
Untuk lebih fleksibiliti, anda boleh menambah medan tersuai untuk menguruskan skrip footer:
- Pergi ke Settings → Document Types
- Edit jenis dokumen Site Settings anda (atau cipta satu jika ia tidak wujud)
- Tambah sifat baharu dipanggil "Footer Scripts" dengan jenis data Textarea
- Simpan Jenis Dokumen
- Pergi ke Content dan edit nod Site Settings anda
- Tampal kod benam Asyntai anda dalam medan Footer Scripts
- Dalam templat Master anda, tambah kod ini sebelum
</body>:@Html.Raw(Model.Value("footerScripts")) - Simpan kedua-dua kandungan dan templat
Nota: Menggunakan @Html.Raw() adalah penting untuk memaparkan tag skrip dengan betul tanpa pengekodan HTML.
Alternatif: Menggunakan Folder Scripts
Anda juga boleh mencipta fail JavaScript dalam Backoffice Umbraco:
- Pergi ke Settings → Scripts
- Klik kanan pada Scripts dan pilih "Create"
- Cipta fail baharu bernama asyntai-chatbot.js
- Tambah kod berikut:
(function() {
var script = document.createElement('script');
script.async = true;
script.src = 'https://asyntai.com/static/js/chat-widget.js';
script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
document.body.appendChild(script);
})(); - Gantikan
YOUR_WIDGET_IDdengan ID widget sebenar anda - Simpan fail
- Sertakan skrip ini dalam templat Master anda sebelum
</body>:<script src="/scripts/asyntai-chatbot.js"></script>
Alternatif: Khusus Halaman dengan RenderSection
Jika anda hanya mahu chatbot pada halaman tertentu:
- Dalam templat Master anda, tambah sebelum
</body>:@RenderSection("footerScripts", required: false) - Dalam templat halaman tertentu di mana anda mahu chatbot, tambah:
@section footerScripts {
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
}
Langkah 3: Sahkan Pemasangan
Selepas menyimpan perubahan 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 menyimpan templat selepas membuat perubahan. Cuba kosongkan cache pelayar anda atau lihat dalam tetingkap inkognito. Jika anda menggunakan Umbraco Cloud, perubahan sepatutnya dideploy secara automatik. Untuk Umbraco yang dihoskan sendiri, anda mungkin perlu memulakan semula aplikasi atau mengosongkan cache.
Weebly