Cara Menambah Chatbot AI Asyntai ke MODX

Panduan langkah demi langkah untuk laman web MODX CMS

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 Templat MODX (Disyorkan)

Cara yang disyorkan untuk menambah chatbot adalah dengan mengedit Templat MODX anda secara langsung dalam MODX Manager:

Log masuk ke MODX Manager anda (panel admin)
Di bar sisi kiri, pergi ke Elements > Templates
Buka templat laman anda (biasanya dipanggil "BaseTemplate" atau templat aktif anda)
Cari tag penutup </body> dalam kod templat
Tampal kod benam Asyntai anda sejurus sebelum tag penutup </body>
Klik "Save" untuk menyimpan templat

<!-- Your existing template content -->

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

Petua: Menambah kod sejurus sebelum tag penutup </body> memastikan chatbot dimuatkan selepas semua kandungan halaman, yang merupakan penempatan yang disyorkan untuk widget sembang dan tidak akan melambatkan pemuatan halaman anda.

Kaedah Alternatif 1: Menggunakan Chunk MODX

Anda boleh menggunakan MODX Chunk untuk memastikan kod benam berasingan dan boleh diguna semula:

Dalam MODX Manager, pergi ke Elements > Chunks
Klik "New Chunk" untuk mencipta chunk baharu
Namakan chunk tersebut "asyntaiWidget"
Tampal kod benam Asyntai anda ke kawasan kandungan chunk
Klik "Save"
Buka templat anda (di bawah Elements > Templates)
Tambah panggilan chunk [[$asyntaiWidget]] sejurus sebelum tag penutup </body>
Simpan templat

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

Petua: Menggunakan Chunk memudahkan pengurusan dan pengemaskinian kod benam di satu tempat, terutamanya jika anda menggunakan pelbagai templat di seluruh laman anda.

Kaedah Alternatif 2: Menggunakan Tetapan Sistem MODX (HTML Head/Footer)

Sesetengah persediaan MODX menyertakan placeholder untuk skrip footer melalui Tetapan Sistem:

Dalam MODX Manager, pergi ke System > System Settings
Tapis mengikut "htmlhead" atau cari tetapan sistem tersuai untuk skrip footer
Jika persediaan anda mempunyai placeholder untuk skrip footer (seperti [[++footer_scripts]]), anda boleh menggunakannya
Tetapkan nilai tetapan sistem kepada kod benam Asyntai anda
Pastikan placeholder yang sepadan [[++footer_scripts]] wujud dalam templat anda sebelum tag penutup </body>
Simpan tetapan sistem

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

Nota: Kaedah ini bergantung pada persediaan MODX anda yang mempunyai tetapan sistem tersuai untuk skrip footer. Jika ia tidak wujud, anda boleh mencipta tetapan sistem tersuai dan merujuknya dalam templat anda menggunakan sintaks [[++setting_key]].

Kaedah Alternatif 3: Menggunakan Plugin MODX (OnWebPagePrerender)

Untuk pendekatan lanjutan, anda boleh mencipta Plugin MODX yang secara automatik menyuntik kod chatbot ke dalam setiap halaman:

Dalam MODX Manager, pergi ke Elements > Plugins
Klik "New Plugin" untuk mencipta plugin baharu
Namakan plugin tersebut "AsyntaiChatbot"
Tampal kod PHP berikut ke kawasan kod plugin:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

Klik tab "System Events"
Tandakan kotak di sebelah "OnWebPagePrerender" untuk mencetuskan plugin ini pada acara tersebut
Klik "Save"

Penting: Gantikan YOUR_WIDGET_ID dengan ID widget sebenar anda dari Papan Pemuka Asyntai. Plugin ini akan secara automatik menyuntik skrip chatbot ke dalam setiap halaman di laman MODX anda sebelum ia dipaparkan.

Langkah 3: Kosongkan Cache dan Sahkan

Selepas menambah kod benam menggunakan mana-mana kaedah di atas, anda perlu mengosongkan cache MODX dan mengesahkan pemasangan:

Dalam MODX Manager, pergi ke Manage > Clear Cache (atau klik ikon kosongkan cache di menu atas)
Buka laman web anda dalam tab pelayar baharu atau tetingkap inkognito
Anda sepatutnya melihat butang widget sembang di sudut kanan bawah halaman anda
Klik padanya untuk memastikan ia dibuka dan berfungsi dengan betul

Tidak nampak widget? Pastikan anda telah mengosongkan cache MODX dari Manage > Clear Cache dalam MODX Manager. Cuba juga kosongkan cache pelayar anda atau lihat laman dalam tetingkap inkognito. Jika anda menggunakan kaedah Plugin, sahkan bahawa acara sistem "OnWebPagePrerender" telah ditandakan untuk plugin anda.