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

Craft 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 Şablonunuzu Düzenleyin (Önerilen)

Chatbot'u tüm sayfalara eklemenin en kolay yolu ana düzen şablonunuzu düzenlemektir:

Access your Craft CMS project files via FTP, SSH, or your code editor
templates/ dizinine gidin
Ana düzen dosyanızı bulun (genellikle _layout.twig, _layout.html adıyla veya templates/_layouts/ konumunda)
Kapanış </body> etiketini bulun
Asyntai yerleştirme kodunuzu </body> etiketinin hemen öncesine yapıştırın
Dosyayı kaydedin

İpucu: Komut dosyasını kapanış </body> etiketinin öncesine eklemek, sayfa içeriğinden sonra yüklenmesini sağlar; bu, sohbet widget'ları için önerilir ve sayfa yüklemenizi yavaşlatmaz.

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS, JavaScript kaydetmek için yerleşik bir Twig etiketi sağlar:

Ana düzen şablonunuzu açın
Kapanış </body> etiketinin öncesine aşağıdaki kodu ekleyin:
{% js %} (function() { var script = document.createElement('script'); script.async = true; script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); document.body.appendChild(script); })(); {% endjs %}
Replace YOUR_WIDGET_ID with your actual widget ID
Dosyayı kaydedin

Not: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Alternatif: Ayrı Bir Include Dosyası Oluşturun

Daha iyi organizasyon için özel bir include dosyası oluşturun:

Yeni bir dosya oluşturun: templates/_includes/chatbot.twig (veya .html)
Asyntai yerleştirme kodunuzu bu dosyaya ekleyin:
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
Ana düzen şablonunuzda bu dosyayı </body> öncesine dahil edin:
{% include '_includes/chatbot' %}
Her iki dosyayı da kaydedin

İpucu: Bir include dosyası kullanmak, tek bir satırı yorum satırına alarak chatbot'u tüm sitenizde etkinleştirmeyi/devre dışı bırakmayı kolaylaştırır.

Alternatif: Koşullu Yükleme

Chatbot'u yalnızca belirli sayfalarda veya bölümlerde yüklemek için:

Düzen veya sayfa şablonunuzda Twig koşullarını kullanın:
{% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
Veya belirli bölümleri kontrol edin:
{% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}

Adım 3: Kurulumu Doğrulayın

Değişikliklerinizi kaydettikten sonra Craft CMS web sitenizi yeni bir tarayıcı sekmesinde veya gizli pencerede ziyaret edin. 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öremiyorsunuz mu? Şablon dosyasını kaydettiğinizden ve sayfalarınızın kullandığı doğru düzen şablonunu düzenlediğinizden emin olun. Tarayıcı önbelleğinizi temizleyin veya gizli pencerede görüntüleyin. Şablon önbellekleme kullanıyorsanız, Kontrol Paneli'nde Yardımcı Programlar > Önbellekleri Temizle bölümünden Craft CMS önbelleğini temizleyin.

Şablon Konumu: Craft CMS şablon konumları proje kurulumunuza göre değişebilir. Yaygın konumlar arasında templates/_layout.twig, templates/_layouts/main.twig veya templates/_base.twig bulunur. </body> etiketinin nerede tanımlandığını bulmak için mevcut şablonlarınızı kontrol edin.