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

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

Πλατφόρμα:

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

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

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

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

Βήμα 2: Προσθήκη στο Πρότυπο MODX (Συνιστάται)

Ο συνιστώμενος τρόπος για να προσθέσετε το chatbot είναι επεξεργαζόμενοι το Πρότυπο MODX απευθείας στο MODX Manager:

Συνδεθείτε στο MODX Manager (πίνακας διαχείρισης)
Στην αριστερή πλευρική εργαλειοθήκη, μεταβείτε στο Elements > Templates
Ανοίξτε το πρότυπο του ιστοτόπου σας (συνήθως ονομάζεται «BaseTemplate» ή το ενεργό πρότυπό σας)
Βρείτε την ετικέτα κλεισίματος </body> στον κώδικα του προτύπου
Επικολλήστε τον κώδικα ενσωμάτωσης Asyntai ακριβώς πριν την ετικέτα κλεισίματος </body>
Κάντε κλικ στο «Αποθήκευση» για να αποθηκεύσετε το πρότυπο

<!-- Your existing template content -->

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

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

Εναλλακτική Μέθοδος 1: Χρήση MODX Chunk

Μπορείτε να χρησιμοποιήσετε ένα MODX Chunk για να κρατήσετε τον κώδικα ενσωμάτωσης χωριστά και επαναχρησιμοποιήσιμο:

Στο MODX Manager, μεταβείτε στο Elements > Chunks
Κάντε κλικ στο «New Chunk» για να δημιουργήσετε ένα νέο chunk
Ονομάστε το chunk «asyntaiWidget»
Επικολλήστε τον κώδικα ενσωμάτωσης Asyntai στην περιοχή περιεχομένου chunk
Κάντε κλικ στο «Αποθήκευση»
Ανοίξτε το πρότυπό σας (στο Elements > Templates)
Προσθέστε την κλήση chunk [[$asyntaiWidget]] ακριβώς πριν την ετικέτα κλεισίματος </body>
Αποθηκεύστε το template

<!-- In your Template, before </body> -->
[[$asyntaiWidget]]
</body>
</html>

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

Εναλλακτική Μέθοδος 2: Χρήση Ρυθμίσεων Συστήματος MODX (HTML Head/Footer)

Ορισμένες ρυθμίσεις MODX περιλαμβάνουν placeholders για σενάρια υποσέλιδου μέσω Ρυθμίσεων Συστήματος:

Στο MODX Manager, μεταβείτε στο System > System Settings
Φιλτράρετε με «htmlhead» ή αναζητήστε μια προσαρμοσμένη ρύθμιση συστήματος για σενάρια υποσέλιδου
Αν η ρύθμισή σας έχει ένα placeholder για σενάρια υποσέλιδου (όπως [[++footer_scripts]]), μπορείτε να το χρησιμοποιήσετε
Ορίστε την τιμή ρύθμισης συστήματος στον κώδικα ενσωμάτωσης Asyntai
Βεβαιωθείτε ότι το αντίστοιχο placeholder [[++footer_scripts]] υπάρχει στο πρότυπό σας πριν την ετικέτα κλεισίματος </body>
Αποθηκεύστε τη ρύθμιση συστήματος

<!-- In your Template, before </body> -->
[[++footer_scripts]]
</body>
</html>

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

Εναλλακτική Μέθοδος 3: Χρήση Plugin MODX (OnWebPagePrerender)

Για μια προηγμένη προσέγγιση, μπορείτε να δημιουργήσετε ένα Plugin MODX που εισάγει αυτόματα τον κώδικα chatbot σε κάθε σελίδα:

Στο MODX Manager, μεταβείτε στο Elements > Plugins
Κάντε κλικ στο "New Plugin" για να δημιουργήσετε ένα νέο plugin
Ονομάστε το plugin «AsyntaiChatbot»
Επικολλήστε τον παρακάτω κώδικα PHP στην περιοχή κώδικα plugin:

$output = &$modx->resource->_output;
$script = '<script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>';
$output = str_replace('</body>', $script . '</body>', $output);

Κάντε κλικ στην καρτέλα «System Events»
Επιλέξτε το πλαίσιο δίπλα στο «OnWebPagePrerender» για να ενεργοποιείτε αυτό το plugin σε αυτό το γεγονός
Κάντε κλικ στο «Αποθήκευση»

Σημαντικό: Αντικαταστήστε το YOUR_WIDGET_ID με το πραγματικό ID γραφικής εφαρμογής σας από το Asyntai Dashboard. Αυτό το plugin θα εισάγει αυτόματα το σενάριο chatbot σε κάθε σελίδα στον ιστότοπο MODX σας πριν αυτή αποδοθεί.

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

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

Στο MODX Manager, μεταβείτε στο Manage > Clear Cache (ή κάντε κλικ στο εικονίδιο εκκαθάρισης κρυφής μνήμης στο επάνω μενού)
Ανοίξτε τον ιστότοπό σας σε μια νέα καρτέλα προγράμματος περιήγησης ή παράθυρο ανώνυμης περιήγησης
Θα πρέπει να δείτε το κουμπί της γραφικής εφαρμογής συνομιλίας στην κάτω δεξιά γωνία της σελίδας σας
Κάντε κλικ πάνω του για να βεβαιωθείτε ότι ανοίγει και λειτουργεί σωστά

Δεν βλέπετε το widget; Βεβαιωθείτε ότι εκκαθαρίσατε την κρυφή μνήμη MODX από το Manage > Clear Cache στο MODX Manager. Δοκιμάστε επίσης να εκκαθαρίσετε την κρυφή μνήμη του προγράμματος περιήγησης ή να δείτε τον ιστότοπο σε παράθυρο ανώνυμης περιήγησης. Αν χρησιμοποιήσατε τη μέθοδο Plugin, επαληθεύστε ότι το γεγονός συστήματος «OnWebPagePrerender» είναι επιλεγμένο για το plugin σας.