Asyntai AI -chatbotin lisääminen Bagistoon

Vaiheittainen opas Bagisto-verkkokauppa-alustalle

Alusta:

Vaihe 1: Hanki upotuskoodisi

Siirry ensin Asyntai-hallintapaneeliin ja vieritä alas "Upotuskoodi"-osioon. Kopioi yksilöllinen upotuskoodisi, joka näyttää tältä:

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

Huomautus: Yllä oleva koodi on vain esimerkki. Sinun on kopioitava oma yksilöllinen upotuskoodisi Hallintapaneelistasi, sillä se sisältää henkilökohtaisen widget-tunnuksesi.

Vaihe 2: Lisää Blade-asettelumalliin (Suositeltu)

Bagisto käyttää Laravel Blade -malleja. Suositeltu tapa on lisätä upotuskoodi suoraan kaupan asettelutiedostoon:

Avaa kaupan asettelutiedosto:
- Paketin lähde: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- Julkaistu versio: resources/views/vendor/shop/layouts/master.blade.php (jos olet julkaissut näkymät)
Etsi sulkeva </body>-tagi
Lisää upotuskoodi juuri ennen </body>-tagia, @stack('scripts')-kohdan jälkeen:

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

Vinkki: Jos olet julkaissut vendor-näkymät, muokkaa julkaistua versiota kohdassa resources/views/vendor/shop/. Muussa tapauksessa julkaise ne ensin komennolla php artisan vendor:publish --tag=shop-views, jotta muutokset eivät katoa pakettipäivitysten yhteydessä.

Vaihtoehtoinen tapa 1: @push('scripts') -direktiivin käyttö näkymässä

Missä tahansa Blade-näkymässä tai -komponentissa voit käyttää scripts-pinoa chatbot-skriptin lisäämiseen:

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

Huomautus: Tämä menetelmä edellyttää, että @stack('scripts') on master-asettelutiedostossa. Se sisältyy oletuksena Bagiston asetteluun.

Vaihtoehtoinen tapa 2: Service Providerin käyttö

Voit käyttää service provideria skriptin saatavuuden tarjoamiseen kaikissa näkymissä ohjelmallisesti. Luo mukautettu service provider tai käytä AppServiceProvider:a:

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

Tai luo Blade-komponentti, joka renderöi script-tagin, ja sisällytä se asetteluusi.

Vinkki: Service provider -lähestymistapa on hyödyllinen, jos haluat ladata chatbotin ehdollisesti konfiguraatioarvojen tai ympäristöasetusten perusteella.

Vaihtoehtoinen tapa 3: Bagiston tapahtumajärjestelmän käyttö

Bagisto laukaisee näkymätapahtumia asettelun eri kohdissa. Voit kuunnella bagisto.shop.layout.body.after-tapahtumaa chatbot-skriptin lisäämiseksi:

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

Luo sitten osittaismalli kohtaan packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php (tai julkaistu vastine) upotuskoodillasi:

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

Huomautus: Tapahtumajärjestelmä pitää muutoksesi modulaarisina ja erillään ydinrakenteen asettelutiedostoista, mikä helpottaa hallintaa Bagisto-päivitysten yhteydessä.

Vaihe 3: Tyhjennä välimuisti ja vahvista

Upotuskoodin lisäämisen jälkeen tyhjennä sovelluksen välimuisti varmistaaksesi, että muutokset tulevat voimaan:

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

Käy Bagisto-kaupassasi uudessa selainvälilehdessä tai incognito-ikkunassa. Chat-widget-painikkeen pitäisi näkyä oikeassa alakulmassa. Napsauta sitä varmistaaksesi, että se avautuu ja toimii oikein.

Etkö näe widgetiä? Varmista, että suoritit sekä php artisan cache:clear että php artisan view:clear. Kokeile myös tyhjentää selaimen välimuisti tai tarkastella incognito-ikkunassa. Jos muokkasit paketin lähdekoodia suoraan, varmista ettei julkaistut näkymät yliaja muutoksiasi. Tarkista, että upotuskoodi on sijoitettu oikein ennen sulkevaa </body>-tagia.