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

Οδηγός βήμα προς βήμα για ιστότοπους OpenCart

Πλατφόρμα:

The Easy Way: Install the Asyntai Extension

We publish a free extension on the OpenCart Marketplace. It puts the chatbot on your storefront and connects your account, and there is no code to copy and no template to edit. It works on OpenCart 3.x and 4.x.

Download Asyntai - AI Chatbot from the OpenCart Marketplace
In your admin panel, go to Extensions → Installer and upload the ZIP file
Go to Extensions → Extensions, choose Modules in the list, find Asyntai AI Chatbot and press the green install button
Press edit, then press Connect to Asyntai. A window opens where you sign in or create an account.

That is all. The chatbot is live on your storefront when the window closes.

Your products, prices and stock

When you connect, the extension also lets Asyntai read your catalogue. Your assistant then answers with the price you charge today and tells shoppers what is in stock, instead of repeating whatever your pages said when they were last read.

Asyntai reads your products through a read-only address on your own store. Every request is signed, and the reply carries the prices a shopper would actually pay, with your tax rules already applied. You can switch this off at any time on the extension's settings screen.

Updating from version 1.0.0? OpenCart clears a module's settings when you uninstall it, so press Connect to Asyntai once after the update. From this version on, updates keep your connection.

Or Add the Code Yourself

Prefer not to install an extension? The rest of this page shows how to add the chatbot by hand. You will not get the catalogue reading this way.

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

First, go to your Asyntai Dashboard and scroll down to the "Embed Code" section. Copy your unique embed code which will look like this:

<script>(function(){var l=function(){var s=document.createElement("script");s.src="https://widget.asyntai.com/static/js/chat-widget.js";s.async=true;s.setAttribute("data-asyntai-id","YOUR_WIDGET_ID");document.head.appendChild(s)};if(document.readyState==="complete"){l()}else{window.addEventListener("load",l)}})();</script>

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

Step 2: Edit Footer Template

Ο πιο απλός τρόπος για να προσθέσετε το chatbot είναι επεξεργαζόμενοι το πρότυπο υποσέλιδου του θέματός σας:

Αποκτήστε πρόσβαση στα αρχεία OpenCart σας μέσω FTP ή διαχειριστή αρχείων
Μεταβείτε στο πρότυπο υποσέλιδου του θέματός σας:
- OpenCart 3.x/4.x: catalog/view/theme/YOUR_THEME/template/common/footer.twig
- OpenCart 2.x: catalog/view/theme/YOUR_THEME/template/common/footer.tpl
Ανοίξτε το αρχείο υποσέλιδου για επεξεργασία
Βρείτε την ετικέτα κλεισίματος </body>
Επικολλήστε τον κωδικό ενσωμάτωσης Asyntai ακριβώς πριν από την ετικέτα </body>
Αποθηκεύστε το αρχείο
Εκκαθαρίστε την κρυφή μνήμη OpenCart: Dashboard → Μπλε εικονίδιο γρανάζι (επάνω δεξιά) → Refresh ή διαγράψτε τα περιεχόμενα του system/storage/cache/

Συμβουλή: Αν χρησιμοποιείτε το προεπιλεγμένο θέμα, η διαδρομή θα είναι catalog/view/theme/default/template/common/footer.twig. Να δημιουργείτε πάντα αντίγραφο ασφαλείας πριν επεξεργαστείτε αρχεία προτύπων.

Εναλλακτικά: Χρήση Επιλογής Προσαρμοσμένου Κώδικα του Θέματος

Πολλά σύγχρονα θέματα OpenCart περιλαμβάνουν μια ενσωματωμένη επιλογή για προσαρμοσμένο κώδικα:

Συνδεθείτε στον Πίνακα Διαχείρισης OpenCart
Μεταβείτε στο Extensions → Themes (ή Extensions → Extensions → Themes)
Κάντε κλικ στο Επεξεργασία στο ενεργό θέμα σας
Αναζητήστε μια ενότητα «Custom Code», «Footer Scripts» ή «Custom JavaScript»
Επικολλήστε τον κωδικό ενσωμάτωσης Asyntai
Κάντε κλικ στο «Αποθήκευση»
Εκκαθαρίστε την κρυφή μνήμη

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

Εναλλακτικά: Χρήση Επέκτασης Προσαρμοσμένου Κώδικα

Μπορείτε να εγκαταστήσετε μια δωρεάν επέκταση από το OpenCart Marketplace για να προσθέσετε προσαρμοσμένα σενάρια:

Go to the OpenCart Marketplace
Αναζητήστε «Custom Script», «Header Footer Scripts» ή «Custom Code»
Κατεβάστε και εγκαταστήστε μια κατάλληλη επέκταση
Στον πίνακα διαχείρισής σας, μεταβείτε στο Extensions → Extensions → Modules
Βρείτε και εγκαταστήστε την ενότητα προσαρμοσμένου κώδικα
Ρυθμίστε την ενότητα και επικολλήστε τον κώδικα ενσωμάτωσης Asyntai στην ενότητα υποσέλιδου
Αποθηκεύστε και εκκαθαρίστε την κρυφή μνήμη

Σημαντικό: Η χρήση επεκτάσεων συνιστάται αντί της επεξεργασίας βασικών αρχείων, καθώς επιβιώνουν των ενημερώσεων OpenCart. Δημοφιλείς επεκτάσεις περιλαμβάνουν το «Custom Script in Header & Footer» που είναι διαθέσιμο στο marketplace.

Εναλλακτικά: Χρήση Μεθόδου addScript (Για Προγραμματιστές)

Για προγραμματιστές, το OpenCart 3.x/4.x παρέχει έναν προγραμματικό τρόπο για προσθήκη σεναρίων:

Ανοίξτε το catalog/controller/common/footer.php
Προσθέστε την παρακάτω γραμμή πριν το $data['scripts'] = $this->document->getScripts('footer');:
$this->document->addScript('https://asyntai.com/static/js/chat-widget.js', 'footer');
Για το χαρακτηριστικό data, θα χρειαστεί να τροποποιήσετε το footer.twig για να το συμπεριλάβετε χειροκίνητα, ή να προσθέσετε inline JavaScript μετά τον βρόχο σεναρίων

Σημείωση: Για να λειτουργεί σωστά η γραφική εφαρμογή με το χαρακτηριστικό data, η μέθοδος προτύπου είναι πιο απλή καθώς η μέθοδος addScript δεν υποστηρίζει προσαρμοσμένα χαρακτηριστικά άμεσα.

Βήμα 3: Επαληθεύστε την Εγκατάσταση

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

Δεν βλέπετε το widget; Βεβαιωθείτε ότι εκκαθαρίζετε την κρυφή μνήμη του OpenCart. Μεταβείτε στον πίνακα διαχείρισής σας, κάντε κλικ στο μπλε εικονίδιο γρανάζι στην επάνω δεξιά γωνία και κάντε κλικ στα κουμπιά ανανέωσης. Δοκιμάστε επίσης να εκκαθαρίσετε την κρυφή μνήμη του προγράμματος περιήγησης ή να δείτε σε παράθυρο ανώνυμης περιήγησης. Αν τροποποιήσατε λάθος αρχείο προτύπου, ελέγξτε ότι το θέμα σας χρησιμοποιεί το αρχείο που επεξεργαστήκατε.

Τεκμηρίωση