Cara Menambah Chatbot AI Asyntai ke TYPO3
Panduan langkah demi langkah untuk laman web TYPO3
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 TypoScript footerData (Disyorkan)
Cara paling mudah untuk menambah chatbot ke semua halaman adalah menggunakan TypoScript footerData:
- Log masuk ke Backend TYPO3 anda
- Pergi ke Web → Template
- Pilih halaman akar anda dalam pepohon halaman
- Klik pada "Edit the whole template record" (atau pilih "Info/Modify" dan kemudian "Setup")
- Dalam medan Setup, tambah kod TypoScript berikut:
page.footerData.99 = TEXT
page.footerData.99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> - Gantikan
YOUR_WIDGET_IDdengan ID widget sebenar anda dari papan pemuka - Klik "Save"
- Kosongkan cache TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
Petua: Menggunakan footerData meletakkan skrip sejurus sebelum tag penutup </body>, yang disyorkan untuk widget sembang kerana ia tidak akan melambatkan pemuatan halaman anda.
Alternatif: Menggunakan Pakej Laman (Untuk Pakej Laman)
Jika anda menggunakan pakej laman, anda boleh menambah skrip melalui fail konfigurasi TypoScript anda:
- Navigasi ke folder pakej laman anda:
packages/your_sitepackage/Configuration/TypoScript/ - Buka atau cipta setup.typoscript
- Tambah kod berikut:
page.footerData {
99 = TEXT
99.value = <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
} - Gantikan
YOUR_WIDGET_IDdengan ID widget sebenar anda - Kosongkan cache dalam backend TYPO3
Alternatif: Menggunakan Templat Fluid (FooterAssets)
For sites using Fluid templates, you can use the FooterAssets section:
- Navigasi ke fail templat Fluid anda (biasanya dalam
Resources/Private/Templates/) - Tambah bahagian FooterAssets dalam layout atau templat anda:
<f:section name="FooterAssets">
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</f:section> - Pastikan layout halaman anda memaparkan bahagian FooterAssets:
<f:render section="FooterAssets" optional="true" /> - Kosongkan cache TYPO3
Penting: Ciri FooterAssets memerlukan TYPO3 v8 atau lebih baharu. Untuk versi lebih lama, gunakan kaedah TypoScript footerData.
Alternatif: Menggunakan AssetCollector (Untuk Pembangun)
Untuk pembangun sambungan, TYPO3 v10.3+ menawarkan API AssetCollector:
- Dalam kod PHP anda (contohnya, pengawal atau middleware), suntik AssetCollector
- Tambah skrip dengan atribut tersuai:
use TYPO3\CMS\Core\Page\AssetCollector;
$this->assetCollector->addJavaScript(
'asyntai_chatbot',
'https://asyntai.com/static/js/chat-widget.js',
['async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID']
);
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 untuk mengosongkan semua cache: pergi ke Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Cuba juga kosongkan cache pelayar anda atau lihat dalam tetingkap inkognito. Jika menggunakan TypoScript, sahkan bahawa templat anda disertakan dengan betul dalam hierarki halaman.
Weebly