Πώς να Προσθέσετε το AI Chatbot Asyntai στο TYPO3
Οδηγός βήμα προς βήμα για ιστότοπους TYPO3
Βήμα 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: Χρήση TypoScript footerData (Συνιστάται)
Ο πιο εύκολος τρόπος για να προσθέσετε το chatbot σε όλες τις σελίδες είναι χρησιμοποιώντας το TypoScript footerData:
- Συνδεθείτε στο TYPO3 Backend σας
- Μεταβείτε στο Web → Template
- Επιλέξτε τη ριζική σελίδα σας στο δέντρο σελίδων
- Κάντε κλικ στο «Edit the whole template record» (ή επιλέξτε «Info/Modify» και στη συνέχεια «Setup»)
- Στο πεδίο Setup, προσθέστε τον ακόλουθο κώδικα TypoScript:
page.footerData.99 = TEXT
page.footerData.99.value = <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> - Αντικαταστήστε το
YOUR_WIDGET_IDμε το πραγματικό widget ID από τον πίνακα ελέγχου - Κάντε κλικ στο «Αποθήκευση»
- Εκκαθαρίστε την κρυφή μνήμη του TYPO3: Admin Tools → Maintenance → Flush TYPO3 and PHP Cache
Συμβουλή: Η χρήση του footerData τοποθετεί το script ακριβώς πριν από την ετικέτα κλεισίματος </body>, κάτι που συνιστάται για chat widgets καθώς δεν θα επιβραδύνει τη φόρτωση της σελίδας σας.
Εναλλακτική: Χρήση Site Package (Για Site Packages)
Αν χρησιμοποιείτε ένα site package, μπορείτε να προσθέσετε το script μέσω του αρχείου ρυθμίσεων TypoScript:
- Μεταβείτε στον φάκελο του site package σας:
packages/your_sitepackage/Configuration/TypoScript/ - Ανοίξτε ή δημιουργήστε το αρχείο setup.typoscript
- Προσθέστε τον παρακάτω κώδικα:
page.footerData {
99 = TEXT
99.value = <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>
} - Αντικαταστήστε το
YOUR_WIDGET_IDμε το πραγματικό widget ID σας - Εκκαθαρίστε την κρυφή μνήμη στο backend του TYPO3
Εναλλακτική: Χρήση Fluid Template (FooterAssets)
Για ιστότοπους που χρησιμοποιούν Fluid templates, μπορείτε να χρησιμοποιήσετε την ενότητα FooterAssets:
- Μεταβείτε στο αρχείο Fluid template σας (συνήθως στο
Resources/Private/Templates/) - Προσθέστε μια ενότητα FooterAssets στο layout ή template σας:
<f:section name="FooterAssets">
<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>
</f:section> - Βεβαιωθείτε ότι η διάταξη της σελίδας σας αποδίδει την ενότητα FooterAssets:
<f:render section="FooterAssets" optional="true" /> - Εκκαθαρίστε την κρυφή μνήμη του TYPO3
Σημαντικό: Η λειτουργία FooterAssets απαιτεί TYPO3 v8 ή νεότερη έκδοση. Για παλαιότερες εκδόσεις, χρησιμοποιήστε τη μέθοδο TypoScript footerData.
Εναλλακτική: Χρήση AssetCollector (Για Προγραμματιστές)
Για προγραμματιστές extension, το TYPO3 v10.3+ προσφέρει το AssetCollector API:
- Στον κώδικα PHP σας (π.χ. σε ένα controller ή middleware), εισάγετε το AssetCollector
- Προσθέστε το script με προσαρμοσμένα χαρακτηριστικά:
use TYPO3\CMS\Core\Page\AssetCollector;
$this->assetCollector->addJavaScript(
'asyntai_chatbot',
'https://asyntai.com/static/js/chat-widget.js',
['async' => 'async', 'data-asyntai-id' => 'YOUR_WIDGET_ID']
);
Βήμα 3: Επαληθεύστε την Εγκατάσταση
Αφού αποθηκεύσετε τις αλλαγές σας και εκκαθαρίσετε τη μνήμη cache, επισκεφθείτε τον ιστότοπό σας σε μια νέα καρτέλα προγράμματος περιήγησης ή σε παράθυρο ανώνυμης περιήγησης. Θα πρέπει να δείτε το κουμπί του widget συνομιλίας στην κάτω δεξιά γωνία. Κάντε κλικ για να βεβαιωθείτε ότι ανοίγει και λειτουργεί σωστά.
Δεν βλέπετε το widget; Βεβαιωθείτε ότι έχετε εκκαθαρίσει όλες τις κρυφές μνήμες: μεταβείτε στο Admin Tools → Maintenance → Flush TYPO3 and PHP Cache. Επίσης δοκιμάστε να εκκαθαρίσετε την κρυφή μνήμη του προγράμματος περιήγησής σας ή να δείτε σε παράθυρο ανώνυμης περιήγησης. Αν χρησιμοποιείτε TypoScript, επαληθεύστε ότι το template σας περιλαμβάνεται σωστά στην ιεραρχία σελίδων.
Weebly