Asyntai AI Chatbot'u Backdrop CMS'e Nasıl Eklersiniz
Backdrop CMS web siteleri için adım adım kılavuz
Adım 1: Yerleştirme Kodunuzu Alın
Önce Asyntai Dashboard'unuza gidin ve "Yerleştirme Kodu" bölümüne inin. Şuna benzeyen benzersiz yerleştirme kodunuzu kopyalayın:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Not: Yukarıdaki kod yalnızca bir örnektir. Kişisel widget kimliğinizi içerdiğinden, kendi benzersiz yerleştirme kodunuzu Dashboard'unuzdan kopyalamanız gerekir.
Adım 2: Tema Şablonuna Ekleyin (Önerilen)
Backdrop CMS, temalarında .tpl.php şablon dosyaları kullanır. Önerilen yaklaşım, yerleştirme kodunu doğrudan aktif temanızın sayfa şablonuna eklemektir:
- Backdrop CMS kurulumunuza FTP veya Dosya Yöneticisi aracılığıyla erişin
- Aktif temanızın dizinine gidin: themes/yourtheme/
- page.tpl.php dosyasını açın (veya temanıza bağlı olarak layout.tpl.php)
- Kapanış </body> etiketini veya <?php print $page_bottom; ?> satırını bulun
- Asyntai yerleştirme kodunuzu bu satırın hemen öncesine yapıştırın
- Dosyayı kaydedin
<!-- Asyntai AI Chatbot -->
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
<?php print $page_bottom; ?>
</body>
İpucu: Kodu <?php print $page_bottom; ?> veya kapanış </body> etiketinin hemen öncesine yerleştirmek, chatbot'un sayfa içeriğinden sonra yüklenmesini sağlayarak daha iyi sayfa yükleme performansı sunar. Bu yöntem, bu temayı kullanan her sayfaya chatbot'u otomatik olarak ekler.
Alternatif Yöntem 1: Özel Modül Kullanma
backdrop_add_js() kullanarak chatbot komut dosyasını enjekte eden basit bir Backdrop CMS modülü oluşturabilirsiniz:
- Modül dizinini oluşturun: modules/custom/asyntai_widget/
- Aşağıdaki kodla asyntai_widget.module modül dosyasını oluşturun:
// modules/custom/asyntai_widget/asyntai_widget.module
function asyntai_widget_init() {
backdrop_add_js('https://asyntai.com/static/js/chat-widget.js', array(
'type' => 'external',
'scope' => 'footer',
'attributes' => array('async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID'),
));
} - asyntai_widget.info dosyasını oluşturun:
name = Asyntai AI Chatbot Widget
description = Adds the Asyntai AI chatbot widget to all pages.
backdrop = 1.x
package = Custom
type = module - Backdrop yönetici panelinizde İşlevsellik (admin/modules) bölümüne gidin
- Custom paketi altında "Asyntai AI Chatbot Widget"'ı bulun ve etkinleştirin
- "Yapılandırmayı kaydet"'e tıklayın
Not: Modül kodundaki YOUR_WIDGET_ID kısmını Asyntai Dashboard'daki gerçek widget kimliğinizle değiştirin. Özel modül yaklaşımı güncelleme açısından güvenlidir ve temanızı güncellediğinizde üzerine yazılmaz.
Alternatif Yöntem 2: Backdrop'ın "Add to Head" Modülünü Kullanma
Topluluk tarafından sağlanan "Add to Head" modülü, kod düzenlemeden komut dosyası enjekte etmenin kolay bir yolunu sunar:
- Backdrop CMS web sitesinden "Add to Head" topluluk modülünü indirin ve yükleyin
- Configuration > Development > Add to Head bölümüne gidin
- Asyntai yerleştirme kodunuzu footer section kısmına ekleyin
- "Yapılandırmayı kaydet"'e tıklayın
İpucu: Tema dosyalarını düzenlememeyi veya özel modüller oluşturmamayı tercih ediyorsanız "Add to Head" modülünü kullanmak en kolay yöntemdir. Enjekte edilen komut dosyalarını yönetmek için basit bir yönetici arayüzü sağlar.
Alternatif Yöntem 3: Blok Sistemini Kullanma
Backdrop CMS'nin düzen ve blok sistemi de chatbot eklemek için kullanılabilir:
- Backdrop CMS yönetici panelinize giriş yapın
- Yapı > Düzenler bölümüne gidin
- Düzenlemek istediğiniz düzeni seçin (örneğin, varsayılan düzen)
- Altbilgi bölgesinde "Blok ekle"'ye tıklayın
- "Özel blok"'u seçin
- Blok biçimini "Tam HTML" veya "Ham HTML" olarak ayarlayın
- Asyntai yerleştirme kodunuzu blok gövdesine yapıştırın
- Bloğa bir başlık verin (örneğin, "Asyntai Chatbot") ve isteğe bağlı olarak "Başlığı gizle"'yi işaretleyin
- "Bloğu kaydet"'e ve ardından "Düzeni kaydet"'e tıklayın
Önemli: Script etiketinin kaldırılmaması için metin biçiminin "Tam HTML" veya "Ham HTML" olarak ayarlandığından emin olun. Varsayılan "Filtrelenmiş HTML" biçimi, güvenlik nedeniyle script etiketlerini kaldırır.
Adım 3: Önbelleği Temizleyin ve Doğrulayın
Değişikliklerinizi yaptıktan sonra Backdrop CMS önbelleğini temizleyin ve kurulumu doğrulayın:
- Yönetici panelinizde Yapılandırma > Performans bölümüne gidin
- "Tüm önbellekleri temizle"'ye tıklayın
- Web sitenizi yeni bir tarayıcı sekmesinde veya gizli pencerede açın
- Sağ alt köşede sohbet widget'ı düğmesini görmeniz gerekir
- Düzgün açıldığından ve çalıştığından emin olmak için tıklayın
Widget'ı göremiyor musunuz? Backdrop CMS önbelleğini Yapılandırma > Performans bölümünden temizlediğinizden emin olun. Sitenizi gizli pencerede görüntülemeyi veya tarayıcı önbelleğinizi temizlemeyi deneyin. JavaScript hataları olup olmadığını kontrol etmek için tarayıcı konsolunu (F12) açın. Özel modül yöntemini kullandıysanız, modülün İşlevsellik altında etkinleştirildiğini doğrulayın.
Weebly