Επιστροφή στον Πίνακα Ελέγχου

Τεκμηρίωση

Μάθετε πώς να χρησιμοποιείτε το Asyntai

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

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

Λήψη Κώδικα Ενσωμάτωσης

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

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

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

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

Βήμα 2: Επεξεργαστείτε το Πρότυπο Διάταξης (Συνιστάται)

Ο ευκολότερος τρόπος για να προσθέσετε το chatbot σε όλες τις σελίδες είναι να επεξεργαστείτε το κύριο πρότυπο διάταξης:

  1. Access your Craft CMS project files via FTP, SSH, or your code editor
  2. Μεταβείτε στον κατάλογο templates/
  3. Βρείτε το κύριο αρχείο διάταξης (συνήθως ονομάζεται _layout.twig, _layout.html, ή βρίσκεται στο templates/_layouts/)
  4. Βρείτε την ετικέτα κλεισίματος </body>
  5. Επικολλήστε τον κωδικό ενσωμάτωσης Asyntai ακριβώς πριν από την ετικέτα </body>
  6. Αποθηκεύστε το αρχείο

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

Alternative: Using Twig {% js %} Tag (Craft CMS 3.x+)

Craft CMS provides a built-in Twig tag for registering JavaScript:

  1. Ανοίξτε το κύριο πρότυπο διάταξης
  2. Προσθέστε τον παρακάτω κώδικα πριν την ετικέτα κλεισίματος </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 %}
  3. Replace YOUR_WIDGET_ID with your actual widget ID
  4. Αποθηκεύστε το αρχείο

Σημείωση: The {% js %} tag automatically handles script registration and prevents duplicate loading if the same code appears multiple times.

Εναλλακτικά: Δημιουργήστε Ξεχωριστό Αρχείο Συμπερίληψης

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

  1. Δημιουργήστε ένα νέο αρχείο: templates/_includes/chatbot.twig.html)
  2. Προσθέστε τον κώδικα ενσωμάτωσης Asyntai σε αυτό το αρχείο:
    <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script>
  3. Στο κύριο πρότυπο διάταξης, συμπεριλάβετε αυτό το αρχείο πριν το </body>:
    {% include '_includes/chatbot' %}
  4. Αποθηκεύστε και τα δύο αρχεία

Συμβουλή: Η χρήση ενός αρχείου συμπερίληψης διευκολύνει την ενεργοποίηση/απενεργοποίηση του chatbot σε ολόκληρο τον ιστότοπό σας με σχολιασμό μίας μόνο γραμμής.

Εναλλακτικά: Υπό Συνθήκη Φόρτωση

Για να φορτώσετε το chatbot μόνο σε συγκεκριμένες σελίδες ή ενότητες:

  1. Στο πρότυπο διάταξης ή σελίδας, χρησιμοποιήστε συνθήκες Twig:
    {% if entry.showChatbot ?? true %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}
  2. Ή ελέγξτε για συγκεκριμένες ενότητες:
    {% if craft.app.request.segments[0] != 'admin' %} <script async src="https://asyntai.com/static/js/chat-widget.js" data-asyntai-id="YOUR_WIDGET_ID"></script> {% endif %}

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

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

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

Τοποθεσία Προτύπου: Οι τοποθεσίες προτύπων Craft CMS μπορεί να ποικίλλουν ανάλογα με τη ρύθμιση του έργου σας. Συνήθεις τοποθεσίες περιλαμβάνουν templates/_layout.twig, templates/_layouts/main.twig, ή templates/_base.twig. Ελέγξτε τα υπάρχοντα πρότυπα για να βρείτε πού ορίζεται η ετικέτα </body>.