Πώς να Προσθέσετε το AI Chatbot του Asyntai στο Bagisto

Οδηγός βήμα προς βήμα για την πλατφόρμα ηλεκτρονικού εμπορίου Bagisto

Πλατφόρμα:

Βήμα 1: Αποκτήστε τον Κωδικό Ενσωμάτωσής σας

Πρώτα, μεταβείτε στον Πίνακα Ελέγχου Asyntai και κάντε κύλιση προς τα κάτω στην ενότητα «Κωδικός Ενσωμάτωσης». Αντιγράψτε τον μοναδικό κωδικό ενσωμάτωσής σας που θα μοιάζει ως εξής:

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

Σημείωση: Ο παραπάνω κώδικας είναι απλώς ένα παράδειγμα. Πρέπει να αντιγράψετε τον δικό σας μοναδικό κωδικό ενσωμάτωσης από τον Πίνακα Ελέγχου σας, καθώς περιέχει το προσωπικό σας αναγνωριστικό widget.

Βήμα 2: Προσθήκη στο Πρότυπο Διάταξης Blade (Προτεινόμενο)

Το Bagisto χρησιμοποιεί πρότυπα Laravel Blade. Η προτεινόμενη προσέγγιση είναι να προσθέσετε τον κωδικό ενσωμάτωσης απευθείας στο αρχείο διάταξης καταστήματος:

Ανοίξτε το αρχείο διάταξης καταστήματος:
- Πηγή πακέτου: packages/Webkul/Shop/src/Resources/views/layouts/master.blade.php
- Δημοσιευμένη έκδοση: resources/views/vendor/shop/layouts/master.blade.php (εάν έχετε δημοσιεύσει τις προβολές)
Βρείτε την ετικέτα κλεισίματος </body>
Προσθέστε τον κωδικό ενσωμάτωσης ακριβώς πριν από </body>, μετά από @stack('scripts'):

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

Συμβουλή: Εάν έχετε δημοσιεύσει τις προβολές vendor, επεξεργαστείτε τη δημοσιευμένη έκδοση στο resources/views/vendor/shop/. Διαφορετικά, δημοσιεύστε τις πρώτα με php artisan vendor:publish --tag=shop-views για να αποφύγετε την απώλεια αλλαγών κατά τις ενημερώσεις πακέτων.

Εναλλακτική Μέθοδος 1: Χρήση @push('scripts') σε Προβολή

Σε οποιαδήποτε προβολή ή στοιχείο Blade, μπορείτε να χρησιμοποιήσετε τη στοίβα scripts για να εισάγετε το σενάριο chatbot:

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

Σημείωση: Αυτή η μέθοδος απαιτεί η @stack('scripts') να υπάρχει στο αρχείο κύριας διάταξης. Συμπεριλαμβάνεται εξ ορισμού στη διάταξη του Bagisto.

Εναλλακτική Μέθοδος 2: Χρήση Παρόχου Υπηρεσιών

Μπορείτε να χρησιμοποιήσετε έναν πάροχο υπηρεσιών για να κάνετε το σενάριο διαθέσιμο σε όλες τις προβολές μέσω προγραμματισμού. Δημιουργήστε έναν προσαρμοσμένο πάροχο υπηρεσιών ή χρησιμοποιήστε AppServiceProvider:

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

Ή δημιουργήστε ένα στοιχείο Blade που αποδίδει την ετικέτα script και συμπεριλάβετέ το στη διάταξή σας.

Συμβουλή: Η προσέγγιση παρόχου υπηρεσιών είναι χρήσιμη εάν θέλετε να φορτώνετε το chatbot υπό συνθήκες βάσει τιμών διαμόρφωσης ή ρυθμίσεων περιβάλλοντος.

Εναλλακτική Μέθοδος 3: Χρήση Συστήματος Συμβάντων Bagisto

Το Bagisto ενεργοποιεί συμβάντα προβολής σε διάφορα σημεία της διάταξης. Μπορείτε να ακούτε για bagisto.shop.layout.body.after για να εισάγετε το σενάριο chatbot:

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

Στη συνέχεια δημιουργήστε το μερικό πρότυπο στο packages/Webkul/Shop/src/Resources/views/partials/asyntai-widget.blade.php (ή το αντίστοιχο δημοσιευμένο) με τον κωδικό ενσωμάτωσής σας:

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

Σημείωση: Η προσέγγιση συστήματος συμβάντων διατηρεί τις αλλαγές σας αρθρωτές και ξεχωριστές από τα βασικά αρχεία διάταξης, καθιστώντας τη διαχείριση ευκολότερη κατά τις αναβαθμίσεις Bagisto.

Βήμα 3: Εκκαθάριση Προσωρινής Μνήμης και Επαλήθευση

Αφού προσθέσετε τον κωδικό ενσωμάτωσης, εκκαθαρίστε την προσωρινή μνήμη εφαρμογής για να διασφαλίσετε ότι οι αλλαγές σας τίθενται σε ισχύ:

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

Επισκεφθείτε το κατάστημά σας Bagisto σε μια νέα καρτέλα προγράμματος περιήγησης ή παράθυρο ανώνυμης περιήγησης. Θα πρέπει να δείτε το κουμπί chat widget στην κάτω δεξιά γωνία. Κάντε κλικ σε αυτό για να βεβαιωθείτε ότι ανοίγει και λειτουργεί σωστά.

Δεν βλέπετε το widget; Βεβαιωθείτε ότι εκτελέσατε και τις php artisan cache:clear και php artisan view:clear. Επίσης δοκιμάστε να εκκαθαρίσετε την προσωρινή μνήμη του προγράμματος περιήγησης ή να δείτε σε παράθυρο ανώνυμης περιήγησης. Εάν επεξεργαστήκατε την πηγή πακέτου απευθείας, επαληθεύστε ότι καμία δημοσιευμένη προβολή δεν υπερισχύει των αλλαγών σας. Ελέγξτε ότι ο κωδικός ενσωμάτωσής σας τοποθετείται σωστά πριν από την ετικέτα κλεισίματος </body>.