Az Asyntai AI Chatbot hozzáadása a Bagistóhoz

Lépésről lépésre útmutató a Bagisto e-kereskedelmi platformhoz

Platform:

1. lépés: Szerezze be a beágyazási kódját

Először lépjen az Asyntai Irányítópultra és görgessen le a „Beágyazási kód" szekcióhoz. Másolja le az egyedi beágyazási kódját, amely így fog kinézni:

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

Megjegyzés: A fenti kód csak egy példa. Le kell másolnia saját egyedi beágyazási kódját az Irányítópultról, mivel az tartalmazza személyes widget-azonosítóját.

2. lépés: Hozzáadás a Blade elrendezési sablonhoz (ajánlott)

A Bagisto Laravel Blade sablonokat használ. Az ajánlott megközelítés az, hogy a beágyazási kódot közvetlenül a bolt elrendezési fájljához adja hozzá:

Nyissa meg a bolt elrendezési fájlját:
- Csomag forrása: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- Publikált verzió: resources/views/vendor/shop/layouts/master.blade.php (ha közzétette a nézeteket)
Keresse meg a záró </body> taget
Adja hozzá a beágyazási kódot közvetlenül a </body> elé, a @stack('scripts') után:

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

Tipp: Ha közzétette a vendor nézeteket, szerkessze a közzétett verziót a resources/views/vendor/shop/ mappában. Ellenkező esetben először tegye közzé azokat a php artisan vendor:publish --tag=shop-views paranccsal, hogy elkerülje a változtatások elvesztését a csomag-frissítések során.

1. alternatív módszer: A @push('scripts') használata egy nézetben

Bármely Blade nézetben vagy komponensben a scripts verem segítségével injektálhatja a chatbot scriptet:

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

Megjegyzés: Ez a módszer megköveteli, hogy a @stack('scripts') jelen legyen a master elrendezési fájlban. Alapértelmezés szerint szerepel a Bagisto elrendezésében.

2. alternatív módszer: Service Provider használata

Egy Service Provider segítségével programozottan teheti elérhetővé a scriptet az összes nézetben. Hozzon létre egy egyéni Service Providert, vagy használja az AppServiceProvider-t:

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

Vagy hozzon létre egy Blade komponenst, amely rendereli a script taget, és illessze be az elrendezésbe.

Tipp: A Service Provider megközelítés akkor hasznos, ha a chatbotot feltételesen szeretné betölteni konfigurációs értékek vagy környezeti beállítások alapján.

3. alternatív módszer: A Bagisto eseményrendszerének használata

A Bagisto nézet-eseményeket indít az elrendezés különböző pontjain. A chatbot script injektálásához figyelheti a bagisto.shop.layout.body.after eseményt:

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

Ezután hozza létre a részleges sablont a packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php helyen (vagy a közzétett megfelelőjén) a beágyazási kóddal:

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

Megjegyzés: Az eseményrendszer megközelítése modulárissá és a fő elrendezési fájloktól elkülönítve tartja a változtatásait, ami megkönnyíti a kezelést a Bagisto frissítései során.

3. lépés: Gyorsítótár törlése és ellenőrzés

A beágyazási kód hozzáadása után törölje az alkalmazás gyorsítótárát, hogy a változtatások érvénybe lépjenek:

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

Látogassa meg a Bagisto áruházát egy új böngészőlapon vagy inkognító ablakban. Látnia kell a chat widget gombot a jobb alsó sarokban. Kattintson rá, hogy meggyőződjön arról, hogy megfelelően nyílik meg és működik.

Nem látja a widgetet? Győződjön meg arról, hogy mindkét parancsot lefuttatta: php artisan cache:clear és php artisan view:clear. Próbálja meg törölni a böngésző gyorsítótárát is, vagy tekintse meg inkognító ablakban. Ha közvetlenül a csomag forrását szerkesztette, ellenőrizze, hogy egyetlen közzétett nézet sem írja felül a módosításait. Ellenőrizze, hogy a beágyazási kód helyesen van-e elhelyezve a záró </body> tag előtt.