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

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

Πλατφόρμα:

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

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

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

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

Βήμα 2: Προσθήκη Κώδικα στο Κύριο Πρότυπο Σελίδας (Συνιστάται)

Για να προσθέσετε το chatbot σε όλες τις σελίδες του ιστότοπου Kentico ταυτόχρονα, χρησιμοποιήστε τη μέθοδο Κύριου Προτύπου Σελίδας:

Συνδεθείτε στο Kentico Admin και μεταβείτε στην εφαρμογή Πρότυπα σελίδων
Εντοπίστε και ανοίξτε το Κύριο πρότυπο σελίδας (το πρότυπο που χρησιμοποιείται σε όλες τις σελίδες)
Κάντε κλικ στην καρτέλα Κεφαλίδα στον επεξεργαστή προτύπου
Στην ενότητα κεφαλίδας, επικολλήστε τον κώδικα ενσωμάτωσης Asyntai
Εναλλακτικά, προσθέστε τον κώδικα στη διάταξη του προτύπου πριν από την ετικέτα κλεισίματος </head>
Κάντε κλικ στο Αποθήκευση για να εφαρμόσετε τις αλλαγές
Εκκαθαρίστε τη cache του ιστότοπού σας και επαληθεύστε τις αλλαγές στον ζωντανό ιστότοπο

Συμβουλή: Η χρήση του Κύριου Προτύπου Σελίδας διασφαλίζει ότι το chatbot εμφανίζεται σε κάθε σελίδα που κληρονομεί από αυτό το πρότυπο. Αυτή είναι η πιο αποτελεσματική μέθοδος για ανάπτυξη σε ολόκληρο τον ιστότοπο στο Kentico.

Εναλλακτική Μέθοδος 1: Κεφαλίδα Προτύπου Σελίδας

Εάν θέλετε να προσθέσετε το chatbot μόνο σε συγκεκριμένα πρότυπα σελίδων:

Μεταβείτε στην εφαρμογή Πρότυπα σελίδων στο Kentico Admin
Επιλέξτε το συγκεκριμένο πρότυπο σελίδας που θέλετε να επεξεργαστείτε
Κάντε κλικ στην καρτέλα Κεφαλίδα
Προσθέστε τον κώδικα ενσωμάτωσης Asyntai χρησιμοποιώντας ετικέτα script:

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

Κάντε κλικ στο Αποθήκευση
Όλες οι σελίδες που χρησιμοποιούν αυτό το πρότυπο θα περιλαμβάνουν πλέον το chatbot

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

Εναλλακτική Μέθοδος 2: Τμήμα Ιστού HEAD HTML

Για πιο λεπτομερή έλεγχο σε συγκεκριμένες σελίδες ή για κληρονομούμενο JavaScript σε υποσελίδες:

Ανοίξτε τη σελίδα που θέλετε να επεξεργαστείτε στον επεξεργαστή σελίδων Kentico
Προσθέστε ένα νέο τμήμα ιστού στη σελίδα (κατά προτίμηση σε γονική σελίδα για κληρονομιά)
Αναζητήστε και επιλέξτε το τμήμα ιστού HEAD HTML
Στη διαμόρφωση του τμήματος ιστού, επικολλήστε τον κώδικα ενσωμάτωσης Asyntai
Ρυθμίστε το τμήμα ιστού ώστε να είναι κληρονομούμενο εάν θέλετε οι θυγατρικές σελίδες να έχουν το chatbot
Κάντε κλικ στο OK για αποθήκευση του τμήματος ιστού
Αποθηκεύστε και δημοσιεύστε τη σελίδα

Συμβουλή: Το τμήμα ιστού HEAD HTML είναι ιδανικό για την προσθήκη κώδικα σε γονική σελίδα που θα διαδοθεί αυτόματα σε όλες τις θυγατρικές σελίδες, δημιουργώντας εγκατάσταση σε επίπεδο ενότητας.

Εναλλακτική Μέθοδος 3: Προσαρμοσμένα Αρχεία JavaScript (Για Προχωρημένους)

Για προγραμματιστές που προτιμούν τη διαχείριση σεναρίων ως αρχείων:

Στο έργο Kentico, μεταβείτε στον κατάλογο ~/CMSScripts/Custom/
Δημιουργήστε ένα νέο αρχείο JavaScript (π.χ. asyntai-widget.js)
Προσθέστε κώδικα για δυναμική φόρτωση του widget Asyntai:

(function() {
    var script = document.createElement('script');
    script.src = 'https://asyntai.com/static/js/chat-widget.js';
    script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID');
    script.async = true;
    document.head.appendChild(script);
})();

Αναφερθείτε σε αυτό το αρχείο στην κεφαλίδα του Κύριου Προτύπου Σελίδας:

<script src="~/CMSScripts/Custom/asyntai-widget.js"></script>

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

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

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

Δεν βλέπετε το widget; Βεβαιωθείτε ότι έχετε αποθηκεύσει όλες τις αλλαγές και εκκαθαρίσει την κρυφή μνήμη του Kentico (Ρυθμίσεις > Σύστημα > Εκκαθάριση κρυφής μνήμης). Δοκιμάστε να προβάλετε τον ιστότοπο σε παράθυρο ανώνυμης περιήγησης. Ελέγξτε την κονσόλα περιήγητη (F12) για σφάλματα JavaScript που μπορεί να εμποδίζουν τη φόρτωση του widget.