Ako pridat Asyntai AI chatbota do Bagisto

Návod krok za krokom pre e-commerce platformu Bagisto

Platforma:

Krok 1: Získajte svoj vkladací kód

Najprv prejdite na svoj Asyntai Dashboard a prejdite nadol k sekcii „Vkladací kód“. Skopírujte svoj jedinečný vkladací kód, ktorý bude vyzerať takto:

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

Poznámka: Kód vyššie je len príklad. Musíte skopírovať svoj vlastný jedinečný vkladací kód zo svojho Dashboardu, pretože obsahuje vaše osobné ID widgetu.

Krok 2: Pridanie do šablóny rozloženia Blade (odporúčané)

Bagisto používa šablóny Laravel Blade. Odporúčaný prístup je pridať vkladací kód priamo do súboru rozloženia obchodu:

Otvorte súbor rozloženia obchodu:
- Zdroj balíka: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- Publikovaná verzia: resources/views/vendor/shop/layouts/master.blade.php (ak ste publikovali zobrazenia)
Nájdite uzatvárací tag </body>
Pridajte vkladací kód tesne pred </body>, za @stack('scripts'):

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

Tip: Ak ste publikovali zobrazenia dodávateľa, upravte publikovanú verziu v resources/views/vendor/shop/. V opačnom prípade ich najprv publikujte pomocou php artisan vendor:publish --tag=shop-views, aby ste predišli strate zmien počas aktualizácií balíkov.

Alternatívna metóda 1: Použitie @push('scripts') v zobrazení

V akomkoľvek zobrazení alebo komponente Blade môžete použiť zásobník skriptov na vloženie skriptu chatbota:

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

Poznámka: Táto metóda vyžaduje, aby bolo @stack('scripts') prítomné v hlavnom súbore rozloženia. V rozložení Bagisto je zahrnuté štandardne.

Alternatívna metóda 2: Použitie poskytovateľa služieb

Môžete použiť poskytovateľa služieb na programatické sprístupnenie skriptu vo všetkých zobrazeniach. Vytvorte vlastného poskytovateľa služieb alebo použite AppServiceProvider:

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

Alebo vytvorte komponent Blade, ktory vykresli tag skriptu a zahrnte ho do svojho rozloženia.

Tip: Prístup s poskytovateľom služieb je užitočný, ak chcete podmienečne načítať chatbota na základe konfiguračných hodnôt alebo nastavení prostredia.

Alternatívna metóda 3: Použitie systému udalostí Bagisto

Bagisto spúšťa udalosti zobrazenia na rôznych miestach v rozložení. Môžete počúvať bagisto.shop.layout.body.after na vloženie skriptu chatbota:

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

Potom vytvorte čiastočnú šablónu v packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php (alebo publikovaný ekvivalent) s vaším vkladacím kódom:

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

Poznámka: Prístup so systémom udalostí udržuje vaše zmeny modulárne a oddelené od základných súborov rozloženia, čo uľahčuje správu počas aktualizácií Bagisto.

Krok 3: Vymazanie vyrovnávacej pamäte a overenie

Po pridaní vkladacieho kódu vymažte vyrovnávaciu pamäť aplikácie, aby sa vaše zmeny prejavili:

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

Navštívte svoj obchod Bagisto v novej karte prehliadača alebo v okne inkognito. Mali by ste vidieť tlačidlo chatového widgetu v pravom dolnom rohu. Kliknite naň, aby ste sa uistili, že sa otvára a funguje správne.

Nevidíte widget? Uistite sa, že ste spustili php artisan cache:clear aj php artisan view:clear. Tiež skúste vyčistiť vyrovnávaciu pamäť prehliadača alebo zobraziť web v okne inkognito. Ak ste priamo upravili zdrojový kód balíka, overte, že žiadne publikované zobrazenia neprepísali vaše zmeny. Skontrolujte, že je váš vkladací kód správne umiestnený pred uzatváracím tagom </body>.