Asyntai AI Chatbot'u Concrete CMS'e Nasıl Eklersiniz

Concrete CMS (eski adıyla Concrete5) web siteleri için adım adım kılavuz

Platform:

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 Altbilgisine Kod Ekleyin (Önerilen)

Chatbot'u Concrete CMS web sitenizin tüm sayfalarına eklemenin en iyi yolu, temanızın altbilgi dosyasını düzenlemektir:

Concrete CMS kurulumunuza FTP veya Dosya Yöneticisi aracılığıyla erişin
/application/themes/tema_adiniz/ dizinine gidin
footer.php dosyasını (veya eşdeğer altbilgi şablonunu) bulun ve açın
Kapanış </body> etiketini içeren satırı bulun
Asyntai yerleştirme kodunuzu </body> etiketinin hemen öncesine yapıştırın
Dosyayı kaydedin ve yerel olarak düzenliyorsanız sunucunuza geri yükleyin
Concrete CMS önbelleğini temizleyin: Dashboard → System & Settings → Clear Cache

İpucu: Kodu kapanış </body> etiketinin öncesine eklemek, chatbot'un sayfa içeriğinizden 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: HTML Blok (Geliştirici Olmayanlar İçin En Kolay)

Tema dosyalarını düzenlememeyi tercih ediyorsanız, Concrete CMS'nin yerleşik HTML bloğunu kullanabilirsiniz:

Concrete CMS Dashboard'unuza giriş yapın
Chatbot eklemek istediğiniz sayfaya gidin
Sayfayı Düzenle'ye (araç çubuğundaki kalem simgesi) tıklayın
Kodu yerleştirmek istediğiniz alanda Blok Ekle'ye tıklayın
HTML bloğunu arayın ve seçin
Asyntai yerleştirme kodunuzu HTML düzenleyicisine yapıştırın
Bloğu kaydetmek için Ekle'ye tıklayın
Değişiklikleri yayınlamak için Yayınla'ya tıklayın

Not: HTML blok yöntemi, chatbot'u belirli sayfalara eklemek için harikadır. Site genelinde kurulum için HTML bloğunu her sayfaya eklemeniz veya yukarıda açıklanan tema altbilgi yöntemini kullanmanız gerekir. Bloğun görsel yerleşimi chatbot'un nerede görüneceğini etkilemez - yine de sağ alt köşede görünecektir.

Alternatif Yöntem 2: Tema Başlık Dosyası

Site genelinde kurulum için kodu temanızın başlık dosyasına da ekleyebilirsiniz:

Concrete CMS dosyalarınıza FTP veya Dosya Yöneticisi aracılığıyla erişin
/application/themes/tema_adiniz/ dizinine gidin
header.php dosyasını (veya elements/header.php) açın
Kapanış </head> etiketini bulun
Asyntai yerleştirme kodunuzu </head> etiketinin hemen öncesine yapıştırın
Dosyayı kaydedin ve yükleyin
Dashboard'dan önbelleği temizleyin

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

İpucu: Concrete CMS'nin düzgün çalışması için header.php dosyanıza <?php View::element('header_required'); ?> kullanarak gerekli başlık öğelerini eklediğinizden emin olun.

Alternatif Yöntem 3: Özel Şablon (İleri Düzey)

Daha fazla kontrol isteyen geliştiriciler için özel bir sayfa şablonu oluşturabilirsiniz:

/application/themes/tema_adiniz/ dizininde yeni bir sayfa şablonu dosyası oluşturun
Veya mevcut bir şablonu kopyalayın (örneğin, default.php) ve yeniden adlandırın
Asyntai yerleştirme kodunuzu şablon dosyasına </body> öncesine ekleyin
Concrete CMS Dashboard'unda Pages & Themes (Sayfalar ve Temalar) bölümüne gidin
Sayfa Türleri'ne tıklayın
Bu şablonu kullanmak istediğiniz sayfa türünü seçin
Özel şablonunuzu sayfa türüne atayın
Bu sayfa türünü kullanan tüm sayfalar artık chatbot'u içerecektir

Önemli: Değişiklik yapmadan önce tema dosyalarınızı her zaman yedekleyin. Mümkünse değişikliklerinizi önce bir test sitesinde deneyin. Tema dosyalarına yapılan hatalı düzenlemeler sitenizin düzenini veya işlevselliğini bozabilir.

Adım 3: Kurulumu Doğrulayın

Değişikliklerinizi yapıp önbelleği temizledikten sonra 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? Concrete CMS önbelleğini temizlediğinizden emin olun (Dashboard → Sistem ve Ayarlar → Önbelleği Temizle). Sitenizi gizli pencerede görüntülemeyi deneyin. Tüm dosya değişikliklerini kaydedip yüklediğinizi kontrol edin. JavaScript hataları olup olmadığını kontrol etmek için tarayıcı konsolunu (F12) açın.