Sådan tilføjer du Asyntai AI-chatbot til Bagisto

Trin-for-trin-vejledning til Bagisto e-handelsplatformen

Platform:

Trin 1: Hent din indlejringskode

Gå først til dit Asyntai Dashboard og rul ned til sektionen "Indlejringskode". Kopiér din unikke indlejringskode, der vil se sådan ud:

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

Bemærk: Koden ovenfor er blot et eksempel. Du skal kopiere din egen unikke indlejringskode fra dit Dashboard, da den indeholder dit personlige widget-ID.

Trin 2: Tilføj til Blade-layoutskabelon (anbefalet)

Bagisto bruger Laravel Blade-skabeloner. Den anbefalede tilgang er at tilføje indlejringskoden direkte til butikkens layoutfil:

Åbn butikkens layoutfil:
- Pakkekilde: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- Publiceret version: resources/views/vendor/shop/layouts/master.blade.php (hvis du har publiceret views)
Find det afsluttende </body>-tag
Tilføj indlejringskoden lige inden </body>, efter @stack('scripts'):

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

Tip: Hvis du har publiceret vendor-views, skal du redigere den publicerede version i resources/views/vendor/shop/. Ellers skal du publicere dem først med php artisan vendor:publish --tag=shop-views for at undgå at miste ændringer under pakkeopdateringer.

Alternativ metode 1: Brug af @push('scripts') i et view

I ethvert Blade-view eller -komponent kan du bruge scripts-stakken til at injicere chatbot-scriptet:

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

Bemærk: Denne metode kræver, at @stack('scripts') er til stede i masterlayoutfilen. Det er inkluderet som standard i Bagistos layout.

Alternativ metode 2: Brug af en service provider

Du kan bruge en service provider til at gøre scriptet tilgængeligt på tværs af alle views programmatisk. Opret en brugerdefineret service provider eller brug AppServiceProvider:

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

Eller opret en Blade-komponent, der gengiver script-tagget, og inkluder det i dit layout.

Tip: Service provider-tilgangen er nyttig, hvis du vil indlæse chatbotten betinget baseret på konfigurationsværdier eller miljøindstillinger.

Alternativ metode 3: Brug af Bagistos hændelsessystem

Bagisto udløser view-hændelser på forskellige punkter i layoutet. Du kan lytte til bagisto.shop.layout.body.after for at injicere chatbot-scriptet:

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

Opret derefter den delvise skabelon på packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php (eller den publicerede ækvivalent) med din indlejringskode:

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

Bemærk: Hændelsessystem-tilgangen holder dine ændringer modulære og adskilt fra kerneLayoutfilerne, hvilket gør det nemmere at håndtere under Bagisto-opgraderinger.

Trin 3: Ryd cache og verificér

Når du har tilføjet indlejringskoden, skal du rydde applikationens cache for at sikre, at dine ændringer træder i kraft:

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

Besøg din Bagisto-butik i en ny browserfane eller et inkognitovindue. Du bør se chat-widget-knappen i nederste højre hjørne. Klik på den for at sikre, at den åbner og fungerer korrekt.

Ser du ikke widget'en? Sørg for, at du kørte både php artisan cache:clear og php artisan view:clear. Prøv også at rydde din browsers cache eller se i et inkognitovindue. Hvis du redigerede pakkekilden direkte, skal du verificere, at ingen publicerede views tilsidesætter dine ændringer. Tjek, at din indlejringskode er placeret korrekt inden det afsluttende </body>-tag.