October CMS'e Asyntai AI Chatbot Nasıl Eklenir

October CMS 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: Düzen Şablonuna Ekleme (Önerilen)

Chatbot'u eklemenin önerilen yolu, October CMS arka ucunda varsayılan düzeninizi düzenlemektir:

October CMS arka ucunuza giriş yapın
Ana menüde CMS > Layouts bölümüne gidin
Varsayılan düzeninizi açın (genellikle default.htm)
Kapanış etiketini bulun </body> etiketi ve {% scripts %} yer tutucusu
Asyntai gömme kodunuzu hemen öncesine ekleyin {% scripts %} ve </body>:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% scripts %} </body>
Değişiklikleri uygulamak için Save düğmesine tıklayın

İpucu: Placing the script before {% scripts %} and </body> ensures it loads after the page content, which is recommended for chat widgets and won't slow down your page loading.

Alternative Method 1: Using {% put scripts %} Block

Chatbot'u bir sayfa veya partial'dan enjekte etmek için October CMS scripts yer tutucusunu kullanabilirsiniz:

CMS düzenleyicisinde herhangi bir sayfa veya partial açın
Aşağıdaki kodu kullanarak ekleyin {% put scripts %} blok:
{% put scripts %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endput %}
YOUR_WIDGET_ID kısmını dashboard'daki gerçek widget kimliğinizle değiştirin
"Kaydet"'e tıklayın

Not: For this method to work, your layout must include the {% scripts %} placeholder in its markup. This is where October CMS renders all injected scripts. Most default layouts already include this tag.

Alternatif Yöntem 2: Component PHP Kullanma

Programatik bir yaklaşımı tercih ediyorsanız, chatbot scriptini özel bir bileşen aracılığıyla ekleyebilirsiniz:

October CMS eklentinizde bir bileşen oluşturun veya değiştirin
Bileşenin onRun() yönteminde addJs() yöntemini kullanın:
public function onRun() { $this->addJs('https://asyntai.com/static/js/chat-widget.js', [ 'async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID' ]); }
YOUR_WIDGET_ID kısmını gerçek widget kimliğinizle değiştirin
Chatbot'un görünmesini istediğiniz sayfalarda bileşeni kaydedin

İpucu: Bileşen kullanmak, chatbot'un ne zaman ve nerede yükleneceği üzerinde programatik kontrol sağlar. Kullanıcı rolleri, sayfa türleri veya diğer kriterlere göre yüklemeyi kontrol etmek için onRun() içine koşullu mantık ekleyebilirsiniz.

Alternatif Yöntem 3: Partial Kullanma

Chatbot widget'ı için yeniden kullanılabilir bir partial oluşturabilirsiniz:

October CMS arka ucunda CMS > Partials bölümüne gidin
Yeni bir partial oluşturmak için \"+ Add\" düğmesine tıklayın
asyntai-widget.htm olarak adlandırın
Asyntai gömme kodunuzu partial'a ekleyin:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
"Kaydet"'e tıklayın
Düzen şablonunuzu açın ve partial'ı </body> etiketinden önce ekleyin:
{% partial 'asyntai-widget' %}
Düzeni kaydedin

İpucu: Partial kullanmak, düzeninizden partial dahil etmeyi ekleyerek veya kaldırarak chatbot'u tüm sitenizde etkinleştirmeyi veya devre dışı bırakmayı kolaylaştırır.

Adım 3: Kurulumu Doğrulayın

Değişikliklerinizi kaydettikten sonra, October CMS web sitenizi yeni bir tarayıcı sekmesinde veya gizli pencerede ziyaret edin. Sağ alt köşede sohbet widget düğmesini görmelisiniz. Doğru şekilde açıldığından ve çalıştığından emin olmak için üzerine tıklayın.

Widget'ı göremiyor musunuz? CMS arka ucunda tüm değişiklikleri kaydettiğinizden emin olun. Tarayıcı önbelleğinizi temizleyin veya gizli pencerede görüntüleyin. Siteniz önbellekleme kullanıyorsa, komut satırından php artisan cache:clear çalıştırarak veya arka uçtaki Settings > System > Clear Cache seçeneğini kullanarak October CMS önbelleğini temizleyin.

Düzen Seçimi: Chatbot'un görünmesini istediğiniz sayfaların doğru düzeni kullandığından emin olun. Bir sayfanın hangi düzeni kullandığını, CMS > Pages bölümünde sayfayı açıp sayfa ayarlarındaki Layout açılır menüsüne bakarak kontrol edebilirsiniz.