Kirby'e Asyntai AI Chatbot Nasıl Eklenir

Kirby 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: Kirby Snippet'ına Ekleme (Önerilen)

Kirby, yeniden kullanılabilir şablon parçaları için snippet'lar kullanan dosya tabanlı bir PHP CMS'dir. Önerilen yaklaşım, chatbot için özel bir snippet oluşturmaktır:

site/snippets/asyntai-widget.php konumunda yeni bir snippet dosyası oluşturun
Gömme kodunuzu dosyaya yapıştırın:

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

Ardından snippet'i ana şablonunuza (ör. site/templates/default.php) veya düzeninize, kapanış </body> etiketinden hemen önce ekleyin:

<?php snippet('asyntai-widget') ?>
</body>
</html>

İpucu: Paylaşılan bir düzen veya footer snippet kullanıyorsanız, snippet çağrısını oraya ekleyerek her sayfada otomatik olarak görünmesini sağlayabilirsiniz. Örneğin, footer snippet'inize </body> etiketinden hemen önce ekleyin.

Alternatif Yöntem 1: Footer Snippet'ına Ekleme

Kirby siteniz bir footer snippet'ı kullanıyorsa, gömme kodunu doğrudan oraya ekleyebilirsiniz:

site/snippets/footer.php dosyasını açın (yoksa oluşturun)
Kapanış </body> etiketinden önce gömme kodunu ekleyin

    <!-- Footer content -->
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  </body>
</html>

Şablonlarınızın footer snippet'ını dahil ettiğinden emin olun:

<?php snippet('footer') ?>

Not: Footer snippet'ı zaten tüm şablonlarınıza dahil edilmişse, chatbot'u buraya eklemek tek tek şablon dosyalarını değiştirmeden her sayfada görünmesini sağlar.

Alternatif Yöntem 2: Kirby Eklentisi Kullanma

Herhangi bir şablonu değiştirmeden chatbot scriptini her sayfaya otomatik olarak eklemek için bir Kirby eklentisi oluşturabilirsiniz:

site/plugins/asyntai/index.php konumunda eklenti dizinini ve dosyasını oluşturun
Komut dosyasını dinamik olarak enjekte etmek için aşağıdaki kodu ekleyin:

Kirby::plugin('custom/asyntai', [
    'hooks' => [
        'page.render:after' => function ($contentType, $body) {
            $script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
            return str_replace('</body>', $script . '</body>', $body);
        }
    ]
]);

İpucu: Eklenti yaklaşımı, chatbot'un herhangi bir şablon veya snippet dosyasını düzenlemeden her sayfada otomatik olarak yüklenmesini istiyorsanız idealdir. Ayrıca chatbot entegrasyonunuzu modüler ve etkinleştirmesi veya devre dışı bırakması kolay tutar.

Alternatif Yöntem 3: Kirby'nin js() Yardımcısını Kullanma

Kirby, JavaScript dosyalarını yüklemek için yerleşik bir js() yardımcısı sağlar. Bunu şablonunuzda veya snippet'inizde kullanabilirsiniz:

<?= js('https://asyntai.com/static/js/chat-widget.js', ['async' => true, 'data-asyntai-id' => 'YOUR_WIDGET_ID']) ?>

Veya scripti doğrudan şablon PHP dosyanızda </body> etiketinden önce ekleyin:

<?php // site/templates/default.php ?>
<html>
<head>
    <!-- head content -->
</head>
<body>
    <!-- page content -->
    <?php snippet('header') ?>
    <main>
        <?= $page->text()->kirbytext() ?>
    </main>
    <?php snippet('footer') ?>

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

Not: js() yardımcısını kullanıyorsanız, chatbot'un doğru yüklenmesi için şablonunuzun <body> bölümünde yerleştirildiğinden emin olun.

Adım 3: Kurulumu Doğrulayın

Gömme kodunu Kirby sitenize ekledikten sonra, 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? YOUR_WIDGET_ID'yi kontrol panelindeki gerçek widget kimliğinizle değiştirdiğinizden emin olun. Snippet veya eklenti dosyasının doğru dizine kaydedildiğini doğrulayın. Eklenti yöntemini kullanıyorsanız, eklenti dizin yapısının site/plugins/asyntai/index.php olduğundan emin olun. Tarayıcı önbelleğinizi temizleyin veya gizli modda test edin. Hatalar için tarayıcınızın geliştirici konsolunu (F12) kontrol edin.