Как да добавите Asyntai AI чатбот към Bagisto

Ръководство стъпка по стъпка за платформата за електронна търговия Bagisto

Платформа:

Стъпка 1: Вземете вашия код за вграждане

Първо отидете на вашето Табло за управление на Asyntai и превъртете надолу до секцията "Код за вграждане". Копирайте уникалния си код за вграждане, който ще изглежда така:

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

Забележка: Кодът по-горе е само пример. Трябва да копирате собствения си уникален код за вграждане от вашето Табло за управление, тъй като съдържа вашия личен ID на уиджета.

Стъпка 2: Добавяне към Blade шаблон за оформление (Препоръчително)

Bagisto използва Laravel Blade шаблони. Препоръчителният подход е да добавите кода за вграждане директно във файла за оформление на магазина:

Отворете файла за оформление на магазина:
- Източник на пакета: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- Публикувана версия: resources/views/vendor/shop/layouts/master.blade.php (ако сте публикували изгледите)
Намерете затварящия таг </body>
Добавете кода за вграждане точно преди </body>, след @stack('scripts'):

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

Съвет: Ако сте публикували vendor изгледите, редактирайте публикуваната версия в resources/views/vendor/shop/. В противен случай първо ги публикувайте с php artisan vendor:publish --tag=shop-views, за да избегнете загуба на промени при актуализации на пакета.

Алтернативен метод 1: Използване на @push('scripts') в изглед

Във всеки Blade изглед или компонент можете да използвате стека scripts за инжектиране на скрипта на чатбота:

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

Забележка: Този метод изисква @stack('scripts') да присъства в основния файл за оформление. Той е включен по подразбиране в оформлението на Bagisto.

Алтернативен метод 2: Използване на Service Provider

Можете да използвате service provider, за да направите скрипта програмно достъпен във всички изгледи. Създайте персонализиран service provider или използвайте AppServiceProvider:

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

Или създайте Blade компонент, който рендерира тага script, и го включете в оформлението си.

Съвет: Подходът с service provider е полезен, ако искате условно да зареждате чатбота въз основа на конфигурационни стойности или настройки на средата.

Алтернативен метод 3: Използване на системата за събития на Bagisto

Bagisto задейства view събития на различни точки в оформлението. Можете да слушате bagisto.shop.layout.body.after, за да инжектирате скрипта на чатбота:

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

След това създайте частичния шаблон на packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php (или публикувания еквивалент) с вашия код за вграждане:

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

Забележка: Подходът със системата за събития поддържа промените ви модулни и отделни от основните файлове за оформление, което улеснява управлението при надграждане на Bagisto.

Стъпка 3: Изчистване на кеша и проверка

След добавяне на кода за вграждане изчистете кеша на приложението, за да се уверите, че промените ви влизат в сила:

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

Посетете вашия Bagisto магазин в нов таб на браузъра или в прозорец инкогнито. Трябва да видите бутона на чат уиджета в долния десен ъгъл. Натиснете го, за да се уверите, че се отваря и работи правилно.

Не виждате уиджета? Уверете се, че сте изпълнили и php artisan cache:clear, и php artisan view:clear. Също опитайте да изчистите кеша на браузъра или да прегледате в прозорец инкогнито. Ако сте редактирали директно източника на пакета, проверете дали публикувани изгледи не презаписват промените ви. Проверете дали кодът за вграждане е поставен правилно преди затварящия таг </body>.