Asyntai AI Chatbot'u Bagisto'ya Nasıl Eklersiniz

Bagisto e-ticaret platformu 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: Blade Düzen Şablonuna Ekleyin (Önerilen)

Bagisto, Laravel Blade şablonları kullanır. Önerilen yaklaşım, yerleştirme kodunu doğrudan mağaza düzen dosyasına eklemektir:

Mağaza düzen dosyasını açın:
- Paket kaynağı: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- Yayınlanmış sürüm: resources/views/vendor/shop/layouts/master.blade.php (görünümleri yayınladıysanız)
Kapanış </body> etiketini bulun
Yerleştirme kodunu @stack('scripts') sonrasına, </body> öncesine ekleyin:

@stack('scripts')
<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
</body>

İpucu: Satıcı görünümlerini yayınladıysanız, resources/views/vendor/shop/ içindeki yayınlanmış sürümü düzenleyin. Aksi takdirde, paket güncellemeleri sırasında değişiklikleri kaybetmemek için önce php artisan vendor:publish --tag=shop-views ile yayınlayın.

Alternatif Yöntem 1: Bir Görünümde @push('scripts') Kullanma

Herhangi bir Blade görünümünde veya bileşeninde, chatbot komut dosyasını enjekte etmek için scripts yığınını kullanabilirsiniz:

@push('scripts')
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
@endpush

Not: Bu yöntem, ana düzen dosyasında @stack('scripts') bulunmasını gerektirir. Bagisto'nun düzeninde varsayılan olarak dahildir.

Alternatif Yöntem 2: Servis Sağlayıcı Kullanma

Komut dosyasını tüm görünümlerde programatik olarak kullanılabilir hale getirmek için bir servis sağlayıcı kullanabilirsiniz. Özel bir servis sağlayıcı oluşturun veya AppServiceProvider kullanın:

public function boot()
{
    view()->composer('shop::layouts.master', function ($view) {
        // The script will be available in the layout
    });
}

Veya script etiketini render eden bir Blade bileşeni oluşturun ve düzeninize dahil edin.

İpucu: Servis sağlayıcı yaklaşımı, chatbot'u yapılandırma değerlerine veya ortam ayarlarına göre koşullu olarak yüklemek istiyorsanız kullanışlıdır.

Alternatif Yöntem 3: Bagisto Olay Sistemini Kullanma

Bagisto, düzende çeşitli noktalarda görünüm olayları tetikler. Chatbot komut dosyasını enjekte etmek için bagisto.shop.layout.body.after olayını dinleyebilirsiniz:

Event::listen('bagisto.shop.layout.body.after', function($viewRenderEventManager) {
    $viewRenderEventManager->addTemplate('shop::partials.asyntai-widget');
});

Ardından yerleştirme kodunuzla packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php (veya yayınlanmış eşdeğeri) konumunda kısmi şablonu oluşturun:

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

Not: Olay sistemi yaklaşımı, değişikliklerinizi modüler tutar ve çekirdek düzen dosyalarından ayrı tutar, böylece Bagisto güncellemeleri sırasında yönetimi kolaylaştırır.

Adım 3: Önbelleği Temizleyin ve Doğrulayın

Yerleştirme kodunu ekledikten sonra, değişikliklerinizin geçerli olmasını sağlamak için uygulama önbelleğini temizleyin:

php artisan cache:clear && php artisan view:clear

Bagisto mağazanızı 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öremiyor musunuz? Hem php artisan cache:clear hem de php artisan view:clear komutlarını çalıştırdığınızdan emin olun. Ayrıca tarayıcı önbelleğinizi temizlemeyi veya gizli pencerede görüntülemeyi deneyin. Paket kaynağını doğrudan düzenlediyseniz, yayınlanmış görünümlerin değişikliklerinizi geçersiz kılmadığını doğrulayın. Yerleştirme kodunuzun kapanış </body> etiketinin öncesine doğru şekilde yerleştirildiğini kontrol edin.