Come aggiungere il chatbot IA Asyntai a Bagisto

Guida passo passo per la piattaforma e-commerce Bagisto

Piattaforma:

Passaggio 1: ottieni il tuo codice di incorporamento

Per prima cosa, vai alla tua Dashboard Asyntai e scorri fino alla sezione "Codice di incorporamento". Copia il tuo codice di incorporamento univoco che apparirà così:

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

Nota: Il codice sopra è solo un esempio. Devi copiare il tuo codice di incorporamento univoco dalla tua Dashboard poiché contiene il tuo ID widget personale.

Passaggio 2: Aggiungi al template di layout Blade (consigliato)

Bagisto utilizza i template Laravel Blade. L'approccio consigliato è aggiungere il codice di incorporamento direttamente al file di layout dello shop:

Apri il file di layout dello shop:
- Sorgente del pacchetto: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- Versione pubblicata: resources/views/vendor/shop/layouts/master.blade.php (se hai pubblicato le viste)
Trova il tag di chiusura </body>
Aggiungi il codice di incorporamento appena prima di </body>, dopo @stack('scripts'):

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

Suggerimento: Se hai pubblicato le viste del vendor, modifica la versione pubblicata in resources/views/vendor/shop/. Altrimenti, pubblicale prima con php artisan vendor:publish --tag=shop-views per evitare di perdere le modifiche durante gli aggiornamenti del pacchetto.

Metodo alternativo 1: Utilizzo di @push('scripts') in una vista

In qualsiasi vista o componente Blade, puoi utilizzare lo stack degli script per iniettare lo script del chatbot:

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

Nota: Questo metodo richiede che @stack('scripts') sia presente nel file di layout principale. È incluso per impostazione predefinita nel layout di Bagisto.

Metodo alternativo 2: Utilizzo di un Service Provider

Puoi utilizzare un service provider per rendere lo script disponibile in tutte le viste in modo programmatico. Crea un service provider personalizzato o usa AppServiceProvider:

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

Oppure crea un componente Blade che renderizza il tag script e includilo nel tuo layout.

Suggerimento: L'approccio tramite service provider è utile se vuoi caricare il chatbot in modo condizionale in base ai valori di configurazione o alle impostazioni dell'ambiente.

Metodo alternativo 3: Utilizzo del sistema di eventi di Bagisto

Bagisto emette eventi di vista in vari punti del layout. Puoi ascoltare bagisto.shop.layout.body.after per iniettare lo script del chatbot:

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

Quindi crea il template parziale in packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php (o l'equivalente pubblicato) con il tuo codice di incorporamento:

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

Nota: L'approccio tramite sistema di eventi mantiene le modifiche modulari e separate dai file di layout principali, facilitando la gestione durante gli aggiornamenti di Bagisto.

Passaggio 3: Svuota la cache e verifica

Dopo aver aggiunto il codice di incorporamento, svuota la cache dell'applicazione per assicurarti che le modifiche abbiano effetto:

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

Visita il tuo negozio Bagisto in una nuova scheda del browser o in una finestra di navigazione in incognito. Dovresti vedere il pulsante del widget di chat nell'angolo in basso a destra. Cliccaci sopra per assicurarti che si apra e funzioni correttamente.

Non vedi il widget? Assicurati di aver eseguito sia php artisan cache:clear che php artisan view:clear. Prova anche a svuotare la cache del browser o a visualizzare in una finestra di navigazione in incognito. Se hai modificato direttamente il sorgente del pacchetto, verifica che nessuna vista pubblicata stia sovrascrivendo le tue modifiche. Controlla che il codice di incorporamento sia posizionato correttamente prima del tag di chiusura </body>.