So fügen Sie den Asyntai-KI-Chatbot zu Bagisto hinzu

Schritt-für-Schritt-Anleitung für die Bagisto E-Commerce-Plattform

Plattform:

Schritt 1: Ihren Einbettungscode erhalten

Gehen Sie zunächst zu Ihrem Asyntai Dashboard und scrollen Sie zum Abschnitt "Einbettungscode". Kopieren Sie Ihren einzigartigen Einbettungscode, der so aussieht:

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

Hinweis: Der obige Code ist nur ein Beispiel. Sie müssen Ihren eigenen einzigartigen Einbettungscode von Ihrem Dashboard kopieren, da er Ihre persönliche Widget-ID enthält.

Schritt 2: Zum Blade-Layout-Template hinzufügen (Empfohlen)

Bagisto verwendet Laravel Blade Templates. Der empfohlene Ansatz ist, den Einbettungscode direkt zur Shop-Layout-Datei hinzuzufügen:

Öffnen Sie die Shop-Layout-Datei:
- Paketquelle: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- Veröffentlichte Version: resources/views/vendor/shop/layouts/master.blade.php (falls Sie die Views veröffentlicht haben)
Suchen Sie das schließende </body>-Tag
Fügen Sie den Einbettungscode direkt vor </body> ein, nach @stack('scripts'):

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

Tipp: Wenn Sie die Vendor-Views veröffentlicht haben, bearbeiten Sie die veröffentlichte Version in resources/views/vendor/shop/. Andernfalls veröffentlichen Sie sie zuerst mit php artisan vendor:publish --tag=shop-views, um Änderungen bei Paket-Updates nicht zu verlieren.

Alternative Methode 1: Verwendung von @push('scripts') in einer View

In jeder Blade-View oder Komponente können Sie den Scripts-Stack verwenden, um das Chatbot-Skript einzufügen:

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

Hinweis: Diese Methode erfordert, dass @stack('scripts') in der Master-Layout-Datei vorhanden ist. Es ist standardmäßig in Bagistos Layout enthalten.

Alternative Methode 2: Verwendung eines Service Providers

Sie können einen Service Provider verwenden, um das Skript programmatisch in allen Views verfügbar zu machen. Erstellen Sie einen benutzerdefinierten Service Provider oder verwenden Sie AppServiceProvider:

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

Oder erstellen Sie eine Blade-Komponente, die das Script-Tag rendert, und binden Sie sie in Ihr Layout ein.

Tipp: Der Service-Provider-Ansatz ist nützlich, wenn Sie den Chatbot bedingt basierend auf Konfigurationswerten oder Umgebungseinstellungen laden möchten.

Alternative Methode 3: Verwendung des Bagisto Event-Systems

Bagisto löst View-Events an verschiedenen Stellen im Layout aus. Sie können auf bagisto.shop.layout.body.after lauschen, um das Chatbot-Skript einzufügen:

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

Erstellen Sie dann das Partial-Template unter packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php (oder dem veröffentlichten Äquivalent) mit Ihrem Einbettungscode:

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

Hinweis: Der Event-System-Ansatz hält Ihre Änderungen modular und getrennt von den Kern-Layout-Dateien, was die Verwaltung bei Bagisto-Upgrades erleichtert.

Schritt 3: Cache leeren und überprüfen

Nachdem Sie den Einbettungscode hinzugefügt haben, leeren Sie den Anwendungs-Cache, um sicherzustellen, dass Ihre Änderungen wirksam werden:

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

Besuchen Sie Ihren Bagisto-Shop in einem neuen Browser-Tab oder Inkognito-Fenster. Sie sollten den Chat-Widget-Button in der unteren rechten Ecke sehen. Klicken Sie darauf, um sicherzustellen, dass er sich öffnet und korrekt funktioniert.

Widget nicht sichtbar? Stellen Sie sicher, dass Sie sowohl php artisan cache:clear als auch php artisan view:clear ausgeführt haben. Versuchen Sie auch, Ihren Browser-Cache zu leeren oder in einem Inkognito-Fenster anzuzeigen. Wenn Sie die Paketquelle direkt bearbeitet haben, überprüfen Sie, dass keine veröffentlichten Views Ihre Änderungen überschreiben. Prüfen Sie, ob Ihr Einbettungscode korrekt vor dem schließenden </body>-Tag platziert ist.