Πώς να Προσθέσετε το AI Chatbot Asyntai στο Craft CMS
Οδηγός βήμα προς βήμα για ιστότοπους Craft CMS
Βήμα 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.
Βήμα 2: Επεξεργαστείτε το Πρότυπο Διάταξης (Συνιστάται)
Ο ευκολότερος τρόπος για να προσθέσετε το chatbot σε όλες τις σελίδες είναι να επεξεργαστείτε το κύριο πρότυπο διάταξης:
- Αποκτήστε πρόσβαση στα αρχεία έργου Craft CMS μέσω FTP, SSH ή του επεξεργαστή κώδικα
- Μεταβείτε στον κατάλογο
templates/ - Βρείτε το κύριο αρχείο διάταξης (συνήθως ονομάζεται
_layout.twig,_layout.html, ή βρίσκεται στοtemplates/_layouts/) - Βρείτε την ετικέτα κλεισίματος
</body> - Επικολλήστε τον κωδικό ενσωμάτωσης Asyntai ακριβώς πριν από την ετικέτα
</body> - Αποθηκεύστε το αρχείο
Συμβουλή: Η προσθήκη του script πριν την ετικέτα κλεισίματος </body> διασφαλίζει ότι φορτώνει μετά το περιεχόμενο της σελίδας, κάτι που συνιστάται για chat widgets και δεν θα επιβραδύνει τη φόρτωση της σελίδας.
Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)
Το Craft CMS παρέχει ενσωματωμένο Twig tag για εγγραφή JavaScript:
- Ανοίξτε το κύριο πρότυπο διάταξης
- Προσθέστε τον παρακάτω κώδικα πριν την ετικέτα κλεισίματος
</body>:{% js %} (function() { var script = document.createElement('script'); script.async = true; script.src = 'https://asyntai.com/static/js/chat-widget.js'; script.setAttribute('data-asyntai-id', 'YOUR_WIDGET_ID'); document.body.appendChild(script); })(); {% endjs %} - Αντικαταστήστε το
YOUR_WIDGET_IDμε το πραγματικό widget ID σας - Αποθηκεύστε το αρχείο
Σημείωση: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.
Εναλλακτικά: Δημιουργήστε Ξεχωριστό Αρχείο Συμπερίληψης
Για καλύτερη οργάνωση, δημιουργήστε ένα αποκλειστικό αρχείο συμπερίληψης:
- Δημιουργήστε ένα νέο αρχείο:
templates/_includes/chatbot.twig(ή.html) - Προσθέστε τον κώδικα ενσωμάτωσης Asyntai σε αυτό το αρχείο:
<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> - Στο κύριο πρότυπο διάταξης, συμπεριλάβετε αυτό το αρχείο πριν το
</body>:{% include '_includes/chatbot' %} - Αποθηκεύστε και τα δύο αρχεία
Συμβουλή: Η χρήση ενός αρχείου συμπερίληψης διευκολύνει την ενεργοποίηση/απενεργοποίηση του chatbot σε ολόκληρο τον ιστότοπό σας με σχολιασμό μίας μόνο γραμμής.
Εναλλακτικά: Υπό Συνθήκη Φόρτωση
Για να φορτώσετε το chatbot μόνο σε συγκεκριμένες σελίδες ή ενότητες:
- Στο πρότυπο διάταξης ή σελίδας, χρησιμοποιήστε συνθήκες Twig:
{% if entry.showChatbot ?? true %} <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> {% endif %} - Ή ελέγξτε για συγκεκριμένες ενότητες:
{% if craft.app.request.segments[0] != 'admin' %} <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> {% endif %}
Βήμα 3: Επαληθεύστε την Εγκατάσταση
Αφού αποθηκεύσετε τις αλλαγές, επισκεφθείτε τον ιστότοπό σας Craft CMS σε μια νέα καρτέλα του προγράμματος περιήγησης ή σε παράθυρο ανώνυμης περιήγησης. Θα πρέπει να δείτε το κουμπί του chat widget στην κάτω δεξιά γωνία. Κάντε κλικ για να βεβαιωθείτε ότι ανοίγει και λειτουργεί σωστά.
Δεν βλέπετε το widget; Βεβαιωθείτε ότι αποθηκεύσατε το αρχείο προτύπου και ότι επεξεργάζεστε το σωστό πρότυπο διάταξης που χρησιμοποιούν οι σελίδες σας. Εκκαθαρίστε την κρυφή μνήμη του προγράμματος περιήγησης ή δείτε σε παράθυρο ανώνυμης περιήγησης. Εάν χρησιμοποιείτε κρυφή μνήμη προτύπων, εκκαθαρίστε την κρυφή μνήμη Craft CMS από τον Πίνακα Ελέγχου στα Βοηθητικά Προγράμματα > Εκκαθάριση Κρυφής Μνήμης.
Τοποθεσία Προτύπου: Οι τοποθεσίες προτύπων Craft CMS μπορεί να ποικίλλουν ανάλογα με τη ρύθμιση του έργου σας. Συνήθεις τοποθεσίες περιλαμβάνουν templates/_layout.twig, templates/_layouts/main.twig, ή templates/_base.twig. Ελέγξτε τα υπάρχοντα πρότυπα για να βρείτε πού ορίζεται η ετικέτα </body>.
Weebly