Προσαρμογές και Διαμόρφωση
Πλαίσιο
Εδώ θα βρείτε εκτενή τεκμηρίωση για κάθε μία από τις λειτουργίες και τις ρυθμίσεις που υποστηρίζει το widget σχολίων.
Αυτή η τεκμηρίωση θα καλύψει βασικές έννοιες και θα εμβαθύνει σε κάθε περιοχή λειτουργικότητας, με οδηγίες βήμα‑βήμα και συνηθισμένες παγίδες.
Θα δοθούν παραδείγματα κώδικα, με τις σχετικές γραμμές επισημασμένες. Θα παρέχονται στιγμιότυπα οθόνης των σελίδων διαμόρφωσης όπου εφαρμόζεται.
Τα παραδείγματα κώδικα θα χρησιμοποιούν τη βασική βιβλιοθήκη JavaScript μας, ωστόσο οι επιλογές διαμόρφωσης χρησιμοποιούν ακριβώς τα ίδια ονόματα για όλες τις εκδόσεις του widget σχολίων (React, Vue κ.λπ.).
Οι περισσότερες ρυθμίσεις και λειτουργίες που περιγράφονται σε αυτόν τον οδηγό δεν απαιτούν τη συγγραφή κώδικα.
Ταυτοποίηση του λογαριασμού σας 
Ίσως παρατηρήσετε ότι το widget σχολίων μπορεί να χρησιμοποιηθεί με Tenant ID "demo", για παράδειγμα:
Run 
Αυτό προορίζεται μόνο για δοκιμή και για να πειραματιστείτε με το widget σχολίων. Σε παραγωγή, θα περάσετε το Tenant ID σας, ως εξής:
Run Το Tenant ID σας μπορεί να βρεθεί ήδη εφαρμοσμένο στο απόσπασμα κώδικα στον λογαριασμό σας.
Μπορείτε επίσης να βρείτε το Tenant ID σας και να διαχειριστείτε τα API keys στη σελίδα διαπιστευτηρίων API.
Από αυτό το σημείο και μετά, εάν είστε συνδεδεμένοι στο FastComments, τα παραδείγματα κώδικα θα χρησιμοποιούν το πραγματικό σας Tenant ID (εάν είστε συνδεδεμένοι στο https://fastcomments.com).
Πώς συνδέονται τα σχόλια με σελίδες και άρθρα
Κατά την απόδοση μιας συνομιλίας σχολίων, ή όταν αφήνετε ένα σχόλιο, το FastComments πρέπει να γνωρίζει σε ποια σελίδα, άρθρο ή προϊόν ανήκουν αυτά τα σχόλια.
Για να το κάνουμε αυτό, χρησιμοποιούμε κάτι που ονομάζουμε "URL ID". Είναι είτε ένας αναγνωριστής, όπως μια συμβολοσειρά ή ένας αριθμός, είτε ένα URL.
Από προεπιλογή, αν δεν καθορίσετε το urlId, θα γίνει το URL της σελίδας. Θα πάρουμε το τρέχον URL της σελίδας και θα το καθαρίσουμε για να αφαιρέσουμε οποιαδήποτε κοινά marketing parameters ή αναγνωριστικά παρακολούθησης.
Σε περιπτώσεις ενσωματώσεων τρίτων, όπως το WordPress, το πρόσθετό μας θα χρησιμοποιεί συνήθως τον αναγνωριστή που αντιπροσωπεύει την τρέχουσα πληροφορία που προβάλλεται ως το URL ID, για παράδειγμα το id του άρθρου/σελίδας.
Run Κάτι που θα αναφέρουμε συχνά σε αυτό το έγγραφο είναι η Διεπαφή Προσαρμογής Widget.
Αυτή η διεπαφή μπορεί να χρησιμοποιηθεί για να κάνετε πολλές αλλαγές στο widget σχολίων χωρίς να χρησιμοποιήσετε κώδικα.
Κατά τη δημιουργία ενός κανόνα προσαρμογής, συχνά θέλουμε να εφαρμόζεται σε όλες τις σελίδες του ιστότοπού μας. Ωστόσο, σε ορισμένες περιπτώσεις θέλουμε να προσαρμόσουμε το widget σχολίων σε μια συγκεκριμένη σελίδα, είτε για να εφαρμόσουμε προσαρμοσμένο στυλ, είτε ίσως να κάνουμε τα σχόλια για εκείνη τη σελίδα ανώνυμα. Θα μπορούσατε επίσης, για παράδειγμα, να έχετε ζωντανά σχόλια να εμφανίζονται αμέσως σε ορισμένες σελίδες, ενώ να τα κρύβετε κάτω από κουμπιά ειδοποίησης σε άλλες.
Αυτό είναι δυνατό μέσω του πεδίου εισαγωγής URL ID σε αυτήν τη σελίδα, το οποίο εμφανίζεται ως εξής:
Η τιμή σε αυτό το πεδίο πρέπει να ταιριάζει με την παράμετρο urlId που περνιέται στο widget σχολίων. Εάν θέλετε ο κανόνας προσαρμογής σας να είναι ανεξάρτητος από το urlId, αφήστε αυτό το πεδίο κενό ή εισάγετε *.
Από το 2023 το URL ID πεδίο στην προσαρμογή widget πλέον δέχεται και μοτίβα! Για παράδειγμα μπορείτε
να έχετε */blog/* για να προσθέσετε στυλ συγκεκριμένα στο blog σας και */store/* για να έχετε στυλ συγκεκριμένα στο κατάστημά σας,
όλα ενώ χρησιμοποιείτε το ίδιο domain.
Σημεία προσοχής
- Αν η σελίδα σας έχει hash παραμέτρους (όπως example.com#page-1) - αυτό θα γίνει μέρος του URL ID, εξ ορισμού.
- Κατά τη διάρκεια μεταναστεύσεων, για παράδειγμα από WordPress σε Gatsby, ίσως χρειαστεί να μεταφέρετε τις τιμές σχολίων URL ID μετά την αρχική μετανάστευση. Για αυτό, επικοινωνήστε μαζί μας.
Εμφάνιση των ίδιων σχολίων σε διαφορετικές σελίδες
Δεδομένου ότι η παράμετρος urlId μας επιτρέπει να ορίσουμε σε ποια σελίδα, ή id, συνδέονται τα σχόλια, μπορούμε απλώς να θέσουμε την urlId στην ίδια τιμή σε αυτές τις σελίδες.
Run Προσαρμοσμένο στυλ
Το FastComments έχει σχεδιαστεί για να προσαρμόζεται. Το widget σχολιασμού εκτελείται μέσα σε ένα iframe για λόγους ασφαλείας, οπότε για να εφαρμόσετε προσαρμοσμένο στυλ πρέπει να ακολουθήσετε μία από δύο προσεγγίσεις.
The first, the easiest approach, and preferred by us, is to use the widget customization page.
In the widget customization page, see the "Show Advanced Options" section, under which there is an area labeled "Custom CSS":
This approach has some benefits:
- Το CSS που εισάγεται συμπιέζεται (minified) πριν αποσταλεί στον χρήστη, και η μορφοποίηση διατηρείται συνεπής στο περιβάλλον επεξεργασίας.
- Έχετε όλα τα πλεονεκτήματα του UI προσαρμογής του widget, για παράδειγμα εύκολη εξατομίκευση του widget σχολιασμού διαφορετικά για διαφορετικούς ιστότοπους.
- Όταν κάνουμε αλλαγές στο widget σχολιασμού, το προσαρμοσμένο στυλ σας θα δοκιμάζεται ως μέρος της διαδικασίας κυκλοφορίας μας.
The second approach is to specify the customCSS parameter in the widget configuration, as follows:
Run However, this has limitations:
- Υπάρχει ένα όριο στην ποσότητα του custom CSS που μπορεί να αποσταλεί προτού οι διακομιστές μας απορρίψουν το αίτημα, λόγω του μεγέθους των headers.
- Πρέπει να διαχειριστείτε το custom CSS στην υποδομή και το σύστημα build σας. Αυτό μπορεί να είναι πλεονέκτημα και όχι μειονέκτημα.
- Υπάρχει επιπλέον κόστος αποστολής του custom CSS μέσω δικτύου δύο φορές σε αυτήν την περίπτωση, καθώς πρέπει να σταλεί στους διακομιστές μας και στη συνέχεια να επιστραφεί στο περιεχόμενο του iframe. Ωστόσο, για τα περισσότερα μεγέθη φορτίου, αυτό δεν είναι αισθητό.
- Μια συνηθισμένη βελτιστοποίηση είναι η συμπίεση (minifying) του CSS για μείωση του μεγέθους του στο δίκτυο, ωστόσο με αυτήν την προσέγγιση θα πρέπει να το αναλάβετε εσείς.
- Το προσαρμοσμένο CSS σας δεν θα δοκιμάζεται όταν κάνουμε αλλαγές.
External CSS Files
You can tell the widget to fetch an external file by using @import!
It's recommended to put the @import in a customization rule. This way, if we ever need to make a change to the comment widget, we can use our automation
tooling to verify your setup. So for example, you would create a customization rule in the Widget Customization UI, click Advanced, and enter in Custom CSS:
@import url(https://example.com/styles.css);In Code - Not Recommended
You can also load an external CSS file via the customCSS property:
Run However, remember that your CSS won't be able to be tested by us if you do this.
User Profile Modal Styling
User profile modals can also be styled with custom CSS. However, to ensure that custom styling is applied to user profiles, all CSS selectors must be prefixed with .user-profile. Without this prefix, custom styling will be ignored for user profile modals.
For example:
Run Backwards Compatibility
At FastComments, we know our customers customize the commenting widget. That's by design - the last thing we want is for our product to cause design inconsistencies in your product.
Since this is an important part of our product, we have a build pipeline that allows us to review changes to the comment widget, per-customer, each release.
If we find minor issues, we will update your account to ensure our release goes smoothly. If we see major breaking changes, this allows us to halt the release.
Προσαρμοσμένες γραμματοσειρές
Το FastComments έχει σχεδιαστεί ώστε να προσαρμόζεται, και η γραμματοσειρά που χρησιμοποιούν τα widget μας δεν αποτελεί εξαίρεση.
Από προεπιλογή, το FastComments χρησιμοποιεί το system font stack για να εμφανίζεται όσο το δυνατόν καλύτερα σε ένα ευρύ φάσμα συσκευών.
Για να ορίσετε τις δικές σας γραμματοσειρές, δείτε την Τεκμηρίωση Custom CSS.
Εκεί θα βρείτε έναν τρόπο να ορίσετε προσαρμοσμένο CSS, που θα σας επιτρέψει να καθορίσετε τις επιθυμητές γραμματοσειρές.
Πώς να Ορίσετε τη Γραμματοσειρά
Για να παρακάμψετε τη γραμματοσειρά, προτείνουμε να ορίσετε το CSS σας χρησιμοποιώντας τους selectors .fast-comments, textarea. Για παράδειγμα:
Run Αφαίρεση επωνυμίας
Για πελάτες με λογαριασμούς Pro ή Enterprise, επιτρέπεται το white labeling. Απλά επικοινωνήστε μαζί μας και θα χαρούμε να βοηθήσουμε.
Αν απλώς θέλετε να αφαιρέσετε το λογότυπό μας από το widget σχολίων, αυτό ενεργοποιείται αυτόματα στα πλάνα Flex και Pro.
Αυτά τα πλάνα παρέχουν επίσης την ίδια λειτουργικότητα για τα email που αποστέλλονται από την πλατφόρμα μας.
Υποστήριξη σκοτεινών φόντων (σκοτεινή λειτουργία)
Εξ ορισμού, το widget σχολίων FastComments θα ανιχνεύει αυτόματα τη σκοτεινή λειτουργία στις περισσότερες ιστοσελίδες.
Όταν εντοπιστεί η σκοτεινή λειτουργία, το FastComments θα αλλάξει από μαύρο κείμενο σε λευκό φόντο σε λευκό κείμενο σε μαύρο φόντο. Οι εικόνες θα αλλάξουν επίσης.
Κατά τη φόρτωση της σελίδας, το widget θα προσπαθήσει να προσδιορίσει πόσο σκοτεινό είναι το φόντο της σελίδας πίσω από το widget σχολίων. Αυτό σημαίνει ότι η σελίδα μπορεί να έχει λευκό φόντο, αλλά αν τοποθετήσετε το widget σχολίων μέσα σε ένα κοντέινερ με μαύρο φόντο, η σκοτεινή λειτουργία θα πρέπει να ενεργοποιηθεί αυτόματα ώστε τα σχόλια να είναι ευανάγνωστα.
Ωστόσο, ο μηχανισμός ανίχνευσης, που βασίζεται στον προσδιορισμό της "φωτεινότητας", ενδέχεται να μην ενεργοποιήσει τη σκοτεινή λειτουργία όταν το επιθυμείτε. Για να την ενεργοποιήσετε υποχρεωτικά, ορίστε τη σημαία hasDarkBackground σε true ως εξής:
Run Εναλλαγή σκοτεινής λειτουργίας
Για ιστότοπους που επιτρέπουν την εναλλαγή σε σκοτεινή λειτουργία μετά την αρχική φόρτωση της σελίδας, αυτό απαιτεί λίγο περισσότερη εργασία.
Πρώτον, όλες οι τρέχουσες εκδόσεις της βιβλιοθήκης widget σχολίων (React, Vue) περιέχουν παραδείγματα εναλλαγής σκοτεινής λειτουργίας στα αντίστοιχα αποθετήριά τους.
Για το widget VanillaJS, θα χρειαστεί να κάνουμε λίγη περισσότερη δουλειά. Το FastCommentsUI επιστρέφει ένα αντικείμενο με τις συναρτήσεις "destroy" και "update".
Μπορούμε απλά να καλέσουμε τη συνάρτηση update κάθε φορά που θέλουμε να ενημερώσουμε τη ρύθμιση του widget σχολίων, ως εξής. Εδώ είναι ένα πλήρες λειτουργικό παράδειγμα εναλλαγής σκοτεινής λειτουργίας με το widget VanillaJS.
Run Αντικατάσταση κειμένου
Με το FastComments, όλο το κείμενο στο widget σχολιασμού είναι προσαρμόσιμο.
Μπορείτε να αντικαταστήσετε ένα μόνο κομμάτι κειμένου, όπως το κουμπί υποβολής, ή όλο το κείμενο σε ολόκληρο το widget σχολιασμού.
Εξ ορισμού, το κείμενο στο widget σχολιασμού μεταφράζεται βάσει της τοπικής ρύθμισης (locale) του χρήστη. Ωστόσο, μπορούμε να αντικαταστήσουμε το κείμενο, εάν είμαστε βέβαιοι ότι η βάση χρηστών μας χρησιμοποιεί την ίδια τοπική ρύθμιση/γλώσσα, για παράδειγμα:
Run Όλες οι προσαρμόσιμες μεταφράσεις μπορείτε να τις βρείτε εδώ στην καρτέλα «Σύνθετες επιλογές».
Ωστόσο, υπάρχει ένας πιο εύκολος τρόπος, μέσω του UI προσαρμογής του widget. Εκεί, μπορούμε απλά να βρούμε το κείμενο που εμφανίζεται στο widget σχολιασμών στην τοπική ρύθμιση EN_US και να καθορίσουμε μια αντικατάσταση.
Όλες οι αντικαταστάσεις μεταφράσεων επηρεάζουν επί του παρόντος όλες τις τοπικές ρυθμίσεις.
Αλλαγή προεπιλεγμένης εικόνας προφίλ
Όταν ένας χρήστης σχολιάζει με το FastComments για πρώτη φορά θα προσπαθήσουμε να ανακτήσουμε την εικόνα προφίλ τους από http://gravatar.com/.
Ωστόσο, αν δεν βρούμε εικόνα προφίλ, ή ο χρήστης δεν ορίσει ποτέ κάποια στον λογαριασμό του, εμφανίζουμε μια στατική προεπιλεγμένη εικόνα προφίλ.
Για να καθορίσετε τη δική σας στατική εικόνα προφίλ μπορούμε να χρησιμοποιήσουμε τη ρύθμιση defaultAvatarSrc.
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Προεπιλεγμένη εικόνα προφίλ".
Σημειώστε ότι ο καθορισμός της εικόνας προφίλ για έναν συγκεκριμένο χρήστη, όπως με SSO, καλύπτεται σε ξεχωριστή ενότητα.
Απενεργοποίηση εικόνων προφίλ
Οι εικόνες προφίλ μπορούν να αφαιρεθούν εντελώς από το widget σχολίων, ακόμη και αν οι χρήστες έχουν ορίσει τη δική τους εικόνα προφίλ.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Απενεργοποίηση όλων των προεπιλεγμένων στυλ
Για μεγαλύτερα έργα προσαρμογής στυλ, μπορεί να είναι επιθυμητό να ξεκινήσετε με καθαρή αρχή και να μην χρησιμοποιήσετε καθόλου την προεπιλεγμένη μορφοποίηση.
Όλα τα προεπιλεγμένα στυλ μπορούν να αφαιρεθούν ορίζοντας την παράμετρο noStyles σε true, ως εξής:
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, κάτω από τις Σύνθετες Επιλογές:
Σύνδεση σχολίων με σελίδες
Κατά την αποστολή ειδοποιητικών email, ή κατά την απόδοση σχολίων σε διεπαφές χρήστη όπως η σελίδα διαχείρισης, είναι χρήσιμο να μπορείτε να συνδέσετε το σχόλιο με τη σελίδα στην οποία βρίσκεται.
If URL ID isn't always an ID, then we have to store the URL some place else. That's what the "url" property is for, defined as follows.
Run Μια συνηθισμένη περίπτωση χρήσης είναι να συσχετίσετε το νήμα σχολίων με ένα αναγνωριστικό, όπως ενός άρθρου, και στη συνέχεια να συνδέσετε πίσω σε μια συγκεκριμένη σελίδα, για παράδειγμα:
Run Το URL δεν καθαρίζεται από κοινές παραμέτρους μάρκετινγκ. Από προεπιλογή, όποιο κι αν είναι το τρέχον URL της σελίδας, αποθηκεύεται ως το URL μαζί με το σχόλιο.
Σύμπτυξη απαντήσεων από προεπιλογή
Από προεπιλογή, οι απαντήσεις στα σχόλια κορυφαίου επιπέδου εμφανίζονται.
Αυτό μπορεί να ρυθμιστεί έτσι ώστε ο χρήστης να πρέπει να κάνει κλικ "Show Replies" στα σχόλια κορυφαίου επιπέδου για να δει τα παιδιά.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Αυτή η ρύθμιση δεν θα επηρεάσει τον αριθμό των αρχικά φορτωμένων σχολίων κορυφαίου επιπέδου. Εάν έχετε ένα σχόλιο κορυφαίου επιπέδου και 29 απαντήσεις, με αυτή τη ρύθμιση ενεργοποιημένη θα:
- Θα δείτε το σχόλιο κορυφαίου επιπέδου.
- Θα δείτε Show Replies (29) κάτω από αυτό το σχόλιο.
Εάν επιθυμείτε να εμφανίζονται όλα τα σχόλια κορυφαίου επιπέδου σε συνδυασμό με αυτήν την επιλογή, ορίστε starting page to -1.
Ενεργοποίηση WYSIWYG
Σε προεπιλογή, οι λειτουργίες μορφοποίησης στο FastComments πραγματοποιούνται προσθέτοντας ορατά tags αγκύρωσης όπως <b></b> γύρω από το κείμενό σας. Το κλικ στη γραμμή εργαλείων
ή η χρήση συντομεύσεων το κάνει αυτό για εσάς. Ωστόσο, κάποιες κοινότητες μπορεί να θέλουν να επιλέξουν τη χρήση μορφοποίησης χωρίς tags αγκύρωσης. Αυτό ονομάζεται ενεργοποίηση του
WYSIWYG (ό,τι βλέπετε είναι ό,τι παίρνετε) επεξεργαστή. Αυτός ο επεξεργαστής φαίνεται ακριβώς ο ίδιος με τον προεπιλεγμένο, εκτός από το ότι φορτώνει κάποιο
επιπλέον κώδικα που επιτρέπει στους χρήστες να κάνουν έντονη, υπογράμμιση κ.λπ. στο κείμενό τους χωρίς ορατά tags αγκύρωσης.
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Ενεργοποίηση Προηγμένης Μορφοποίησης".
Απενεργοποίηση γραμμής εργαλείων
Από προεπιλογή, το FastComments θα εμφανίζει μια γραμμή εργαλείων όταν γράφετε ένα σχόλιο για να παρέχει συντομεύσεις για τη διακόσμηση κειμένου και τη μεταφόρτωση εικόνων.
Αυτή η γραμμή εργαλείων μπορεί να απενεργοποιηθεί στον κώδικα ή μέσω της διεπαφής προσαρμογής.
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Απενεργοποίηση της γραμμής εργαλείων απάντησης".
Απενεργοποίηση αποκλεισμού
Από προεπιλογή, το FastComments επιτρέπει στους χρήστες να αποκλείουν άλλους χρήστες. Ο αποκλεισμός ενός χρήστη θα κάνει τα σχόλιά του να αποκρύπτονται, θα αποτρέπει τις ειδοποιήσεις μεταξύ των χρηστών και ούτω καθεξής.
Μπορεί να είναι επιθυμητό να απενεργοποιηθεί αυτή η λειτουργία. Αυτό μπορεί να γίνει ως εξής:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα, κάτι που επίσης ενεργοποιεί τη σωστή επαλήθευση στην πλευρά του διακομιστή, μέσω της διεπαφής προσαρμογής του widget:
Καθορισμός ποια σελίδα θα αποδοθεί
Κατά την ανάκτηση και απόδοση των σχολίων, το widget σχολίων πρέπει να γνωρίζει από ποια σελίδα να ξεκινήσει. Από προεπιλογή, ξεκινά με την πρώτη σελίδα, αποδίδοντας μόνο εκείνη τη σελίδα.
Εάν επιθυμείτε, η ακριβής σελίδα που θα αποδοθεί μπορεί να περαστεί στο widget σχολίων μέσω της ρύθμισης startingPage.
Run Σημειώστε ότι οι αριθμοί σελίδων ξεκινούν από το μηδέν, οπότε το παραπάνω παράδειγμα αποδίδει τη δεύτερη σελίδα.
Εναλλαγή νημάτων σχολίων χωρίς επαναφόρτωση της σελίδας
Έχουμε καλύψει πώς το urlId είναι το αναγνωριστικό (id) της σελίδας ή του άρθρου στο οποίο συνδέονται τα σχόλια.
Επίσης, για σύνοψη, εάν δεν οριστεί, το urlId θα οριστεί από προεπιλογή στο τρέχον URL της σελίδας.
Τι γίνεται με τις SPA, ή Single-Page-Applications, όπου η σελίδα ή το περιεχόμενο στο οποίο συνδέονται τα σχόλια αλλάζει δυναμικά χωρίς επαναφόρτωση της σελίδας;
Angular, React, Vue, etc
Με τις βιβλιοθήκες μας όπως οι Angular και React, απλώς η ενημέρωση της ιδιότητας urlId που περνάει στο widget
θα προκαλέσει την ανανέωση του widget σχολίων. Μπορείτε να δείτε αυτό σε δράση για την εφαρμογή React, για παράδειγμα, εδώ.
VanillaJS
Αν χρησιμοποιείτε τη βιβλιοθήκη VanillaJS, είναι λίγο πιο περίπλοκο καθώς δεν υπάρχει ένα πλαίσιο όπως το Angular ή το React για να χειρίζεται τη δεσμοποίηση δεδομένων ή τη διάδοση κατάστασης.
Όταν δημιουργείτε μια παρουσία του widget VanillaJS, επιστρέφει κάποιες συναρτήσεις οι οποίες μπορούν να καλούνται για να το ενημερώσουν.
Ακολουθεί ένα λειτουργικό παράδειγμα όπου αλλάζουμε το hash της σελίδας και ενημερώνουμε το widget σχολίων:
Run Απόλυτες ημερομηνίες (απενεργοποίηση φιλικών χρονοσημειώσεων)
Από προεπιλογή χρησιμοποιούνται τοπικές σχετικές ημερομηνίες. Για παράδειγμα, δίπλα σε ένα σχόλιο που μόλις δημοσιεύτηκε ενδέχεται να δείτε "πριν από 11 λεπτά".
Μπορεί να είναι απαραίτητο ή επιθυμητό να χρησιμοποιήσετε απόλυτες ημερομηνίες, οπότε ορίζετε αυτή την παράμετρο σε true.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, στην ενότητα Σύνθετες Επιλογές:
Εμφάνιση και απόλυτων και σχετικών ημερομηνιών
Από προεπιλογή χρησιμοποιούνται τοπικοποιημένες σχετικές ημερομηνίες. Για παράδειγμα, δίπλα σε ένα πρόσφατα δημοσιευμένο σχόλιο μπορεί να δείτε "πριν 11 λεπτά".
Ενδέχεται να χρειαστεί ή να επιθυμείτε να διατηρήσετε αυτήν τη μορφή σχετικής ημερομηνίας, αλλά ταυτόχρονα να εμφανίσετε και την πλήρη ημερομηνία δίπλα της· σε αυτήν την περίπτωση ορίστε αυτήν την παράμετρο σε true.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, κάτω από τις Σύνθετες Επιλογές. Θα πρέπει πρώτα να ενεργοποιήσετε τις Απόλυτες Ημερομηνίες για να δείτε αυτήν την επιλογή στο UI.
Προσθήκη κειμένου κεφαλίδας
Κάποιο κείμενο, όπως μια κεφαλίδα ή ένα μήνυμα, μπορεί να εμφανιστεί κάτω από τον αριθμό σχολίων αλλά πάνω από το κείμενο κατάστασης σύνδεσης.
Αυτό το ονομάζουμε κεφαλίδα, και από προεπιλογή είναι κρυφό.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, κάτω από τις Προηγμένες Επιλογές:
Απόδοση συνδέσμων ως κείμενο
Εξ ορισμού, το FastComments θα αποδώσει συνδέσμους όπως αυτός: https://exmaple.com - όπου το URL του συνδέσμου γίνεται κλικ ετικέτα αγκύρωσης HTML.
Κάποιες ιστοσελίδες μπορεί να θέλουν να το απενεργοποιήσουν, για παράδειγμα για να αποθαρρύνουν τους απατεώνες. Το παρέχουμε ρυθμίζοντας την Comment HTML Rendering Option σε Links as Text.
Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, για ολόκληρο τομέα, ή σελίδα:
Εναλλαγή εμφάνισης σχολίων με κουμπί
Από προεπιλογή, το FastComments θα εμφανίζει το πλαίσιο εισαγωγής σχολίου και το νήμα σχολίων ταυτόχρονα. Για να εξοικονομήσει κάθετο χώρο, θα αποκρύψει επίσης οποιαδήποτε άλλα απαιτούμενα πεδία μέχρι να γίνει κάποια αλληλεπίδραση με το widget.
Ωστόσο, το widget σχολίων μπορεί να κρυφτεί πίσω από ένα κουμπί, για παράδειγμα:
Το κουμπί χρησιμοποιεί διαφορετικό μεταφρασμένο κείμενο ανάλογα με το αν τα σχόλια εμφανίζονται αυτήν τη στιγμή ή όχι. Αν τα σχόλια είναι κρυμμένα, χρησιμοποιεί translations.SHOW_COMMENTS_BUTTON_TEXT. Αν τα
σχόλια εμφανίζονται, χρησιμοποιεί translations.HIDE_COMMENTS_BUTTON_TEXT. Οι μεταφράσεις μπορούν να περιέχουν το κείμενο [count] το οποίο θα
αντικατασταθεί από τον τοπικοποιημένο αριθμό.
Run Αυτό έχει σχεδιαστεί για να αντικαταστήσει τη ρύθμιση hideCommentsUnderCountTextFormat.
Ο αριθμός ενημερώνεται ζωντανά με το νήμα σχολίων. Το κουμπί δεν εμφανίζεται αν δεν υπάρχουν σχόλια.
Αυτό μπορεί να ενεργοποιηθεί χωρίς κώδικα δημιουργώντας έναν κανόνα εξατομίκευσης και ενεργοποιώντας "Κλικ για εμφάνιση σχολίων":
Προσαρμογή κειμένου πλήθους σχολίων
Ο αριθμός σχολίων που εμφανίζεται στην κορυφή του widget σχολίων μπορεί να προσαρμοστεί.
Μπορεί να αντικατασταθεί με οποιαδήποτε συμβολοσειρά, και η τιμή [count] θα αντικατασταθεί με το πλήθος, το οποίο θα τοπικοποιηθεί για τον χρήστη.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Απενεργοποίηση ανακατεύθυνσης εικόνων
Από προεπιλογή, το FastComments επιτρέπει στους χρήστες να ανεβάζουν εικόνες. Όταν ο χρήστης κάνει κλικ σε αυτήν την εικόνα, το FastComments, από προεπιλογή, θα ανοίξει μια νέα καρτέλα για να εμφανίσει την εικόνα σε πλήρες μέγεθος. Η ρύθμιση αυτής της σημαίας σε true απενεργοποιεί αυτή τη συμπεριφορά:
Run Αν δεν σκοπεύετε να χειριστείτε εσείς το κλικ στην εικόνα (βλέπε onImageClicked), συνιστούμε να το συνδυάσετε με κάποια στυλ ώστε να αφαιρέσετε την εντύπωση ότι η εικόνα μπορεί να γίνει κλικ.
Απενεργοποίηση αυτόματης δημιουργίας hashtag
Όταν οι χρήστες εισάγουν hashtags, με τη μορφή του #someexampletag, το FastComments θα δημιουργήσει αυτόματα αυτό το HashTag και
θα το επισημάνει στο σχόλιό τους.
Σε ορισμένες περιπτώσεις είναι επιθυμητό να απενεργοποιηθεί αυτή η λειτουργία, ή να ελέγχεται ποια hashtags μπορούν να χρησιμοποιηθούν μέσω του API.
Για να το κάνετε αυτό, απλά ενεργοποιήστε το Disable Automatic #hashtag Creation μέσω της διεπαφής προσαρμογής του Widget.
Απενεργοποίηση κουδουνιού ειδοποιήσεων
Από προεπιλογή, το FastComments θα εμφανίζει ένα εικονίδιο κουδουνιού ειδοποίησης στο επάνω δεξί μέρος της περιοχής σχολίων.
Αυτό το κουδούνι θα γίνει κόκκινο και θα εμφανίσει έναν μετρητή με τον αριθμό των ειδοποιήσεων που έχει ο χρήστης. Παραδείγματα ειδοποιήσεων είναι:
- Κάποιος χρήστης σας απάντησε.
- Κάποιος χρήστης απάντησε σε ένα νήμα στο οποίο σχολιάσατε.
- Κάποιος χρήστης ψήφισε θετικά το σχόλιό σας.
- Κάποιος χρήστης απάντησε σε μια σελίδα στην οποία έχετε εγγραφεί.
Το κουδούνι ειδοποίησης παρέχει επίσης έναν μηχανισμό για να εγγραφείτε σε ολόκληρη μια σελίδα.
Ωστόσο, μπορούμε να απενεργοποιήσουμε εντελώς το κουδούνι ειδοποίησης:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Απενεργοποίηση κουδουνιού ειδοποιήσεων".
Απενεργοποίηση προφίλ
Προεπιλεγμένα, το FastComments θα εμφανίζει το προφίλ του χρήστη όταν κάνετε κλικ στο avatar του.
Ωστόσο, μπορούμε να απενεργοποιήσουμε αυτή τη λειτουργία:
Run Αυτό μπορεί να γίνει και χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Disable Profiles".
Απενεργοποίηση μηνύματος επιτυχίας
Από προεπιλογή, το FastComments θα εμφανίζει ένα μήνυμα επιτυχίας μετά το σχολιασμό. Αυτό μπορεί να απενεργοποιηθεί ως εξής:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget:
Αλλαγή βαθμολογίας περιεχομένου για GIF
Από προεπιλογή, το widget σχολίων FastComments θα ορίζει gif rating ως pg.
Οι διαθέσιμες επιλογές είναι g, pg, pg-13 και r.
Αυτό μπορεί να οριστεί στον κώδικα ή μέσω του UI. Στον κώδικα μπορούμε να το κάνουμε ως εξής:
Run Στο UI, θα το βρείτε κάτω από Gif Picker Rating εφόσον το Disable Image Uploads? δεν είναι επιλεγμένο.
Διαχείριση περιεχομένου εικόνων
Από προεπιλογή, το widget σχολίων FastComments έχει τη ρύθμιση για τον έλεγχο περιεχομένου εικόνων απενεργοποιημένη off.
Οι διαθέσιμες επιλογές είναι off, low, medium, και high.
Στη διεπαφή προσαρμογής του widget, θα το βρείτε κάτω από Image Content Moderation Level, εφόσον το Disable Image Uploads? δεν είναι επιλεγμένο.
Αλλαγή τρόπου ψηφοφορίας
Από προεπιλογή, το FastComments θα εμφανίζει τις επιλογές ψήφου ως βέλη προς τα πάνω και προς τα κάτω, επιτρέποντας στους χρήστες είτε να ψηφίζουν θετικά είτε αρνητικά ένα σχόλιο.
Ωστόσο, είναι δυνατό να αλλάξετε το στυλ της γραμμής εργαλείων ψήφου. Οι τρέχουσες επιλογές είναι τα προεπιλεγμένα κουμπιά Up/Down, ή η χρήση ενός μηχανισμού ψήφου στυλ Heart.
Χρησιμοποιούμε τη σημαία voteStyle ως εξής:
Run Συνιστούμε θερμά να το κάνετε αυτό χωρίς κώδικα, καθώς ενεργοποιεί επίσης επικυρώσεις στην πλευρά του διακομιστή. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Vote Style".
Οι ψήφοι μπορούν επίσης να απενεργοποιηθούν, δείτε το Disable Voting παραπάνω από τις επιλογές στυλ.
Απενεργοποίηση διαγραφής
Από προεπιλογή, το FastComments θα επιτρέπει στους χρήστες να διαγράφουν τα σχόλιά τους.
Ωστόσο, είναι δυνατό να το αποτρέψετε.
Στην σελίδα προσαρμογής του widget, δείτε την επιλογή "Disable Deleting".
- Αυτό επηρεάζει μόνο τους κανονικούς σχολιαστές και όχι τους συντονιστές ή τους διαχειριστές, οι οποίοι θα εξακολουθούν να μπορούν να διαγράψουν.
- Αυτό θα επηρεάσει επίσης τις ενσωματώσεις API για όταν περνάει το
contextUserId.
Απενεργοποίηση επεξεργασίας
Από προεπιλογή, το FastComments επιτρέπει στους χρήστες να επεξεργάζονται τα σχόλιά τους.
Ωστόσο, είναι δυνατό να αποτραπεί αυτό.
Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Απενεργοποίηση επεξεργασίας".
- Αυτό επηρεάζει μόνο τους κανονικούς Commenters και όχι τους moderators ή admins, οι οποίοι θα εξακολουθούν να μπορούν να επεξεργάζονται.
- Αυτό θα επηρεάσει επίσης τις ενσωματώσεις API όταν περνάται το
contextUserId.
Επισήμανση νέων σχολίων
FastComments παρέχει αρκετούς τρόπους για να επισημαίνονται τα νέα σχόλια.
Πρωτίστως, από προεπιλογή, τα σχόλια που προκάλεσαν μια εντός-εφαρμογής ειδοποίηση (απαντήσεις, απαντήσεις στο ίδιο νήμα ή σχόλια σε μια σελίδα
στην οποία είστε εγγεγραμμένοι), θα επισημαίνονται αυτόματα με το avatar του χρήστη να λάμπει ελαφρώς. Το χρώμα μπορεί να προσαρμοστεί μέσω CSS
χρησιμοποιώντας την κλάση is-unread.
Στα σχόλια που δημοσιεύτηκαν τις τελευταίες 24 ώρες εφαρμόζεται η κλάση 24hr που μπορεί να χρησιμοποιηθεί για στυλ.
Τέλος, οποιαδήποτε νέα σχόλια σε πραγματικό χρόνο που εμφανίζονται στη συνεδρία του χρήστη θα επισημαίνονται για μερικά δευτερόλεπτα μέσω μιας κινούμενης εικόνας. Αυτό γίνεται μέσω της
κλάσης CSS is-live και μπορεί επίσης να προσαρμοστεί.
Μέγεθος σελίδων
Από προεπιλογή, το μέγεθος σελίδας του FastComments είναι 30. Αυτό περιλαμβάνει απαντήσεις σε νήματα.
Το μέγεθος σελίδας μπορεί να προσαρμοστεί στη Διεπαφή ρύθμισης παραμέτρων του widget σε διάφορα μεγέθη από 10 έως 200.
Σημειώστε ότι η αλλαγή του μεγέθους σελίδας απαιτεί επανυπολογισμό όλων των νημάτων σχολίων στον λογαριασμό σας. Αυτό μπορεί να διαρκέσει μερικά λεπτά.
Αυτό δεν μπορεί να ρυθμιστεί στο widget από την πλευρά του πελάτη, καθώς οι σελίδες υπολογίζονται από τον διακομιστή.
Παρακάτω φαίνεται ένα παράδειγμα ρύθμισης:
Τα μεγέθη σελίδας μπορούν να προσαρμοστούν σε παγκόσμιο επίπεδο, ανά domain ή ανά σελίδα, δημιουργώντας διαφορετικούς κανόνες προσαρμογής.
Αυτό θα επηρεάσει όλους τους πελάτες, τις ενσωματώσεις και τα πλαίσια εργασίας (frameworks) που μπορεί να χρησιμοποιείτε για να εμφανίζετε σχόλια μέσω της πλατφόρμας μας.
Πρότυπα ηλεκτρονικού ταχυδρομείου
Τα email που αποστέλλονται από το FastComments στους πελάτες σας μπορούν να προσαρμοστούν. Το πρότυπο, η λογική, και οι μεταφράσεις μπορούν όλες να τροποποιηθούν. Το κείμενο μπορεί να προσαρμοστεί ανά τοπική ρύθμιση, και το στυλ μπορεί ακόμη να αλλάξει ανά τομέα. Μάθετε περισσότερα για τα προσαρμοσμένα πρότυπα email εδώ.
Μορφές ονομάτων χρήστη
Από προεπιλογή, το FastComments θα εμφανίζει το όνομα του χρήστη όπως το εισήγαγε, ή όπως μας μεταφέρθηκε μέσω SSO.
Ωστόσο, μπορεί να είναι επιθυμητό να αποκρύψετε ή να εμφανίσετε το όνομα του χρήστη με διαφορετικό τρόπο. Για παράδειγμα, αν το όνομα του χρήστη είναι Allen Rex, ίσως θέλετε να εμφανίζεται μόνο "Allen R.".
Αυτό μπορεί να γίνει χωρίς κώδικα στο UI προσαρμογής του Widget, στην ρύθμιση με την ονομασία Commenter Name Format:
Οι διαθέσιμες μορφές είναι:
- Capitalize (display example user as Example User)
- Last Initial (display Example User as Example U.)
- All Initials (display Example User as E. U.)
- Show "Anonymous"
Η επίδραση αυτής της αλλαγής είναι άμεση. Οι χρήστες θα βλέπουν ακόμα το πλήρες όνομα χρήστη τους στην κορυφή της περιοχής σχολίων, για τους ίδιους, αλλά τα σχόλιά τους θα εμφανίζουν το τροποποιημένο όνομα χρήστη.
Τα ονόματα χρήστη μάσκονται από την πλευρά του διακομιστή για την προστασία των χρηστών.
Απενεργοποίηση ανέβασματος εικόνων
Από προεπιλογή, το FastComments επιτρέπει τη μεταφόρτωση εικόνων. Αυτό μπορεί να απενεργοποιηθεί ρυθμίζοντας το noImageUploads σε true.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Ενεργοποίηση πεδίου αναζήτησης
Από προεπιλογή, δεν εμφανίζεται πλαίσιο αναζήτησης στο widget σχολίων.
Ωστόσο, μπορούμε να το ενεργοποιήσουμε ορίζοντας τη σημαία enableSearch σε true:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Enable Search Box".
Ενεργοποίηση spoiler
Μπορούμε να ενεργοποιήσουμε την υποστήριξη spoiler ορίζοντας τη σημαία enableSpoilers σε true:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Enable Spoilers".
Όταν το κείμενο επισημαίνεται και το πλέον εμφανές κουμπί SPOILER πατηθεί, το κείμενο θα αποκρύπτεται μέχρι ο χρήστης να περάσει το δείκτη του ποντικιού από πάνω του. Για το σκούρο θέμα κάνουμε το ίδιο, με διαφορετικά χρώματα που ταιριάζουν καλύτερα στο σκούρο θέμα.
Αυτό είναι επίσης συμβατό με τον επεξεργαστή WYSIWYG.
Ενεργοποίηση καταμέτρησης προβολών σχολίων
Από προεπιλογή, το FastComments δεν παρακολουθεί ποιος είδε κάθε σχόλιο ούτε παρέχει στατιστικά σχετικά με αυτό.
Ωστόσο, μπορούμε να ενεργοποιήσουμε αυτή τη λειτουργία, και τότε το σύστημα θα αρχίσει να παρακολουθεί όταν κάθε χρήστης κάνει κύλιση σε ένα σχόλιο.
Όταν αυτό συμβαίνει, ένας μετρητής δίπλα σε ένα εικονίδιο ματιού που εμφανίζεται σε κάθε σχόλιο θα αυξάνεται. Ο μετρητής ενημερώνεται σε πραγματικό χρόνο και συντομεύεται σύμφωνα με τη ρύθμιση τοπικής γλώσσας (locale) του χρήστη.
Μπορούμε να το ενεργοποιήσουμε ρυθμίζοντας τη σημαία enableViewCounts σε true:
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Παρακολουθούμε το user id* που είδε το σχόλιο, ώστε αν ξαναδείτε το σχόλιο να μην αυξάνεται. Αν ξαναδείτε το σχόλιο μετά από δύο χρόνια, ο μετρητής θα αυξηθεί ξανά.
- *Σημείωση: ή το anon session id, ή το IP του χρήστη ως κατακερματισμένη τιμή.
Εμφάνιση ζωντανών σχολίων αμέσως
Από προεπιλογή, τα ζωντανά σχόλια είναι ενεργοποιημένα. Αυτό σημαίνει ότι αν προστίθενται, διαγράφονται, επεξεργάζονται, ή καρφιτσώνονται σχόλια, οι αλλαγές πρέπει να εμφανίζονται σε όλους τους χρήστες που βλέπουν το νήμα σχολίων ταυτόχρονα.
Ωστόσο, από προεπιλογή αυτά τα νέα σχόλια θα εμφανίζονται κάτω από ένα δυναμικά εμφανιζόμενο κουμπί με κείμενο παρόμοιο με "Εμφάνιση 2 νέων σχολίων".
Εάν τα νέα σχόλια είναι απαντήσεις απευθείας στη σελίδα, το κουμπί θα εμφανίζεται στην κορυφή του νήματος σχολίων. Εάν είναι απαντήσεις σε ένα συγκεκριμένο σχόλιο, το κουμπί θα εμφανίζεται κάτω από αυτό το σχόλιο.
Αυτό γίνεται για να αποφευχθεί η συνεχής αλλαγή του μεγέθους της σελίδας για τον χρήστη, κάτι που μπορεί να προκαλέσει απογοήτευση όταν προσπαθεί να πιάσει τη γραμμή κύλισης.
Για ορισμένα σενάρια χρήσης, όπως live δημοπρασίες ή διαδικτυακά γεγονότα, αυτή η συμπεριφορά δεν είναι επιθυμητή - μπορεί να θέλετε το widget σχολιασμού να λειτουργεί περισσότερο σαν κουτί συνομιλίας όπου τα νέα σχόλια «εμφανίζονται αμέσως».
Εξ ου και το όνομα της σημαίας που ενεργοποιεί αυτή τη λειτουργία: showLiveRightAway.
Μπορούμε να την ενεργοποιήσουμε ως εξής:
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής widget:
Απενεργοποίηση ζωντανών σχολίων
Από προεπιλογή, το FastComments θα έχει ενεργοποιημένα τα ζωντανά σχόλια.
Αυτό σημαίνει ότι κάθε θεατής του νήματος σχολίων θα πρέπει να βλέπει το ίδιο περιεχόμενο.
Για παράδειγμα, εάν προστεθεί ένα σχόλιο, αυτό το σχόλιο θα εμφανιστεί. Εάν ένα σχόλιο επεξεργαστεί ή αφαιρεθεί, τότε αυτά τα σχόλια θα επεξεργαστούν ή θα αφαιρεθούν για όλους τους θεατές του νήματος. Το ίδιο ισχύει για τις ψήφους και για όλες τις ενέργειες εποπτείας.
Ωστόσο, μπορούμε να το απενεργοποιήσουμε:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Απενεργοποίηση ζωντανών σχολίων".
Νέα ζωντανά σχόλια στο κάτω μέρος
Συνήθως, τα νέα ζωντανά σχόλια εμφανίζονται στην κορυφή της λίστας σχολίων καθώς δημοσιεύονται σε πραγματικό χρόνο.
Όταν αυτή η επιλογή είναι ενεργοποιημένη, τα νέα ζωντανά σχόλια θα προστεθούν στο κάτω μέρος της λίστας. Αυτό επηρεάζει τον τρόπο εμφάνισης των σχολίων όταν δημοσιεύονται ζωντανά ενώ οι χρήστες βλέπουν το νήμα σχολίων.
Run Με αυτή τη ρύθμιση ενεργοποιημένη:
- Τα νέα ζωντανά σχόλια που δημοσιεύονται από άλλους χρήστες θα εμφανίζονται στο κάτω μέρος της λίστας σχολίων
- Οι χρήστες θα βλέπουν τα νέα σχόλια να εμφανίζονται κάτω από τα υπάρχοντα σχόλια σε πραγματικό χρόνο
- Αυτό επηρεάζει μόνο τις ενημερώσεις ζωντανών σχολίων — όχι την αρχική φόρτωση της σελίδας
- Αυτό μπορεί να βοηθήσει στη διατήρηση της ροής ανάγνωσης όταν οι χρήστες ακολουθούν μια συζήτηση
Σημειώστε ότι αυτή η ρύθμιση επηρεάζει μόνο τη θέση όπου τοποθετούνται τα νέα ζωντανά σχόλια καθώς καταφθάνουν σε πραγματικό χρόνο. Δεν επηρεάζει την αρχική σειρά ταξινόμησης κατά τη φόρτωση της σελίδας.
Ενεργοποίηση άπειρης κύλισης
By default, the FastComments widget will resize itself vertically to fit all visible comments. Pagination is achieved via a "Προβολή Επόμενων" button at the end of the current page, as we have found this to be the interaction that feels the nicest for most users.
However, there are some cases where infinite scrolling is preferred. For example, we use this feature in our Stream Chat product.
We can hide the "Προβολή Επόμενων" buttons and switch to infinite scrolling by setting the enableInfiniteScrolling flag to true:
Run This also requires the addition of custom CSS to be added. Add custom CSS for the .comments selector to enable scrolling, for example:
Run A full working example would be:
Run In the above example we use the customCSS property, however it is suggested the Widget Configuration UI is used instead for performance reasons. Δείτε την τεκμηρίωση για το Προσαρμοσμένο CSS.
Αλλαγή προεπιλεγμένης κατεύθυνσης ταξινόμησης
Από προεπιλογή, το FastComments θα ταξινομεί τα σχόλια με την κατεύθυνση ταξινόμησης «Πιο Σχετικό».
Η ταξινόμηση «Πιο Σχετικό» λαμβάνει υπόψη την ώρα που αφήθηκε το σχόλιο και τον αριθμό των ψήφων για την ταξινόμηση.
Ο χρήστης μπορεί στη συνέχεια να αλλάξει την κατεύθυνση ταξινόμησης είτε σε Παλαιότερα είτε σε Νεότερα πρώτα στο περιβάλλον χρήστη (UI) του widget σχολίων.
Ωστόσο, μπορούμε να αλλάξουμε την προεπιλεγμένη τιμή σε οποιαδήποτε από τις τρεις. Για παράδειγμα, αν θέλετε να εμφανίζονται πρώτα τα παλαιότερα σχόλια:
Run Θέτουμε την τιμή του defaultSortDirection σε "OF" για να ορίσουμε την κατεύθυνση σε "OF".
Για την κατεύθυνση ταξινόμησης Νεότερα πρώτα, θα κάναμε το εξής:
Run Οι έγκυρες τιμές για το defaultSortDirection είναι:
- MR: "Most Recent"
- NF: "Newest First"
- OF: "Oldest First"
Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα «Προεπιλεγμένη Κατεύθυνση Ταξινόμησης».
Σημειώστε ότι τα σχόλια σε κάθε σελίδα για κάθε κατεύθυνση ταξινόμησης υπολογίζονται εκ των προτέρων, οπότε όλες οι κατευθύνσεις ταξινόμησης έχουν την ίδια απόδοση.
Εμφάνιση όλων των σχολίων ταυτόχρονα - Απενεργοποίηση σελιδοποίησης
Για να απενεργοποιήσετε τη σελιδοποίηση και να εμφανίσετε απλώς όλα τα σχόλια ταυτόχρονα, ορίστε το startingPage σε -1.
Run Μετακίνηση του πλαισίου απάντησης μετά τα σχόλια
Από προεπιλογή η περιοχή εισαγωγής σχολίων βρίσκεται πριν το νήμα σχολίων. Ωστόσο, ρυθμίζοντας αυτή την παράμετρο διαμόρφωσης σε true μπορούμε να τη μετακινήσουμε μετά.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Περιορισμός μήκους σχολίου
Ο μέγιστος αριθμός χαρακτήρων που επιτρέπεται να εισαχθεί στο πεδίο σχολίου μπορεί να περιοριστεί από την παράμετρο maxCommentCharacterLength.
Η προεπιλογή είναι 2000.
Στοιχεία όπως οι διευθύνσεις URL εικόνων δεν περιλαμβάνονται στον υπολογισμό του μήκους.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Απενεργοποίηση σχολίων πολλαπλών γραμμών
Από προεπιλογή, το FastComments επιτρέπει στον χρήστη να εισάγει ένα σχόλιο με όσες γραμμές θέλει, έως το προεπιλεγμένο όριο χαρακτήρων.
Ωστόσο, μπορεί να είναι επιθυμητό να περιοριστεί ο χρήστης να εισάγει μόνο μία γραμμή κειμένου. Μερικά παραδείγματα χρήσης περιλαμβάνουν ηλεκτρονικούς πλειστηριασμούς ή ζωντανή συνομιλία, για την οποία το FastComments μπορεί να χρησιμοποιηθεί.
Ενεργοποιούμε τη σημαία useSingleLineCommentInput ως εξής:
Run Αυτό μπορεί να γίνει και χωρίς κώδικα. Στην σελίδα προσαρμογής του widget, δείτε την ενότητα "Ενεργοποίηση εισαγωγής σχολίου μίας γραμμής".
Σημειώστε ότι τα σχόλια σε κάθε σελίδα για κάθε κατεύθυνση ταξινόμησης υπολογίζονται εκ των προτέρων, οπότε όλες οι κατευθύνσεις ταξινόμησης έχουν την ίδια απόδοση.
Περιορισμός όγκου σχολίων ανά χρήστη
Κατά προεπιλογή, κάθε χρήστης μπορεί να υποβάλει έως και 5 comments μέσα στο ίδιο λεπτό.
Αυτό παρακολουθείται από user id, anon user id, και ip address (κατακερματισμένο).
Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Σημειώστε ότι αν χρησιμοποιείτε το comment creation API, ίσως θελήσετε να περάσετε τη αρχική διεύθυνση ip του χρήστη στο αίτημα προς το backend μας ώστε ο περιορισμός ρυθμού να εφαρμόζεται ανά χρήστη και όχι παγκοσμίως για τον λογαριασμό σας.
Αποτροπή νέων σχολίων πρώτου επιπέδου
Ορίζοντας το noNewRootComments σε true θα προκαλέσει το widget να αποκρύψει την περιοχή απάντησης ρίζας, αλλά θα επιτρέψει
ακόμα στους χρήστες να απαντούν σε υποσχόλια. Για παράδειγμα, μπορείτε να το ορίσετε υπό όρους κατά τη φόρτωση της σελίδας ώστε να επιτρέπεται μόνο σε κάποιους χρήστες να αφήνουν σχόλια πρώτου επιπέδου.
Run Μέγιστο βάθος απαντήσεων
Εξ ορισμού, το FastComments επιτρέπει απεριόριστη εμφώλευση απαντήσεων, δημιουργώντας μια δομή νήματος όπου οι χρήστες μπορούν να απαντούν σε απαντήσεις επ' αόριστον.
Η επιλογή maxReplyDepth σας επιτρέπει να περιορίσετε πόσο βαθιά μπορούν να φτάσουν τα νήματα απαντήσεων. Όταν επιτευχθεί το μέγιστο βάθος, οι χρήστες δεν θα βλέπουν πλέον κουμπί απάντησης στα σχόλια σε αυτό το επίπεδο.
Run Με το maxReplyDepth ορισμένο σε 2:
- Οι χρήστες μπορούν να σχολιάζουν στο ανώτατο επίπεδο (επίπεδο 0)
- Οι χρήστες μπορούν να απαντούν σε σχόλια κορυφαίου επιπέδου (επίπεδο 1)
- Οι χρήστες μπορούν να απαντούν σε αυτές τις απαντήσεις (επίπεδο 2)
- Δεν επιτρέπονται περαιτέρω απαντήσεις πέρα από το επίπεδο 2
Ο ορισμός σε 1 θα επέτρεπε μόνο απαντήσεις σε σχόλια κορυφαίου επιπέδου, δημιουργώντας μια πιο επίπεδη δομή συζήτησης.
Ο ορισμός του maxReplyDepth σε 0 θα απενεργοποιούσε όλες τις απαντήσεις, επιτρέποντας μόνο σχόλια κορυφαίου επιπέδου. Εάν δεν οριστεί, οι απαντήσεις μπορούν να εμφωλευτούν χωρίς όριο.
Επισκόπηση ενιαίας σύνδεσης (SSO)
SSO, ή ενιαία σύνδεση (single-sign-on), είναι ένα σύνολο συμβάσεων που χρησιμοποιούνται για να σας επιτρέψουν εσάς ή τους χρήστες σας να χρησιμοποιούν το FastComments χωρίς να χρειάζεται να δημιουργήσουν άλλο λογαριασμό.
Αν υποθέσουμε ότι δεν επιτρέπετε ανώνυμο σχολιασμό, απαιτείται λογαριασμός για να σχολιάσει κάποιος με το FastComments. Κάνουμε αυτή τη διαδικασία εγγραφής πολύ εύκολη - ο χρήστης απλά αφήνει το email του όταν σχολιάζει. Ωστόσο, καταλαβαίνουμε ότι ακόμα και αυτό αποτελεί πρόσθετη τριβή που κάποιοι ιστότοποι θέλουν να αποφύγουν.
Μπορούμε να μειώσουμε αυτήν την τριβή έχοντας μόνο μία ροή σύνδεσης για ολόκληρο τον ιστότοπό σας.
Πώς το αποκτώ;
Όλοι οι τύποι λογαριασμών αυτή τη στιγμή αποκτούν πρόσβαση στο SSO. Ωστόσο, ο μέγιστος αριθμός χρηστών SSO θα διαφέρει ανάλογα με το πακέτο σας. Όπως και με άλλα χαρακτηριστικά, τα Pro πλάνα και άνω παρέχουν άμεση υποστήριξη ανάπτυξης.
Ας συγκρίνουμε τις επιλογές και στη συνέχεια ας δούμε λεπτομερώς την κάθε μία.
Μεταφορές χρηστών και σχολίων
Όταν μετακινείστε από μια πλατφόρμα με SSO όπως το Disqus, θα έχετε ήδη χρήστες και τα σχόλιά τους.
Τα σχόλια εισάγονται ως μέρος της μετανάστευσής σας, είτε μέσω του API, του Import UI μας, είτε μέσω υποστήριξης πελατών. Το Import UI προτιμάται αν υποστηρίζει την πλατφόρμα από την οποία μεταφέρεστε, καθώς ενσωματώνει χειρισμό σφαλμάτων, εξαγωγή και φόρτωση avatar και μέσων, καθώς και ένα σύστημα παρακολούθησης εργασιών παρτίδας.
Οι ίδιοι οι χρήστες προστίθενται αυτόματα όταν βλέπουν για πρώτη φορά νήματα σχολίων. Εναλλακτικά, μπορούν να προπροστεθούν μέσω του API, αλλά αυτή η εργασία δεν έχει πολλά πλεονεκτήματα.
Εάν τα σχόλια εισαχθούν και οι χρήστες SSO δεν προστεθούν χειροκίνητα μέσω του API, τότε τα σχόλια θα μεταφερθούν αυτόματα στον λογαριασμό του χρήστη την πρώτη φορά που θα δημιουργηθεί όταν δουν οποιοδήποτε νήμα σχολίων. Στη συνέχεια θα μπορούν να διαχειρίζονται, να επεξεργάζονται και να διαγράφουν τα σχόλια που αρχικά έγραψαν.
Η αυτόματη μετανάστευση γίνεται μέσω email ή username. Κάποιες πλατφόρμες δεν παρέχουν emails κατά την εξαγωγή, όπως το Disqus, οπότε σε αυτή την περίπτωση καταφεύγουμε στο username.
- Εφόσον περάσετε ένα ταιριαστό username, και ένα email στο SSO payload, θα προσθέσουμε το email στα μεμονωμένα αντικείμενα σχολίων ώστε οι ειδοποιήσεις και οι αναφορές να λειτουργούν.
Εάν επιθυμείτε να εισάγετε τα σχόλιά σας και τους χρήστες ταυτόχρονα, συνεργαστείτε με την υποστήριξη για να μεταφέρετε τα σχόλια στους αντίστοιχους λογαριασμούς των χρηστών αφού οι χρήστες εισαχθούν μέσω του API.
Για να συνοψίσουμε, η πιο εύκολη διαδρομή για τη μετανάστευση είναι:
- Import comments.
- Avatars and other media is migrated automatically if using the Import UI in
Manage Data -> Imports.
- Avatars and other media is migrated automatically if using the Import UI in
- Setup Secure or Simple SSO.
- Let the migration happen per-user automatically when they log in for the first time.
- This usually adds less than a second to the page load time if the user has less than 50k comments.
Χρήστες WordPress
Εάν χρησιμοποιείτε το πρόσθετο WordPress μας τότε δεν χρειάζεται να γράψετε κώδικα! Απλώς μεταβείτε στη σελίδα Διαχείρισης του plugin, κάντε κλικ στο Ρυθμίσεις SSO, και μετά Ενεργοποίηση.
Αυτό θα σας οδηγήσει σε έναν οδηγό με ένα κουμπί που θα δημιουργήσει το API key σας, θα το στείλει στην εγκατάσταση WordPress σας και θα ενεργοποιήσει το SSO. Το έχουμε συγκεντρώσει σε ένα μόνο πάτημα κουμπιού για εσάς.
Σημειώστε ότι εάν εγκαθιστάτε το plugin για πρώτη φορά θα πρέπει να ολοκληρώσετε τη διαδικασία ρύθμισης πριν δείτε τη σελίδα διαχείρισης με το κουμπί Ρυθμίσεις SSO.
WordPress SSO - Moderators
Σημειώστε ότι προς το παρόν για να εμφανίζεται το σήμα "Moderator" δίπλα στους moderators όταν σχολιάζουν με το FastComments WordPress plugin, πρέπει επίσης να προστεθούν ως Moderator στο FastComments dashboard και να έχουν επαληθευτεί τα emails τους.
Προσαρμοσμένες Ενσωματώσεις
Για προσαρμοσμένες ενσωματώσεις, υπάρχουν δύο επιλογές.
Επιλογή 1 - Secure SSO
Με το Secure SSO, το FastComments γνωρίζει ότι ο χρήστης που σχολιάζει, ψηφίζει και διαβάζει σχόλια είναι πραγματικός χρήστης στον ιστότοπό σας.
Εφόσον δημιουργήσετε ένα έγκυρο payload, ο χρήστης θα έχει πάντα μια αδιάλειπτη εμπειρία σχολιασμού.
Με το Secure SSO, το SSO payload δημιουργείται server-side χρησιμοποιώντας HMAC authentication και στη συνέχεια περνάει στο widget στον client.
Με το Secure SSO, ο λογαριασμός του χρήστη είναι εντελώς ξεχωριστός από την υπόλοιπη βάση χρηστών του FastComments. Αυτό σημαίνει ότι αν έχουμε δύο συνεργάτες Company A και Company B, ο καθένας μπορεί να έχει έναν χρήστη SSO με το username "Bob".
Απαιτήσεις
- Κάποια βασική γνώση ανάπτυξης backend.
- Κάποια βασική γνώση χειρισμού μυστικών API keys.
- Κάποια βασική γνώση ανάπτυξης API ή server-side rendering.
Πλεονεκτήματα
- Ασφαλές.
- Αδιάλειπτη εμπειρία σχολιασμού.
Μειονεκτήματα
- Απαιτεί ανάπτυξη backend.
Ενημέρωση Δεδομένων Χρήστη
Με το Secure SSO, κάθε φορά που περνάτε το SSO payload χρήστη, θα ενημερώνουμε τον χρήστη με τις πιο πρόσφατες πληροφορίες. Για παράδειγμα, εάν
ο χρήστης έχει username X, και εσείς περάσετε Y στο SSO payload, το username του θα γίνει Y.
Εάν θέλετε να αφαιρέσετε τιμές χρησιμοποιώντας αυτή την προσέγγιση τότε ορίστε τις σε null (όχι undefined).
Secure SSO API
Παρέχουμε επίσης ένα API για την αλληλεπίδραση με τους χρήστες SSO. Δείτε την τεκμηρίωση: την τεκμηρίωση.
Σημειώστε ότι όταν χρησιμοποιείτε το Secure SSO, οι χρήστες δημιουργούνται αυτόματα στο παρασκήνιο κατά τη φόρτωση της σελίδας. Δεν χρειάζεται να εισάγετε μαζικά τους χρήστες σας.
Επιλογή 2 - Simple SSO
Η εναλλακτική στο Secure SSO είναι απλώς να περάσετε τις πληροφορίες του χρήστη στο widget σχολιασμού.
Η παροχή email με το Simple SSO δεν είναι απαραίτητη, ωστόσο χωρίς αυτό τα σχόλιά τους θα εμφανίζονται ως "Unverified".
Σημείωση! Από τις αρχές του 2022 τα usernames με το Simple SSO δεν χρειάζεται να είναι μοναδικά σε όλο το FastComments.com.
Κατά προτίμηση, το Simple SSO θα πρέπει να επιλέγεται μόνο όταν αναπτύσσετε σε πλατφόρμα που δεν παρέχει πρόσβαση στο backend.
Απαιτήσεις
- Κάποια βασική γνώση ανάπτυξης client-side.
- Να γνωρίζετε τουλάχιστον το email του χρήστη.
Πλεονεκτήματα
- Απλό.
- Όλη η δραστηριότητα εξακολουθεί να επαληθεύεται.
- Ο χρήστης δεν εισάγει ποτέ το username ή το email του.
Μειονεκτήματα
- Λιγότερο ασφαλές από το Secure SSO καθώς το payload στην πλευρά του πελάτη θα μπορούσε να κατασκευαστεί ώστε να αντιπροσωπεύει οποιονδήποτε χρήστη.
Simple SSO API
Οι χρήστες που δημιουργούνται αυτόματα μέσω της ροής Simple SSO αποθηκεύονται ως αντικείμενα SSOUser. Αυτοί μπορούν να αποκτηθούν και να διαχειριστούν μέσω του API SSOUser. Δείτε την τεκμηρίωση: την τεκμηρίωση.
Προσαρμοσμένες ενσωματώσεις - Ασφαλής ενιαία σύνδεση (SSO)
Το FastComments Secure SSO χρησιμοποιεί κρυπτογράφηση HMAC-SHA256 ως μηχανισμό για την υλοποίηση του SSO. Πρώτα θα περιγράψουμε τη συνολική αρχιτεκτονική, θα δώσουμε παραδείγματα και λεπτομερή βήματα.
Υπάρχει επίσης κάποια τεκμηρίωση σχετικά με τη μετεγκατάσταση από άλλους παρόχους με παρόμοιους μηχανισμούς SSO, και οι διαφορές.
Η ροή μοιάζει ως εξής:
Εφόσον το Secure SSO περιλαμβάνει full-stack ανάπτυξη, πλήρη λειτουργικά παραδείγματα κώδικα σε Java/Spring, NodeJS/Express, και vanilla PHP βρίσκονται αυτήν τη στιγμή στο GitHub.
Παρόλο που χρησιμοποιούμε ExpressJS στο παράδειγμα NodeJS και Spring στο παράδειγμα Java, δεν απαιτούνται frameworks/βιβλιοθήκες σε αυτά τα runtimes για την υλοποίηση του FastComments SSO - τα εγγενή πακέτα κρυπτογράφησης λειτουργούν.
Δεν χρειάζεται να γράψετε νέα API endpoints με το FastComments SSO. Απλώς κρυπτογραφήστε τις πληροφορίες του χρήστη χρησιμοποιώντας το μυστικό κλειδί σας και περάστε το payload στο comment widget.
Get Your API Secret Key
Το API Secret σας μπορεί να ανακτηθεί από αυτή τη σελίδα. Μπορείτε επίσης να βρείτε αυτή τη σελίδα πηγαίνοντας στο My Account, κάνοντας κλικ στο πλακίδιο API/SSO, και στη συνέχεια κάνοντας κλικ στο "Get API Secret Key".
Comment Widget Parameters
Η υψηλού επιπέδου τεκμηρίωση API για το comment widget βρίσκεται εδώ.
Ας δούμε με περισσότερες λεπτομέρειες τι σημαίνουν αυτοί οι παράμετροι.
Το comment widget παίρνει ένα αντικείμενο διαμόρφωσης - ήδη το περνάτε αν χρησιμοποιείτε το FastComments για να περάσετε το tenantId.
Για να ενεργοποιήσετε το SSO, περάστε ένα νέο αντικείμενο "sso", το οποίο πρέπει να έχει τις ακόλουθες παραμέτρους. Οι τιμές πρέπει να δημιουργούνται στην πλευρά του server.
- userDataJSONBase64: Τα δεδομένα του χρήστη σε μορφή JSON, τα οποία στη συνέχεια κωδικοποιούνται σε Base64.
- verificationHash: Το HMAC-SHA256 hash που δημιουργείται από UNIX_TIME_MILLIS + userDataJSONBase64.
- timestamp: Epoch timestamp, σε milliseconds. Δεν πρέπει να είναι στο μέλλον, ή περισσότερο από δύο ημέρες στο παρελθόν.
- loginURL: Ένα URL που το comment widget μπορεί να εμφανίσει για να συνδέσει τον χρήστη.
- logoutURL: Ένα URL που το comment widget μπορεί να εμφανίσει για να αποσυνδέσει τον χρήστη.
- loginCallback: Όταν παρέχεται αντί για το login URL, μια συνάρτηση που το comment widget θα καλεί όταν κάνετε κλικ στο κουμπί login.
- logoutCallback: Όταν παρέχεται αντί για το logout URL, μια συνάρτηση που το comment widget θα καλεί όταν κάνετε κλικ στο κουμπί logout.
The User Object
The User object contains the following schema:
Moderators and Administrators
Για admins και moderators, περάστε τα αντίστοιχα flags isAdmin ή isModerator στο αντικείμενο SSOUser.
Notifications
Για να ενεργοποιήσετε ή να απενεργοποιήσετε τις ειδοποιήσεις, ορίστε την τιμή του optedInNotifications σε true ή false αντίστοιχα. Την πρώτη φορά που ο χρήστης φορτώνει τη σελίδα με αυτή την τιμή στο SSO payload, οι ρυθμίσεις ειδοποιήσεων του θα ενημερωθούν.
Επιπλέον, αν θέλετε οι χρήστες να λαμβάνουν ειδοποιήσεις μέσω email για δραστηριότητα στις σελίδες στις οποίες έχουν εγγραφεί (αντί μόνο ειδοποιήσεων εντός της εφαρμογής), τότε ορίστε το optedInSubscriptionNotifications σε true.
VIP Users & Special Labels
Μπορείτε να εμφανίσετε μια ειδική ετικέτα δίπλα στο όνομα του χρήστη χρησιμοποιώντας το προαιρετικό πεδίο "displayLabel".
Unauthenticated users
Για να αναπαραστήσετε έναν μη αυθεντικοποιημένο χρήστη, απλώς μην συμπληρώσετε τα userDataJSONBase64, verificationHash, ή timestamp. Παρέχετε ένα loginURL.
Αυτοί οι χρήστες δεν θα μπορούν να σχολιάσουν, και αντ' αυτού θα τους παρουσιαστεί ένα μήνυμα σύνδεσης (μήνυμα, σύνδεσμος, ή κουμπί, ανάλογα με τη διαμόρφωση).
Direct Examples for Serializing and Hashing User Data
Περισσότερες λεπτομέρειες και παραδείγματα εδώ (js), εδώ (java) και εδώ (php).
Κατανοούμε ότι οποιαδήποτε ενσωμάτωση μπορεί να είναι μια πολύπλοκη και επίπονη διαδικασία. Μη διστάσετε να επικοινωνήσετε με τον αντιπρόσωπό σας ή να χρησιμοποιήσετε τη σελίδα υποστήριξης.
Προσαρμοσμένες ενσωματώσεις - Απλή ενιαία σύνδεση (SSO)
Με το Simple SSO, μπορούμε να παρέχουμε στο widget σχολιασμού πληροφορίες για τον χρήστη ώστε να μην χρειάζεται να εισάγει το όνομα χρήστη ή το email του για να σχολιάσει.
Μπορούμε να ρυθμίσουμε το Simple SSO ως εξής:
Run Ο χρήστης θα έχει συνδεθεί, και θα δημιουργηθεί ένας SSO χρήστης στο παρασκήνιο. Ο χρήστης θα έχει createdFromSimpleSSO ορισμένο σε true αν ανακτηθεί από το API.
Σημειώσεις:
- Το email είναι ο μοναδικός αναγνωριστής για το Simple SSO.
- Δεν απαιτείται να παρέχεται email με το Simple SSO, ωστόσο από προεπιλογή τα σχόλιά τους θα εμφανίζονται ως «Μη επαληθευμένο». Εάν δεν δοθεί email, ο χρήστης δεν μπορεί να πιστοποιηθεί πλήρως.
- ΝΕΟ Από τον Ιανουάριο 2022: Τα ονόματα χρήστη δεν χρειάζεται να είναι μοναδικά σε όλο το fastcomments.com
- Το Simple SSO μπορεί αυτόματα να δημιουργεί και να ενημερώνει SSO χρήστες, εφόσον παρέχεται email και ο χρήστης δεν δημιουργήθηκε αρχικά από το Secure SSO.
- Μπορείτε να καθορίσετε badges για τον χρήστη με την ιδιότητα
badgeConfig. Ο πίνακαςbadgeIdsπεριέχει τα IDs των badges που θα συσχετιστούν με τον χρήστη. Εάν τοoverrideείναι ορισμένο σεtrue, θα αντικαταστήσει όλα τα υπάρχοντα badges που εμφανίζονται στα σχόλια· εάν σεfalse, θα προσθέσει στα υπάρχοντα badges.
Προσαρμοσμένες ενσωματώσεις - Μετάβαση από Disqus SSO
Οι μεγαλύτερες διαφορές μεταξύ του Disqus και του FastComments Secure SSO είναι ότι το Disqus χρησιμοποιεί SHA1 για την κρυπτογράφηση ενώ εμείς χρησιμοποιούμε SHA256.
Αυτό σημαίνει ότι η μετάβαση από το Disqus είναι εύκολη - αλλάξτε τον αλγόριθμο κατακερματισμού που χρησιμοποιείται από SHA1 σε SHA256 και ενημερώστε τα ονόματα ιδιοτήτων που περνιούνται στο UI.
Προσαρμοσμένες ενσωματώσεις - Μετάβαση από Commento SSO
Commento χρησιμοποιεί μια ριζικά διαφορετική προσέγγιση SSO - απαιτούν να έχετε ένα endpoint που καλούν για να αυθεντικοποιήσουν τον χρήστη. FastComments είναι το αντίθετο - απλώς encode και hash τις πληροφορίες του χρήστη χρησιμοποιώντας το secret key σας και τις προωθείτε.
Προστασία νημάτων σχολίων με ενιαία σύνδεση
FastComments SSO (λεπτομέρειες εδώ) παρέχει στους χρήστες σας έναν τρόπο να σχολιάζουν χωρίς να χρειάζεται να συνδεθούν σε άλλη πλατφόρμα.
Ωστόσο, αυτό από μόνο του δεν ασφαλίζει τις συζητήσεις σχολίων σας, καθώς από προεπιλογή τα δεδομένα των σχολίων είναι δημόσια διαθέσιμες πληροφορίες - οποιοσδήποτε μπορεί να δει τη σελίδα μπορεί να δει και τα σχόλια.
Αλλάζοντας μια ρύθμιση, μπορούμε να περιορίσουμε την ανάκτηση σχολίων εκτός αν γίνεται από διαχειριστή ή έγκυρο χρήστη SSO.
No-Code Setup
Μπορούμε να αποτρέψουμε την προβολή και την αλληλεπίδραση με τις συζητήσεις σχολίων μας, όταν το SSO έχει ρυθμιστεί, δημιουργώντας έναν κανόνα προσαρμογής.
Κάνοντας αυτό, αναζητήστε SSO και θα βρείτε αυτήν την επιλογή:
Ενεργοποιήστε την και αποθηκεύστε τον κανόνα προσαρμογής.
Only Protect a Certain Domain or Page
Για να προστατέψετε μόνο ένα συγκεκριμένο Domain ή Σελίδα, απλά θα ρυθμίσετε αντίστοιχα τον κανόνα προσαρμογής.
Στην κορυφή της διεπαφής προσαρμογής, θα βρείτε δύο πεδία, Domain και URL ID.
Για να προστατέψετε ένα συγκεκριμένο domain, εισάγετε το αντίστοιχο domain στο πεδίο "domain".
Για να προστατέψετε μια συγκεκριμένη σελίδα, εισάγετε το URL της σελίδας στο πεδίο "URL ID". Εάν έχετε μια προσαρμοσμένη ενσωμάτωση με το FastComments, μπορείτε να εισάγετε εδώ έναν τύπο ID αντί για URL.
Security Levels
Όταν απαιτείτε SSO, θα πρέπει να αποφασίσετε αν απαιτείτε Simple SSO ή Secure SSO. Εάν απαιτήσετε Simple SSO, τότε επιτρέπονται και τα δύο, αλλά εάν απαιτήσετε Secure SSO τότε το περιεχόμενο πρέπει να ανακτηθεί με ένα Secure SSO payload που έχει κατακερματιστεί με το API key σας προκειμένου να προβληθεί.
Η επιλογή επιπέδου ασφάλειας θα εμφανιστεί όταν επιλέξετε "Require SSO To View Comments".
Protection Beyond Reading
Η ενεργοποίηση αυτής της επιλογής θα προστατεύσει τη σελίδα ή το domain από σχολιασμό εκτός αν ο χρήστης είναι συνδεδεμένος μέσω SSO.
Gotchas
Οποιοιδήποτε χρήστες δημιούργησαν σχόλια πριν την ενσωμάτωση του SSO σας δεν θα μπορούν να τα δουν, εκτός αν συνδεθούν μέσω της ενσωμάτωσης SSO σας.
Επιτρέπονται ανώνυμα σχόλια
Κατά προεπιλογή, το FastComments θα απαιτεί ένα email για να σχολιάσει κάποιος. Δεν χρειάζεται να είναι έγκυρη διεύθυνση email, ωστόσο μέχρι ο χρήστης να κάνει κλικ σε έναν σύνδεσμο που του έχει σταλεί, το σχόλιό του θα εμφανίζει μια ετικέτα "Μη επαληθευμένο σχόλιο".
Ωστόσο, μπορούμε να καταργήσουμε την απαίτηση για email. Το πεδίο εισαγωγής email θα εξακολουθεί να εμφανίζεται, αλλά δεν θα είναι πλέον υποχρεωτικό.
Αυτό μπορεί να ρυθμιστεί μέσω της διεπαφής προσαρμογής του widget:
Αποτροπή λήξης ανώνυμων σχολίων
FastComments μπορεί να ρυθμιστεί ώστε να αφαιρεί μη επαληθευμένα σχόλια μετά από έναν επιθυμητό αριθμό ημερών. Αυτό βοηθά στην καταπολέμηση του spam.
Από προεπιλογή, δεν το κάνει.
Αυτό μπορεί να ρυθμιστεί, ή να απενεργοποιηθεί, μέσω της σελίδας Ρυθμίσεις Μετριασμού.
Απενεργοποίηση πεδίων email
Όταν οι χρήστες σχολιάζουν και δεν έχουν συνδεθεί, θα τους ζητηθεί να δώσουν το email τους.
Αυτό θα δημιουργήσει μια "μη επαληθευμένη συνεδρία" για αυτόν τον χρήστη, και θα τους ζητήσουμε να επαληθεύσουν αυτή τη συνεδρία μέσω email.
Για ορισμένους ιστότοπους ή εφαρμογές, είναι επιθυμητό να μην ζητείται από τον χρήστη το email όταν σχολιάζει ή ψηφίζει.
Η ενεργοποίηση ανώνυμων σχολιασμών κάνει το πεδίο εισαγωγής email προαιρετικό. Ωστόσο, μπορούμε να το απενεργοποιήσουμε εντελώς. Πρώτα, ενεργοποιήστε τους ανώνυμους σχολιασμούς, και μετά θα εμφανιστεί η επιλογή για την απενεργοποίηση των πεδίων εισαγωγής email.
Με αυτό ενεργοποιημένο, τα πεδία email δεν θα εμφανίζονται καθόλου σε όλα τα προϊόντα σχολιασμού μας.
Σημειώστε ότι, με αυτή τη διαμόρφωση, όλα τα σχόλια θα είναι μη επαληθευμένα εκτός αν ο χρήστης δημιουργήσει έναν λογαριασμό και συνδεθεί στο https://fastcomments.com.
Ίσως θελήσετε να εξετάσετε την απενεργοποίηση της ετικέτας μη επαληθευμένο.
Απενεργοποίηση ετικέτας μη επαληθευμένου
Κατά προεπιλογή, το FastComments θα εμφανίζει μια ετικέτα "Μη Επαληθευμένο Σχόλιο" για σχόλια που έχουν υποβληθεί για έναν χρήστη που έχει μη επαληθευμένη συνεδρία περιήγησης. Διαβάστε περισσότερα σχετικά με το μη επαληθευμένο σχολιασμό εδώ.
Run Επιπλέον, αυτή η δυνατότητα μπορεί να χρησιμοποιηθεί, χωρίς να γράψετε κώδικα, στο UI Προσαρμογής:
Επιτρέπονται ανώνυμες ψήφοι
Όταν οι χρήστες προσπαθούν να ψηφίσουν ένα σχόλιο και δεν έχουν συνδεθεί, θα τους ζητηθεί να δώσουν το όνομα χρήστη και το email τους.
Μπορούμε να καταργήσουμε αυτήν την απαίτηση, επιτρέποντας σε οποιονδήποτε να ψηφίσει ένα σχόλιο χωρίς να αφήσει καμία πληροφορία.
Ορισμός προεπιλεγμένου ονόματος χρήστη
Όταν οι χρήστες σχολιάζουν ή ψηφίζουν, και δεν έχουν συνδεθεί, θα τους ζητηθεί να παρέχουν τη διεύθυνση email και το όνομα χρήστη τους.
Σε περίπτωση ανώνυμων σχολίων, μερικές φορές είναι επιθυμητό να οριστεί ένα προεπιλεγμένο όνομα χρήστη για να μειωθεί η τριβή κατά το σχολιασμό. Αυτό μπορεί να γίνει από το UI Προσαρμογής. Η δυνατότητα ανώνυμων σχολίων πρέπει να ενεργοποιηθεί πρώτα.
Συναρτήσεις επανάκλησης
Όλες οι βιβλιοθήκες για το widget σχολίων (προς το παρόν Angular, React, Vue) υποστηρίζουν callbacks.
Τα callbacks ορίζονται στο αντικείμενο ρυθμίσεων, με την ίδια υπογραφή για κάθε βιβλιοθήκη.
Τα υποστηριζόμενα callbacks είναι:
- onInit
- onAuthenticationChange
- onRender
- commentCountUpdated
- onReplySuccess
- onVoteSuccess
- onImageClicked
- onOpenProfile
- onCommentSubmitStart
- onCommentsRendered
Οι ακριβείς υπογραφές μπορούν να βρεθούν στους Ορισμούς TypeScript.
Ακολουθεί ένα παράδειγμα με όλα τα callbacks:
Run Χειροκίνητος ορισμός τοπικής ρύθμισης του χρήστη
By default, FastComments will render the comment widget in the locale determined by the user's system and browser.
When a user comments or logs in, we update their last used locale and use this for sending emails, as well.
This impacts how the commenting widget is translated for the user. Locale consists of the user's language and region, so configuring locale will usually change the language used to show text to the user.
Via The UI
This can be defined using the widget customization UI. See the "Locale / Language" option:
Via Code
This can be overridden with a desired locale.
Run Supported Languages and Locale Codes
You can find the complete list of supported languages and the corresponding locale codes here.
SSO Note
If you're using SSO, you might want to pass the user's locale in the user object, so that emails and other things are localized correctly for them.
Περιορισμός επιτρεπόμενων γλωσσών
Από προεπιλογή, το FastComments δεν περιορίζει τις γλώσσες που χρησιμοποιούνται για σχολιασμό.
Μπορεί να είναι επιθυμητό να περιοριστούν οι γλώσσες που χρησιμοποιεί μια κοινότητα.
Αυτό μπορεί να ρυθμιστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Το σύστημα θα αναλύσει το σχόλιό τους και θα προσδιορίσει τη γλώσσα του, και στη συνέχεια θα το συγκρίνει με τη λίστα επιτρεπόμενων γλωσσών.
Εάν το σχόλιο είναι γραμμένο σε γλώσσα που δεν επιτρέπεται, τότε εμφανίζεται ένα τοπικοποιημένο μήνυμα σφάλματος.
Τίτλοι σελίδων
Ο τρέχων τίτλος της σελίδας συσχετίζεται με το καθορισμένο urlId και αποθηκεύεται για χρήση στα εργαλεία εποπτείας.
Από προεπιλογή, αυτό ανακτάται από το document.title.
Εάν θέλετε, μπορείτε να καθορίσετε τον δικό σας τίτλο σελίδας ως εξής:
Run Αποτροπή νέων απαντήσεων και απενεργοποίηση ψήφων
Τα σχόλια μπορούν να κλειδωθούν ώστε να μην μπορούν να προστεθούν νέα σχόλια ή ψήφοι ορίζοντας τη σημαία readonly σε true.
Τα σχόλια επίσης δεν θα μπορούν να επεξεργαστούν ή να διαγραφούν.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, για ολόκληρο domain, ή σελίδα:
Ενημέρωση!
Από τον Νοέμβριο του 2022, τα νήματα μπορούν να κλειδωθούν ή να ξεκλειδωθούν σε πραγματικό χρόνο από διαχειριστές και συντονιστές μέσω του μενού με τις τρεις τελείες πάνω από την περιοχή απάντησης.
Αυτό θα εμποδίσει νέα σχόλια, ενώ εξακολουθεί να επιτρέπει τις ψήφους και να επιτρέπει στους χρήστες να διαγράφουν τα σχόλιά τους εάν το επιθυμούν, ενώ readonly δεν επιτρέπει αυτά.
Αυτό αντιστοιχεί στο πεδίο isClosed στο API Page.
Περιορισμός τομέων συνδέσμων
Εξ ορισμού, το FastComments επιτρέπει τη σύνδεση προς οποιονδήποτε εξωτερικό ιστότοπο.
Αυτό μπορεί να περιοριστεί σε μια επιθυμητή λίστα ιστότοπων ή τομέων. Η προσπάθεια δημοσίευσης ενός συνδέσμου προς ιστότοπο ή τομέα, που δεν περιλαμβάνεται στη λίστα που έχει οριστεί θα προκαλέσει την εμφάνιση σφάλματος στον χρήστη.
Αυτή η επαλήθευση ισχύει μόνο για το Widget Σχολίων και το API. Οι εισαγωγές δεν επηρεάζονται.
Αυτό γίνεται χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Αριθμός σχολίων και καταμέτρηση όλων των εμφωλευμένων απαντήσεων
Ο αριθμός σχολίων που εμφανίζεται στην κορυφή του widget σχολίων μπορεί είτε να δείχνει όλα τα σχόλια πρώτου επιπέδου, δηλαδή εκείνες τις απαντήσεις που είναι απαντήσεις απευθείας στη σελίδα ή το άρθρο, ή μπορεί να είναι μέτρηση όλων των εμφωλευμένων σχολίων.
Προεπιλεγμένα, αυτό είναι true - είναι μέτρηση του δεύτερου - όλων των σχολίων. Σε παλαιότερες εκδόσεις του widget σχολίων το
προεπιλεγμένο είναι false.
Μπορούμε να αλλάξουμε τη συμπεριφορά, ώστε να είναι μέτρηση όλων των εμφωλευμένων σχολίων ορίζοντας τη σημαία countAll σε true.
Run Εάν θέλαμε ο αριθμός να αντικατοπτρίζει μόνο τα σχόλια πρώτου επιπέδου, ορίζουμε τη σημαία σε false.
Run Αυτό δεν μπορεί αυτή τη στιγμή να προσαρμοστεί χωρίς αλλαγές στον κώδικα.
Ενεργοποίηση συνδέσμων σχολιαστών
Από προεπιλογή, το FastComments θα ζητάει μόνο από τον χρήστη το σχόλιό του, το όνομα χρήστη του και το email του.
Ωστόσο, σε ορισμένες περιπτώσεις μπορεί να θέλετε ο χρήστης να αφήνει έναν σύνδεσμο προς το προσωπικό του blog ή ιστότοπο.
Μπορούμε να ενεργοποιήσουμε την εμφάνιση ενός επιπλέον πεδίου εισαγωγής για να αφήσει ο χρήστης το URL του ιστότοπου, ρυθμίζοντας τη σημαία enableCommenterLinks σε true:
Run Όταν δοθεί αυτό το URL, ο λογαριασμός του χρήστη θα ενημερωθεί και όλα τα ονόματα χρήστη σε όλα τα προηγούμενα και μελλοντικά σχόλια θα συνδέονται με αυτό το URL.
Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Ομάδες εποπτείας
Μια λίστα με αναγνωριστικά που δημιουργούνται από τη σελίδα Ομάδες Επιτήρησης.
Όταν καθορίζεται, τα σχόλια που αφήνονται χρησιμοποιώντας την καθορισμένη διαμόρφωση θα περιέχουν το ίδιο σύνολο moderationGroupIds.
Εάν ένας Moderator έχει ορίσει μία ή περισσότερες Ομάδες Επιτήρησης,
θα βλέπουν μόνο τα σχόλια στη σελίδα Moderate Comments που σχετίζονται με την ομάδα/τις ομάδες τους.
Run Αναφορά αναγνωριστικών ομάδων
Μια λίστα με ids για χρήση στην αυτόματη συμπλήρωση των @mentions. Χρήσιμο όταν θέλετε να αποτρέψετε τη σήμανση χρηστών όταν δεν έχουν κοινές ομάδες.
Όταν καθορίζεται, μόνο χρήστες από άλλες ομάδες θα εμφανίζονται στην αυτόματη συμπλήρωση μετά την πληκτρολόγηση του χαρακτήρα @.
Run Παράκαμψη cookies τρίτων
Για την αυθεντικοποίηση, το FastComments εξαρτάται από τα τρίτα cookies να είναι ενεργοποιημένα στο πρόγραμμα περιήγησής σας. Χωρίς αυτά, οι χρήστες θα πρέπει πάντα να αφήνουν το email τους για να σχολιάσουν (εκτός αν το πεδίο εισαγωγής email είναι κρυφό), και τα σχόλιά τους θα εμφανίζονται πάντα ως μη επαληθευμένα (από προεπιλογή).
Για να το παρακάμψετε, μπορείτε να ενεργοποιήσετε την παράκαμψη τρίτων cookies.
Όταν αυτή η ρύθμιση είναι ενεργοποιημένη, προκαλεί ένα μικρό αναδυόμενο παράθυρο που εμφανίζει ένα μήνυμα που λέει ότι ο χρήστης συνδέεται. Αυτό το αναδυόμενο παράθυρο εμφανίζεται όποτε ο χρήστης αλληλεπιδρά με το widget σχολίων· για παράδειγμα, αν αφήσει ένα σχόλιο.
Μπορούμε να το κάνουμε στον κώδικα ορίζοντας τη σημαία enableThirdPartyCookieBypass σε true:
Run Μπορούμε επίσης να το ρυθμίσουμε μέσω του UI Προσαρμογής Widget, στην επιλογή Enable Third-Party Cookie Popup:
Διαγραφή σχολίων με απαντήσεις
Από προεπιλογή, οι χρήστες μπορούν να διαγράψουν τα δικά τους σχόλια. Επίσης, η διαγραφή του σχολίου τους διαγράφει αυτόματα όλα τα θυγατρικά και προσωρινά σχόλια στο νήμα. Αυτή η συμπεριφορά ισχύει επίσης στο ζωντανό περιβάλλον.
Μπορείτε να περιορίσετε αυτό με τους εξής τρόπους:
- Αντί για αυτό, ανωνυμοποιήστε το διαγραμμένο σχόλιο (ορίστε το όνομα και το κείμενο σε
[deleted]ή σε προσαρμοσμένη τιμή). - Μην επιτρέπετε τη διαγραφή σχολίων όταν υπάρχουν απαντήσεις. Εμφανίζεται ένα προσαρμόσιμο μήνυμα σφάλματος.
- Περιορίστε τη δυνατότητα διαγραφής όταν ένα σχόλιο έχει απαντήσεις ώστε να επιτρέπεται μόνο σε διαχειριστές και συντονιστές.
Αυτό μπορεί να ρυθμιστεί μέσω της ενότητας Comment Thread Deletion στην διεπαφή προσαρμογής του widget.
Εμφάνιση διακριτικών στην κορυφαία μπάρα
Από προεπιλογή, το FastComments θα εμφανίζει τα διακριτικά των χρηστών μόνο στα σχόλιά τους μέσα στη ροή σχολίων.
Ωστόσο, μπορούμε να εμφανίσουμε τα διακριτικά των χρηστών δίπλα στο όνομά τους πάνω από τη φόρμα σχολίου ενεργοποιώντας αυτή τη δυνατότητα στη σελίδα προσαρμογής του widget:
Αυτό θα εμφανίσει τα διακριτικά του χρήστη δίπλα στο όνομά του στην επάνω γραμμή, κάνοντας τα επιτεύγματά του και την κατάστασή του πιο εμφανή όταν συντάσσει ένα σχόλιο.
Σημειώστε ότι αυτή η δυνατότητα πρέπει να είναι ενεργοποιημένη στο UI προσαρμογής του widget για να λειτουργήσει. Μπορείτε προαιρετικά να ορίσετε τη σημαία showBadgesInTopBar σε false στη ρύθμιση της διαμόρφωσης του κώδικά σας για να την απενεργοποιήσετε επιλεκτικά ακόμη και όταν είναι ενεργοποιημένη στο επίπεδο του server:
Run