Προσαρμογές και Ρυθμίσεις
Προσαρμογές και Διαμόρφωση
Πλαίσιο
Εδώ θα βρείτε εκτενή τεκμηρίωση για κάθε μία από τις λειτουργίες και τις ρυθμίσεις που υποστηρίζει το 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 της σελίδας και θα το καθαρίσουμε για να αφαιρέσουμε τυχόν κοινές παραμέτρους μάρκετινγκ ή αναγνωριστικά παρακολούθησης.
Στην περίπτωση ενσωματώσεων τρίτων, όπως το WordPress, το πρόσθετό μας συνήθως χρησιμοποιεί τον αναγνωριστή που αντιπροσωπεύει τις τρέχουσες πληροφορίες που προβάλλονται ως URL ID, για παράδειγμα το αναγνωριστικό του άρθρου/σελίδας.
Run Ένα πράγμα στο οποίο θα αναφερόμαστε συχνά σε αυτό το έγγραφο είναι η Διεπαφή Προσαρμογής Widget.
Αυτή η διεπαφή μπορεί να χρησιμοποιηθεί για να κάνετε πολλές αλλαγές στο widget σχολίων χωρίς να γράψετε κώδικα.
Κατά τη δημιουργία ενός κανόνα προσαρμογής, συχνά θέλουμε να ισχύει για όλες τις σελίδες του ιστότοπού μας. Ωστόσο, σε ορισμένες περιπτώσεις θέλουμε να προσαρμόσουμε το widget σχολίων σε μια συγκεκριμένη σελίδα, είτε για να εφαρμόσουμε προσαρμοσμένο στυλ, είτε για να κάνουμε τα σχόλια για εκείνη τη σελίδα ανώνυμα. Μπορείτε επίσης, για παράδειγμα, να έχετε ζωντανά σχόλια να εμφανίζονται αμέσως σε ορισμένες σελίδες, ενώ να τα κρύβετε πίσω από κουμπιά ειδοποίησης σε άλλες.
Όλα αυτά είναι δυνατόν μέσω του πεδίου εισαγωγής URL ID σε αυτή τη σελίδα, το οποίο φαίνεται ως εξής:
Η τιμή σε αυτό το πεδίο πρέπει να ταιριάζει με την παράμετρο urlId που περνιέται στο widget σχολίων. Εάν θέλετε ο κανόνας προσαρμογής σας να είναι ανεξάρτητος από το urlId, αφήστε αυτό το πεδίο κενό ή εισάγετε *.
Από το 2023, το πεδίο URL ID στην προσαρμογή του widget δέχεται επίσης μοτίβα! Για παράδειγμα, μπορείτε να έχετε */blog/* για να προσθέσετε στυλ ειδικά για το blog σας και */store/* για να έχετε στυλ ειδικά για το κατάστημά σας, ενώ χρησιμοποιείτε τον ίδιο τομέα.
Πιθανές παγίδες
- Αν η σελίδα σας έχει παραμέτρους hash (π.χ. example.com#page-1) - αυτό θα γίνει μέρος του URL ID, από προεπιλογή.
- Κατά τη διάρκεια μεταναστεύσεων, για παράδειγμα από WordPress σε Gatsby, μπορεί να χρειαστεί να μεταφέρετε τις τιμές σχολίων URL ID μετά την αρχική μεταφορά. Για αυτό, επικοινωνήστε μαζί μας.
Εμφάνιση των ίδιων σχολίων σε διαφορετικές σελίδες
Δεδομένου ότι η παράμετρος urlId μας επιτρέπει να ορίσουμε σε ποια σελίδα, ή id, συνδέονται τα σχόλια, μπορούμε απλώς να θέσουμε την urlId στην ίδια τιμή σε αυτές τις σελίδες.
Run Προσαρμοσμένο στυλ
Το FastComments έχει σχεδιαστεί ώστε να προσαρμόζεται. Το widget σχολίων εκτελείται μέσα σε iframe για λόγους ασφαλείας, οπότε για να εφαρμόσετε προσαρμοσμένο στυλ πρέπει να ακολουθήσετε μία από τις δύο προσεγγίσεις.
Η πρώτη, η πιο εύκολη προσέγγιση, και η προτιμώμενη από εμάς, είναι να χρησιμοποιήσετε τη σελίδα προσαρμογής widget.
Στη σελίδα προσαρμογής widget, δείτε την ενότητα «Εμφάνιση Προχωρημένων Επιλογών», κάτω από την οποία υπάρχει μια περιοχή με την ετικέτα «Προσαρμοσμένο CSS»:
Αυτή η προσέγγιση έχει ορισμένα πλεονεκτήματα:
- Το εισαχθέν CSS συμπιέζεται (minified) πριν αποσταλεί στον χρήστη, και η μορφοποίηση παραμένει συνεπής στη διεπαφή επεξεργασίας.
- Λαμβάνετε όλα τα πλεονεκτήματα της διεπαφής προσαρμογής widget, π.χ. εύκολη προσαρμογή του widget σχολίων διαφορετικά για διαφορετικούς ιστότοπους.
- Όταν κάνουμε αλλαγές στο widget σχολίων, το προσαρμοσμένο στυλ σας θα δοκιμάζεται ως μέρος της διαδικασίας κυκλοφορίας μας.
Η δεύτερη προσέγγιση είναι να καθορίσετε την παράμετρο customCSS στη διαμόρφωση του widget, ως εξής:
Run Ωστόσο, αυτή έχει περιορισμούς:
- Υπάρχει όριο στο πόσο προσαρμοσμένο CSS μπορεί να περαστεί πριν οι διακομιστές μας απορρίψουν το αίτημα, λόγω του μεγέθους των κεφαλίδων.
- Πρέπει να διαχειρίζεστε το προσαρμοσμένο CSS στην υποδομή και το σύστημα κατασκευής σας. Αυτό μπορεί να είναι ένα πλεονέκτημα αντί μειονέκτημα, επίσης.
- Υπάρχει επιπλέον κόστος αποστολής του προσαρμοσμένου CSS μέσω του δικτύου δύο φορές σε αυτήν τη χρήση, καθώς πρέπει να σταλεί στους διακομιστές μας και στη συνέχεια να επιστραφεί στο περιεχόμενο του iframe. Ωστόσο, για τα περισσότερα μεγέθη φορτίου, αυτό δεν είναι αισθητό.
- Μια κοινή βελτιστοποίηση είναι η συμπίεση (minifying) του CSS για μείωση του μεγέθους του στο δίκτυο, όμως με αυτήν την προσέγγιση θα πρέπει να το διαχειριστείτε εσείς.
- Το προσαρμοσμένο CSS σας δεν θα δοκιμαστεί όταν κάνουμε αλλαγές.
Εξωτερικά Αρχεία CSS
Μπορείτε να ζητήσετε από το widget να φορτώσει ένα εξωτερικό αρχείο χρησιμοποιώντας @import!
Συνιστάται να τοποθετήσετε το @import σε κανόνα προσαρμογής. Με αυτόν τον τρόπο, αν χρειαστεί ποτέ να κάνουμε αλλαγή στο widget σχολίων, μπορούμε να χρησιμοποιήσουμε τα αυτοματοποιημένα εργαλεία μας για να επαληθεύσουμε τη ρύθμισή σας. Έτσι, για παράδειγμα, θα δημιουργούσατε έναν κανόνα προσαρμογής στη διεπαφή προσαρμογής Widget, θα κάνατε κλικ στο «Προχωρημένα» και θα εισάγατε στο «Custom CSS»:
@import url(https://example.com/styles.css);Στον Κώδικα - Δεν Συνιστάται
Μπορείτε επίσης να φορτώσετε ένα εξωτερικό αρχείο CSS μέσω της ιδιότητας customCSS:
Run Ωστόσο, θυμηθείτε ότι το CSS σας δεν θα μπορεί να δοκιμαστεί από εμάς αν το κάνετε αυτό.
Στυλ του Modal Προφίλ Χρήστη
Τα modal προφίλ χρήστη μπορούν επίσης να στιλιζαριστούν με προσαρμοσμένο CSS. Ωστόσο, για να διασφαλιστεί ότι το προσαρμοσμένο στυλ εφαρμόζεται στα προφίλ χρηστών, όλοι οι CSS selectors πρέπει να έχουν πρόθεμα .user-profile. Χωρίς αυτό το πρόθεμα, το προσαρμοσμένο στυλ θα αγνοηθεί για τα modal προφίλ χρήστη.
Για παράδειγμα:
Run Συμβατότητα Παλαιότερων Εκδόσεων
Στο FastComments, γνωρίζουμε ότι οι πελάτες μας προσαρμόζουν το widget σχολίων. Αυτό είναι σχεδιασμένο – το τελευταίο που θέλουμε είναι το προϊόν μας να προκαλεί ασυνέπειες σχεδίασης στο δικό σας προϊόν.
Δεδομένου ότι αυτό αποτελεί σημαντικό μέρος του προϊόντος μας, διαθέτουμε μια γραμμή παραγωγής που μας επιτρέπει να ελέγχουμε τις αλλαγές στο widget σχολίων, ανά πελάτη, σε κάθε κυκλοφορία.
Αν εντοπίσουμε μικρά ζητήματα, θα ενημερώσουμε τον λογαριασμό σας ώστε η κυκλοφορία μας να προχωρήσει ομαλά. Αν δούμε σημαντικές αλλαγές που σπάζουν τη λειτουργία, αυτό μας επιτρέπει να σταματήσουμε την κυκλοφορία.
Προσαρμοσμένες γραμματοσειρές
Το 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 σχολίων μεταφράζεται βάσει της τοπικής ρύθμισης του χρήστη. Ωστόσο, μπορούμε να αντικαταστήσουμε το κείμενο, εάν είμαστε σίγουροι ότι η βάση χρηστών μας χρησιμοποιεί την ίδια τοπική γλώσσα, για παράδειγμα:
Run Όλες οι προσαρμόσιμες μεταφράσεις μπορούν να βρεθούν εδώ under the "advanced options" tab.
Ωστόσο, υπάρχει ένας πιο εύκολος τρόπος, μέσω του widget customization UI. Εκεί, μπορούμε απλώς να βρούμε το κείμενο που εμφανίζεται στο commenting widget στην τοπική ρύθμιση EN_US και να ορίσουμε μια αντικατάσταση.
Όλες οι παρακάμψεις μεταφράσεων επηρεάζουν επί του παρόντος όλες τις τοπικές ρυθμίσεις.
Αλλαγή της προεπιλεγμένης εικόνας προφίλ
Όταν ένας χρήστης σχολιάζει με FastComments για πρώτη φορά, θα προσπαθήσουμε να λάβουμε το avatar του από https://gravatar.com/.
Ωστόσο, εάν δεν βρούμε avatar ή ο χρήστης δεν έχει ορίσει ποτέ ένα στο λογαριασμό του, θα εμφανίσουμε μια στατική προεπιλεγμένη εικόνα avatar.
Για να καθορίσετε τη δική σας στατική εικόνα avatar, μπορείτε να χρησιμοποιήσετε τη ρύθμιση defaultAvatarSrc.
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής widget, δείτε την ενότητα "Default Avatar".
Σημειώστε ότι ο ορισμός του avatar για έναν συγκεκριμένο χρήστη, όπως με το SSO, καλύπτεται σε δική του ενότητα.
Απενεργοποίηση εικόνων προφίλ
Τα avatar μπορούν να αφαιρεθούν εντελώς από το widget σχολίων, ακόμη και αν οι χρήστες έχουν ορίσει το δικό τους avatar.
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 γίνονται προσθέτοντας ορατές ετικέτες αγκύρωσης όπως <b></b> γύρω από το κείμενό σας. Κάνοντας κλικ στη γραμμή εργαλείων
ή χρησιμοποιώντας συντομεύσεις γίνεται αυτό για εσάς. Ωστόσο, ορισμένες κοινότητες μπορεί να θέλουν να ενεργοποιήσουν τη μορφοποίηση χωρίς ετικέτες αγκύρωσης. Αυτό ονομάζεται ενεργοποίηση του
WYSIWYG (what you see is what you get) επεξεργαστή. Αυτός ο επεξεργαστής φαίνεται ακριβώς όπως ο προεπιλεγμένος, εκτός από το ότι φορτώνει επιπλέον
κώδικα που επιτρέπει στους χρήστες να κάνουν έντονη γραφή, υπογράμμιση, κ.λπ. το κείμενό τους χωρίς ορατές ετικέτες αγκύρωσης.
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής widget, δείτε την επιλογή "Enable Advanced Formatting" option.
Απενεργοποίηση της γραμμής εργαλείων
Από προεπιλογή, το FastComments θα εμφανίζει μια γραμμή εργαλείων κατά τη σύνταξη ενός σχολίου για να παρέχει συντομεύσεις για τη διακόσμηση κειμένου και τη μεταφόρτωση εικόνων.
Αυτή η γραμμή εργαλείων μπορεί να απενεργοποιηθεί μέσω κώδικα ή με το UI προσαρμογής.
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής widget, δείτε την επιλογή "Disable The Reply Toolbar".
Απενεργοποίηση αποκλεισμού
Από προεπιλογή, το 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, στην ενότητα Προηγμένες Επιλογές. Θα πρέπει πρώτα να ενεργοποιήσετε τις Απόλυτες Ημερομηνίες για να δείτε αυτήν την επιλογή στη διεπαφή χρήστη.
Προσθήκη κειμένου επικεφαλίδας
Κάποιο κείμενο, όπως μια κεφαλίδα ή μήνυμα, μπορεί να εμφανιστεί κάτω από τον αριθμό σχολίων αλλά πάνω από το κείμενο κατάστασης σύνδεσης.
Αυτό το αποκαλούμε κεφαλίδα και, από προεπιλογή, είναι κρυμμένο.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής widget, κάτω από τις Προηγμένες Επιλογές:
Απόδοση συνδέσμων ως κείμενο
Από προεπιλογή, το FastComments θα αποδίδει συνδέσμους όπως αυτός: https://exmaple.com - όπου το URL του συνδέσμου γίνεται ένα κλικ‑δυνατό
HTML anchor tag.
Ορισμένοι ιστότοποι μπορεί να θέλουν να απενεργοποιήσουν αυτό, για παράδειγμα για να αποτρέψουν απατεώνες. Παρέχουμε αυτό ορίζοντας την Comment HTML Rendering Option σε Links as Text.
Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής widget, για ολόκληρο το domain ή τη σελίδα:
Εναλλαγή σχολίων με κουμπί
Από προεπιλογή, το FastComments θα αποδίδει το πλαίσιο εισαγωγής σχολίου και τη νήμα σχολίων ταυτόχρονα. Για να εξοικονομήσει κάποιο κάθετο χώρο, θα κρύβει επίσης τυχόν άλλα απαιτούμενα πεδία μέχρι να αλληλεπιδράσει ο χρήστης με το widget.
Ωστόσο, το widget σχολίων μπορεί να κρύβεται πίσω από ένα κουμπί, για παράδειγμα:
Το κουμπί χρησιμοποιεί διαφορετικό μεταφρασμένο κείμενο ανάλογα με το αν τα σχόλια εμφανίζονται αυτή τη στιγμή ή όχι. Αν τα σχόλια είναι κρυμμένα, χρησιμοποιεί translations.SHOW_COMMENTS_BUTTON_TEXT. Αν το
σχόλια είναι εμφανισμένα, χρησιμοποιεί translations.HIDE_COMMENTS_BUTTON_TEXT. Οι μεταφράσεις μπορούν να περιέχουν το κείμενο [count] που θα
αντικατασταθεί με τον τοπικοποιημένο αριθμό.
Run Αυτό έχει σχεδιαστεί για να αντικαταστήσει τη ρύθμιση hideCommentsUnderCountTextFormat.
Ο αριθμός ενημερώνεται ζωντανά με τη νήμα σχολίων. Το κουμπί δεν εμφανίζεται εάν δεν υπάρχουν σχόλια.
Αυτό μπορεί να ενεργοποιηθεί χωρίς κώδικα δημιουργώντας έναν κανόνα προσαρμογής και ενεργοποιώντας το "Κλικ για Εμφάνιση Σχολίων":
Προσαρμογή κειμένου μετρητή σχολίων
Ο αριθμός σχολίων που εμφανίζεται στην κορυφή του widget σχολίων μπορεί να προσαρμοστεί.
Αυτό μπορεί να αντικατασταθεί με οποιαδήποτε συμβολοσειρά, και η τιμή [count] θα αντικατασταθεί με την τιμή του αριθμού, τοπικοποιημένη για τον χρήστη.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
![Πεδίο κειμένου αριθμού σχολίων στη σελίδα προσαρμογής widget, όπου το [count] αντικαθίσταται με το ζωντανό σύνολο](/images/da3eefd88b26e32283c1ca7c9d0b9680.png)
Απενεργοποίηση ανακατεύθυνσης εικόνας
Από προεπιλογή, το FastComments επιτρέπει στους χρήστες να ανεβάζουν εικόνες. Όταν ο χρήστης κάνει κλικ σε αυτήν την εικόνα, το FastComments, από προεπιλογή, θα ανοίξει μια νέα καρτέλα για να εμφανίσει την εικόνα σε πλήρες μέγεθος. Η ρύθμιση αυτής της σημαίας σε true απενεργοποιεί αυτή τη συμπεριφορά:
Run Αν δεν σκοπεύετε να χειριστείτε εσείς το κλικ στην εικόνα (βλέπε onImageClicked), συνιστούμε να το συνδυάσετε με κάποια στυλ ώστε να αφαιρέσετε την εντύπωση ότι η εικόνα μπορεί να γίνει κλικ.
Απενεργοποίηση αυτόματης δημιουργίας hashtags
Όταν οι χρήστες εισάγουν hashtags, με τη μορφή #someexampletag, το FastComments θα δημιουργήσει αυτόματα το HashTag και
θα το επισημάνει στο σχόλιό τους.
Σε ορισμένες περιπτώσεις είναι επιθυμητό να απενεργοποιηθεί αυτή η λειτουργία ή να ελεγχθεί ποια hashtags μπορούν να χρησιμοποιηθούν μέσω του API.
Για να το κάνετε αυτό, απλώς ενεργοποιήστε το Disable Automatic #hashtag Creation μέσω του UI Προσαρμογής Widget.
Απενεργοποίηση κουδουνιού ειδοποιήσεων
Από προεπιλογή, το FastComments θα εμφανίζει ένα κουδούνι ειδοποιήσεων στην επάνω δεξιά γωνία της περιοχής σχολίων.
Αυτό το κουδούνι θα γίνεται κόκκινο και θα εμφανίζει έναν αριθμό που δείχνει τον αριθμό των ειδοποιήσεων που έχει ο χρήστης. Μερικά παραδείγματα ειδοποιήσεων είναι:
- Ο χρήστης σας απάντησε.
- Ο χρήστης απάντησε σε νήμα στο οποίο σχολιάσατε.
- Ο χρήστης έδωσε θετική ψήφο στο σχόλιό σας.
- Ο χρήστης απάντησε σε μια σελίδα στην οποία έχετε εγγραφεί.
Το κουδούνι ειδοποιήσεων παρέχει επίσης έναν μηχανισμό για εγγραφή σε ολόκληρη τη σελίδα, επίσης.
Ωστόσο, μπορούμε να απενεργοποιήσουμε εντελώς το κουδούνι ειδοποιήσεων:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα «Απενεργοποίηση κουδουνιού ειδοποιήσεων».
Απενεργοποίηση προφίλ
Από προεπιλογή, το FastComments θα εμφανίζει το προφίλ του χρήστη όταν κάνετε κλικ στο avatar του.
Ωστόσο, μπορούμε να απενεργοποιήσουμε αυτή τη λειτουργία:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής widget, δείτε την ενότητα "Απενεργοποίηση Προφίλ".
Απενεργοποίηση σχολίων προφίλ
Από προεπιλογή, το FastComments θα εμφανίζει μια "Profile Comments" καρτέλα στα προφίλ χρηστών, επιτρέποντας στους επισκέπτες να αφήνουν σχόλια στο προφίλ κάποιου.
Ωστόσο, μπορούμε να απενεργοποιήσουμε αυτήν την καρτέλα:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής widget, δείτε την ενότητα "Disable Profile Comments".
Απενεργοποίηση άμεσων μηνυμάτων προφίλ
Από προεπιλογή, το FastComments θα εμφανίζει μια καρτέλα «Άμεσες Μηνύματα» στα προφίλ των χρηστών, επιτρέποντας στους επισκέπτες να στέλνουν άμεσα μηνύματα σε έναν χρήστη.
Ωστόσο, μπορούμε να απενεργοποιήσουμε αυτήν την καρτέλα:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα «Απενεργοποίηση Άμεσων Μηνυμάτων».
Απενεργοποίηση μηνύματος επιτυχίας
Από προεπιλογή, το FastComments εμφανίζει ένα μήνυμα επιτυχίας μετά το σχόλιο. Αυτό μπορεί να απενεργοποιηθεί ως εξής:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής widget:
Αλλαγή της κατάταξης περιεχομένου των GIF
Από προεπιλογή, το FastComments comment widget θα ορίσει μια gif rating τιμής pg.
Διαθέσιμες επιλογές είναι g, pg, pg-13 και r.
Αυτό μπορεί να οριστεί στον κώδικα ή μέσω του UI. Στον κώδικα μπορούμε να το κάνουμε ως εξής:
Run Στο UI, θα το βρείτε κάτω από Gif Picker Rating εφόσον η επιλογή Disable Image Uploads? δεν είναι επιλεγμένη.
Διαχείριση περιεχομένου εικόνων
Από προεπιλογή, το widget σχολίων FastComments έχει την επαλήθευση περιεχομένου εικόνας απενεργοποιημένη off.
Διαθέσιμες επιλογές είναι off, low, medium και high.
Στο UI προσαρμογής του widget, θα το βρείτε κάτω από Image Content Moderation Level εφόσον δεν είναι επιλεγμένο το Disable Image Uploads?.
Αλλαγή στυλ ψηφοφορίας
Από προεπιλογή, το FastComments θα εμφανίζει τις επιλογές ψηφοφορίας ως βέλη πάνω και κάτω, επιτρέποντας στους χρήστες να ψηφίσουν είτε θετικά είτε αρνητικά ένα σχόλιο.
Ωστόσο, είναι δυνατόν να αλλάξετε το στυλ της γραμμής εργαλείων ψηφοφορίας. Οι τρέχουσες επιλογές είναι τα προεπιλεγμένα κουμπιά Πάνω/Κάτω ή η χρήση μηχανισμού ψηφοφορίας σε στυλ Καρδιάς.
Χρησιμοποιούμε τη σημαία voteStyle ως εξής:
Run Σας συνιστούμε έντονα να το κάνετε αυτό χωρίς κώδικα, καθώς ενεργοποιεί επίσης επικυρώσεις στην πλευρά του διακομιστή. Στη σελίδα προσαρμογής widget, δείτε την ενότητα "Στυλ Ψηφοφορίας".
Η ψηφοφορία μπορεί επίσης να απενεργοποιηθεί, δείτε το Απενεργοποίηση ψηφοφορίας πάνω από τις επιλογές στυλ.
Απενεργοποίηση διαγραφής
Από προεπιλογή, το FastComments θα επιτρέπει στους χρήστες να διαγράφουν τα σχόλιά τους.
Ωστόσο, είναι δυνατόν να αποτραπεί αυτό.
Στη σελίδα προσαρμογής widget, δείτε την επιλογή "Απενεργοποίηση Διαγραφής".
- Αυτό επηρεάζει μόνο τους κανονικούς Σχολιαστές και όχι τους συντονιστές ή διαχειριστές, οι οποίοι θα μπορούν ακόμη να διαγράψουν.
- Αυτό θα επηρεάσει επίσης τις ενσωματώσεις API όταν περνιέται το
contextUserId.
Απενεργοποίηση επεξεργασίας
Από προεπιλογή, το FastComments θα επιτρέπει στους χρήστες να επεξεργάζονται τα σχόλιά τους.
Ωστόσο, είναι δυνατόν να αποτραπεί αυτό.
Στη σελίδα προσαρμογής widget, δείτε την επιλογή "Απενεργοποίηση Επεξεργασίας".
- Αυτό επηρεάζει μόνο τους κανονικούς Σχολιαστές και όχι τους συντονιστές ή διαχειριστές, οι οποίοι θα μπορούν ακόμη να επεξεργάζονται.
- Αυτό θα επηρεάσει επίσης τις ενσωματώσεις API όταν περνιέται το
contextUserId.
Επισήμανση νέων σχολίων
FastComments παρέχει αρκετούς τρόπους για να επισημαίνονται τα νέα σχόλια.
Πρωτίστως, από προεπιλογή, τα σχόλια που προκάλεσαν μια εντός-εφαρμογής ειδοποίηση (απαντήσεις, απαντήσεις στο ίδιο νήμα ή σχόλια σε μια σελίδα
στην οποία είστε εγγεγραμμένοι), θα επισημαίνονται αυτόματα με το avatar του χρήστη να λάμπει ελαφρώς. Το χρώμα μπορεί να προσαρμοστεί μέσω CSS
χρησιμοποιώντας την κλάση is-unread.
Στα σχόλια που δημοσιεύτηκαν τις τελευταίες 24 ώρες εφαρμόζεται η κλάση 24hr που μπορεί να χρησιμοποιηθεί για στυλ.
Τέλος, οποιαδήποτε νέα σχόλια σε πραγματικό χρόνο που εμφανίζονται στη συνεδρία του χρήστη θα επισημαίνονται για μερικά δευτερόλεπτα μέσω μιας κινούμενης εικόνας. Αυτό γίνεται μέσω της
κλάσης CSS is-live και μπορεί επίσης να προσαρμοστεί.
Μεγέθη σελίδων
Από προεπιλογή, το μέγεθος σελίδας του FastComments είναι 30. Αυτό περιλαμβάνει τις απαντήσεις σε νήματα.
Το μέγεθος σελίδας μπορεί να προσαρμοστεί στη Widget Configuration UI σε διάφορα μεγέθη που κυμαίνονται από 10 έως 200.
Σημειώστε ότι η αλλαγή του μεγέθους σελίδας απαιτεί επανυπολογισμό όλων των νήματων σχολίων στον λογαριασμό σας. Αυτό μπορεί να διαρκέσει λίγα λεπτά.
Αυτό δεν μπορεί να ρυθμιστεί στο widget της πλευράς πελάτη, καθώς οι σελίδες υπολογίζονται από τον διακομιστή.
Παράδειγμα διαμόρφωσης φαίνεται παρακάτω:
Τα μεγέθη σελίδας μπορούν να προσαρμοστούν παγκοσμίως, ή ανά domain, ή ανά σελίδα, δημιουργώντας διαφορετικούς κανόνες προσαρμογής.
Αυτό θα επηρεάσει όλους τους πελάτες, τις ενσωματώσεις και τα πλαίσια εργασίας που ενδέχεται να χρησιμοποιείτε για την εμφάνιση σχολίων μέσω της πλατφόρμας μας.
Πρότυπα email
Τα email που αποστέλλονται από το FastComments στους πελάτες σας μπορούν να προσαρμοστούν. Το πρότυπο, η λογική, και οι μεταφράσεις μπορούν όλες να τροποποιηθούν. Το κείμενο μπορεί να προσαρμοστεί ανά τοπική ρύθμιση, και το στυλ μπορεί ακόμη να αλλάξει ανά τομέα. Μάθετε περισσότερα για τα προσαρμοσμένα πρότυπα email εδώ.
Μορφές ονομάτων χρήστη
Από προεπιλογή, το FastComments θα εμφανίζει το όνομα του χρήστη όπως το εισήγαγε, ή όπως του μεταβιβάστηκε μέσω SSO.
Ωστόσο, μπορεί να είναι επιθυμητό να καλυφθεί ή να εμφανιστεί το όνομα του χρήστη με διαφορετικό τρόπο. Για παράδειγμα, εάν το όνομα του χρήστη είναι Allen Rex, ίσως θέλετε να εμφανίζεται μόνο «Allen R.».
Αυτό μπορεί να γίνει χωρίς κώδικα στη διεπαφή προσαρμογής Widget, κάτω από τη ρύθμιση που ονομάζεται Commenter Name Format:
Οι διαθέσιμες μορφές είναι:
- Capitalize (εμφανίζει το παράδειγμα χρήστη ως Example User)
- Last Initial (εμφανίζει το Example User ως Example U.)
- All Initials (εμφανίζει το Example User ως E. U.)
- Εμφάνιση "Anonymous"
Η επίδραση της αλλαγής είναι άμεση. Οι χρήστες θα εξακολουθούν να βλέπουν το πλήρες όνομα χρήστη τους στην κορυφή της περιοχής σχολίων, για τον εαυτό τους, αλλά τα σχόλιά τους θα εμφανίζουν το τροποποιημένο όνομα χρήστη.
Τα ονόματα χρηστών καλύπτονται από τον διακομιστή για την προστασία των χρηστών.
Απενεργοποίηση μεταφόρτωσης εικόνων
Από προεπιλογή, το FastComments επιτρέπει τη μεταφόρτωση εικόνων. Αυτό μπορεί να απενεργοποιηθεί ορίζοντας τη σημαία noImageUploads σε true.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής widget:
Επιτρέψτε ενσωμάτωση πολυμέσων
By default FastComments does not allow iframes in comments. When you enable media embeds, commenters can paste the embed code (the <iframe> snippet) from trusted providers like YouTube, Vimeo, SoundCloud, and Spotify, and it will render inline in the comment.
For security, this is not a client-side widget config flag. It is a server-side setting, validated when each comment is saved, so it cannot be turned on from the page. Only iframes pointing at a built-in list of trusted providers are allowed. Any other iframe is removed.
This is done without code, on the widget customization page:
Adding Your Own Providers
If you want to allow embeds from a provider that is not on the built-in trusted list, add its hostname in the "Πρόσθετοι Τομείς Ενσωμάτωσης" field on the same page. These hostnames are allowed in addition to the built-in providers. Matching is exact, so include the full hostname (for example, player.example.com). Anything you do not list stays blocked.
Both the plain comment box and the WYSIWYG editor support pasting an embed. In the WYSIWYG editor the embed is inserted as a removable block.
Ενεργοποίηση πεδίου αναζήτησης
Από προεπιλογή, δεν εμφανίζεται πλαίσιο αναζήτησης στο widget σχολίων.
Ωστόσο, μπορούμε να το ενεργοποιήσουμε ορίζοντας τη σημαία enableSearch σε true:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Ενεργοποίηση Πλαισίου Αναζήτησης".
Ενεργοποίηση spoilers
Μπορούμε να ενεργοποιήσουμε την υποστήριξη σπόιλερ ορίζοντας τη σημαία enableSpoilers σε true:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής widget, δείτε την επιλογή "Ενεργοποίηση Σπόιλερ".
Όταν το κείμενο επισημαίνεται και το τώρα ορατό κουμπί SPOILER πατιέται, το κείμενο θα καλύπτεται μέχρι ο χρήστης να το περάσει με το ποντίκι. Για τη σκοτεινή λειτουργία κάνουμε το ίδιο, με διαφορετικά χρώματα που ταιριάζουν καλύτερα στη σκοτεινή λειτουργία.
Αυτό είναι επίσης συμβατό με τον επεξεργαστή WYSIWYG.
Ενεργοποίηση εμφάνισης αριθμού προβολών σχολίων
Από προεπιλογή, το FastComments δεν παρακολουθεί ποιος είδε κάθε σχόλιο ούτε παρέχει στατιστικά σχετικά με αυτό.
Ωστόσο, μπορούμε να ενεργοποιήσουμε αυτή τη λειτουργία, και τότε το σύστημα θα αρχίσει να παρακολουθεί καθώς κάθε χρήστης κάνει κύλιση σε ένα σχόλιο.
Όταν συμβαίνει αυτό, ένας μετρητής δίπλα σε ένα εικονίδιο ματιού που εμφανίζεται σε κάθε σχόλιο θα αυξηθεί. Ο μετρητής ενημερώνεται ζωντανά και συντομεύεται ανάλογα με τη γλώσσα του χρήστη.
Μπορούμε να το ενεργοποιήσουμε ορίζοντας τη σημαία enableViewCounts σε true:
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής widget:
Καταγράφουμε το αναγνωριστικό χρήστη* που είδε το σχόλιο, ώστε αν το δείτε ξανά δεν να αυξηθεί. Αν το δείτε ξανά μετά από δύο χρόνια, ο μετρητής θα αυξηθεί περισσότερο.
- *Σημείωση: ή το ανώνυμο αναγνωριστικό συνεδρίας, ή τη διεύθυνση IP του χρήστη ως κωδικοποιημένη τιμή.
Εμφάνιση ζωντανών σχολίων αμέσως
Από προεπιλογή, η ζωντανή σχολιαστική λειτουργία είναι ενεργοποιημένη. Αυτό σημαίνει ότι εάν προστεθούν, διαγραφούν, επεξεργαστούν ή καρφιτσωθούν σχόλια, οι αλλαγές θα πρέπει να εμφανίζονται σε όλους τους χρήστες που βλέπουν το νήμα σχολίων ταυτόχρονα.
Ωστόσο, από προεπιλογή, αυτά τα νέα σχόλια θα εμφανίζονται κάτω από ένα δυναμικά εμφανιζόμενο κουμπί με κείμενο παρόμοιο με «Εμφάνιση 2 Νέων Σχολίων».
Εάν τα νέα σχόλια είναι απαντήσεις απευθείας στη σελίδα, το κουμπί θα εμφανίζεται στην κορυφή του νήματος σχολίων. Εάν είναι απαντήσεις σε ένα συγκεκριμένο σχόλιο, το κουμπί θα εμφανίζεται κάτω από εκείνο το σχόλιο.
Αυτό γίνεται για να αποτραπεί η συνεχής αλλαγή του μεγέθους της σελίδας για τον χρήστη, κάτι που μπορεί να προκαλέσει απογοήτευση όταν προσπαθεί να πιάσει τη γραμμή κύλισης.
Για ορισμένες περιπτώσεις χρήσης, όπως ζωντανές δημοπρασίες ή διαδικτυακά γεγονότα, αυτή δεν είναι η επιθυμητή συμπεριφορά – μπορεί να θέλετε το widget σχολίων να λειτουργεί περισσότερο σαν «συνομιλία», όπου τα νέα σχόλια εμφανίζονται αμέσως.
Άρα, το όνομα της σημαίας που ενεργοποιεί αυτή τη λειτουργία: showLiveRightAway.
Μπορούμε να το ενεργοποιήσουμε ως εξής:
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Απενεργοποίηση σχολιασμού σε πραγματικό χρόνο
Από προεπιλογή, το FastComments θα έχει ενεργοποιημένα τα ζωντανά σχόλια.
Αυτό σημαίνει ότι κάθε θεατής της αλυσίδας σχολίων πρέπει να βλέπει το ίδιο περιεχόμενο.
Για παράδειγμα, εάν προστεθεί ένα σχόλιο, αυτό το σχόλιο πρέπει να εμφανιστεί. Εάν ένα σχόλιο επεξεργαστεί ή αφαιρεθεί, τότε αυτά τα σχόλια θα επεξεργαστούν ή αφαιρεθούν για όλους τους θεατές της αλυσίδας. Το ίδιο ισχύει για τις ψήφους και όλες τις ενέργειες διαχείρισης.
Ωστόσο, μπορούμε να το απενεργοποιήσουμε:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Disable Live Commenting".
Νέα ζωντανά σχόλια στο κάτω μέρος
Συνήθως, τα νέα ζωντανά σχόλια εμφανίζονται στην κορυφή της λίστας σχολίων καθώς δημοσιεύονται σε πραγματικό χρόνο.
Όταν αυτή η επιλογή είναι ενεργοποιημένη, τα νέα ζωντανά σχόλια θα προστεθούν στο κάτω μέρος της λίστας. Αυτό επηρεάζει τον τρόπο εμφάνισης των σχολίων όταν δημοσιεύονται ζωντανά ενώ οι χρήστες βλέπουν το νήμα σχολίων.
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 θα ταξινομεί τα σχόλια με τη διεύθυνση ταξινόμησης «Πιο Σχετικό».
Η ταξινόμηση Πιο Σχετικό λαμβάνει υπόψη το χρόνο που αφήθηκε το σχόλιο και τον αριθμό των ψήφων για την ταξινόμηση.
Ο χρήστης μπορεί στη συνέχεια να αλλάξει τη διεύθυνση ταξινόμησης είτε σε Παλαιότερα είτε σε Νεότερα Πρώτα στη διεπαφή του widget σχολίων.
Ωστόσο, μπορούμε να αλλάξουμε την προεπιλογή ώστε να είναι οποιαδήποτε από τις τρεις. Για παράδειγμα, αν θέλετε να εμφανίσετε πρώτα τα παλαιότερα σχόλια:
Run Ορίζουμε την τιμή του defaultSortDirection σε "OF" για να ορίσουμε τη διεύθυνση σε "OF".
Για τη διεύθυνση ταξινόμησης νεότερα πρώτα, θα κάναμε το εξής:
Run Οι έγκυρες τιμές για το defaultSortDirection είναι:
- MR: "Πιο Πρόσφατο"
- NF: "Νεότερα Πρώτα"
- OF: "Παλαιότερα Πρώτα"
Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Default Sort Direction".
Σημειώστε ότι τα σχόλια σε κάθε σελίδα για κάθε διεύθυνση ταξινόμησης προϋπολογίζονται εκ των προτέρων, έτσι όλες οι διευθύνσεις ταξινόμησης έχουν την ίδια απόδοση.
Εμφάνιση όλων των σχολίων ταυτόχρονα - Απενεργοποίηση σελιδοποίησης
Για να απενεργοποιήσετε τη σελιδοποίηση και να εμφανίσετε απλώς όλα τα σχόλια ταυτόχρονα, ορίστε το startingPage σε -1.
Run Μετακίνηση του πλαισίου απάντησης μετά τα σχόλια
Από προεπιλογή η περιοχή εισαγωγής σχολίων είναι πριν τη σειρά σχολίων. Ωστόσο, ορίζοντας αυτήν τη ρύθμιση σε true μπορούμε να τη μετακινήσουμε μετά.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής widget:
Περιορισμός μήκους σχολίου
Ο μέγιστος αριθμός χαρακτήρων που επιτρέπεται να εισαχθεί στο πεδίο εισαγωγής σχολίου μπορεί να περιοριστεί από την παράμετρο maxCommentCharacterLength.
Η προεπιλογή είναι 2000.
Τέτοια στοιχεία όπως URLs εικόνων δεν περιλαμβάνονται στον υπολογισμό του μήκους.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής widget:
Απενεργοποίηση σχολίων πολλαπλών γραμμών
Από προεπιλογή, το FastComments θα επιτρέψει στον χρήστη να εισάγει ένα σχόλιο με όσες γραμμές θέλει, μέχρι το προεπιλεγμένο όριο χαρακτήρων.
Ωστόσο, μπορεί να είναι επιθυμητό να περιοριστεί ο χρήστης στην εισαγωγή μόνο μιας γραμμής κειμένου. Μερικά παραδείγματα χρήσης περιλαμβάνουν διαδικτυακές δημοπρασίες ή ζωντανή συνομιλία, για τα οποία μπορεί να χρησιμοποιηθεί το FastComments.
Ενεργοποιούμε τη σημαία useSingleLineCommentInput ως εξής:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής widget, δείτε την ενότητα "Enable Single-Line Comment Input".
Σημειώστε ότι τα σχόλια σε κάθε σελίδα για κάθε κατεύθυνση ταξινόμησης προ-υπολογίζονται, έτσι όλες οι κατευθύνσεις ταξινόμησης έχουν την ίδια απόδοση.
Περιορισμός αριθμού σχολίων ανά χρήστη
Από προεπιλογή, κάθε χρήστης μπορεί να υποβάλει έως 5 comments στο ίδιο λεπτό.
Αυτό παρακολουθείται με βάση το user id, το anon user id και τη διεύθυνση ip (hashed).
Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Σημειώστε ότι εάν χρησιμοποιείτε το API δημιουργίας σχολίων, ίσως θέλετε να περάσετε τη αρχική ip διεύθυνση του χρήστη στο αίτημα προς το backend μας, ώστε ο περιορισμός ταχύτητας να εφαρμόζεται
ανά χρήστη και όχι παγκοσμίως στον λογαριασμό σας.
Απαγόρευση νέων σχόλιων ανώτατου επιπέδου
Ορίζοντας το noNewRootComments σε true θα προκαλέσει το widget να αποκρύψει την περιοχή απάντησης ρίζας, αλλά θα επιτρέψει
ακόμα στους χρήστες να απαντούν σε υποσχόλια. Για παράδειγμα, μπορείτε να το ορίσετε υπό όρους κατά τη φόρτωση της σελίδας ώστε να επιτρέπεται μόνο σε κάποιους χρήστες να αφήνουν σχόλια πρώτου επιπέδου.
Run Μέγιστο βάθος απαντήσεων
Εξ ορισμού, το FastComments επιτρέπει απεριόριστη εμφώλευση απαντήσεων, δημιουργώντας μια δομή νήματος όπου οι χρήστες μπορούν να απαντούν σε απαντήσεις επ' αόριστον.
Η επιλογή maxReplyDepth σας επιτρέπει να περιορίσετε πόσο βαθιά μπορούν να φτάσουν τα νήματα απαντήσεων. Όταν επιτευχθεί το μέγιστο βάθος, οι χρήστες δεν θα βλέπουν πλέον κουμπί απάντησης στα σχόλια σε αυτό το επίπεδο.
Run Με το maxReplyDepth ορισμένο σε 2:
- Οι χρήστες μπορούν να σχολιάζουν στο ανώτατο επίπεδο (επίπεδο 0)
- Οι χρήστες μπορούν να απαντούν σε σχόλια κορυφαίου επιπέδου (επίπεδο 1)
- Οι χρήστες μπορούν να απαντούν σε αυτές τις απαντήσεις (επίπεδο 2)
- Δεν επιτρέπονται περαιτέρω απαντήσεις πέρα από το επίπεδο 2
Ο ορισμός σε 1 θα επέτρεπε μόνο απαντήσεις σε σχόλια κορυφαίου επιπέδου, δημιουργώντας μια πιο επίπεδη δομή συζήτησης.
Ο ορισμός του maxReplyDepth σε 0 θα απενεργοποιούσε όλες τις απαντήσεις, επιτρέποντας μόνο σχόλια κορυφαίου επιπέδου. Εάν δεν οριστεί, οι απαντήσεις μπορούν να εμφωλευτούν χωρίς όριο.
Απαίτηση αποδοχής Όρων Χρήσης
FastComments σας επιτρέπει να απαιτείτε από τους σχολιαστές που σχολιάζουν για πρώτη φορά να αποδεχτούν τους Όρους Χρήσης σας πριν υποβάλουν ένα σχόλιο.
Όταν είναι ενεργοποιημένο:
- Ανώνυμοι χρήστες θα βλέπουν ένα πλαίσιο ελέγχου TOS κάθε φορά που σχολιάζουν
- Πιστοποιημένοι χρήστες θα βλέπουν το πλαίσιο ελέγχου μόνο στο πρώτο τους σχόλιο, ή όταν ενημερώνετε τους Όρους Χρήσης σας
Διαμόρφωση
Μεταβείτε στη σελίδα προσαρμογής του widget και ενεργοποιήστε το πλαίσιο ελέγχου «Απαιτείται αποδοχή των Όρων Χρήσης». Μόλις ενεργοποιηθεί, θα δείτε τις παρακάτω επιλογές:
- Λειτουργία κειμένου TOS: Από προεπιλογή, το πλαίσιο ελέγχου εμφανίζει «Συμφωνώ με τους Όρους Χρήσης και την Πολιτική Απορρήτου» με συνδέσμους και στα δύο έγγραφα. Επιλέξτε «Προσαρμογή κειμένου ανά τοπική γλώσσα» για να παρέχετε το δικό σας κείμενο για κάθε γλώσσα.
- Ημερομηνία τελευταίας ενημέρωσης TOS: Όταν ενημερώνετε τους Όρους Χρήσης, ορίστε αυτήν την ημερομηνία. Οι χρήστες που αποδέχτηκαν πριν από αυτήν την ημερομηνία θα χρειαστεί να αποδεχτούν ξανά.
Πώς Λειτουργεί
- Η χρονική σήμανση αποδοχής των Όρων Χρήσης αποθηκεύεται ανά χρήστη και ανά σχόλιο
- Όταν ένας χρήστης αποδέχεται τους Όρους Χρήσης, η ημερομηνία καταγράφεται στο προφίλ του χρήστη (ανά ενοικιαστή)
- Εάν ορίσετε μια ημερομηνία «Τελευταίας ενημέρωσης» που είναι μετά την ημερομηνία αποδοχής του χρήστη, θα χρειαστεί να αποδεχτεί ξανά
- Για ανώνυμους χρήστες που δεν μπορούν να παρακολουθηθούν, το πλαίσιο ελέγχου εμφανίζεται σε κάθε υποβολή σχολίου
Επισκόπηση Single Sign-On (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. Δείτε την τεκμηρίωση: την τεκμηρίωση.
Προσαρμοσμένες ενσωματώσεις - Ασφαλές Single Sign-On (SSO)
FastComments Secure SSO χρησιμοποιεί κρυπτογράφηση HMAC‑SHA256 ως μηχανισμό για την υλοποίηση του SSO. Πρώτα θα εξετάσουμε τη συνολική αρχιτεκτονική, θα παρέχουμε παραδείγματα και λεπτομερή βήματα.
Υπάρχει επίσης τεκμηρίωση σχετικά με τη μετάβαση από άλλους παρόχους με παρόμοιους μηχανισμούς SSO, και τις διαφορές.
Η ροή φαίνεται ως εξής:
Δεδομένου ότι το Secure SSO περιλαμβάνει ανάπτυξη full‑stack, πλήρη παραδείγματα κώδικα σε Java/Spring, NodeJS/Express και vanilla PHP είναι επί του παρόντος στο GitHub.
Αν και χρησιμοποιούμε ExpressJS στο παράδειγμα NodeJS και Spring στο παράδειγμα Java, δεν απαιτούνται frameworks/βιβλιοθήκες σε αυτά τα περιβάλλοντα εκτέλεσης για την υλοποίηση του FastComments SSO - τα ενσωματωμένα πακέτα κρυπτογράφησης λειτουργούν.
Δεν χρειάζεται να γράψετε νέα API endpoints με το FastComments SSO. Απλώς κρυπτογραφήστε τις πληροφορίες του χρήστη χρησιμοποιώντας το μυστικό κλειδί σας και περάστε το payload στο widget σχολίων.
Λάβετε το Μυστικό Κλειδί API σας
Το Μυστικό API σας μπορεί να ληφθεί από αυτή τη σελίδα. Μπορείτε επίσης να βρείτε αυτή τη σελίδα πηγαίνοντας στο My Account, κάνοντας κλικ στο πλακίδιο API/SSO και, στη συνέχεια, κάνοντας κλικ στο "Λάβετε το Μυστικό Κλειδί API".
Παράμετροι Widget Σχολίων
Η τεκμηρίωση API υψηλού επιπέδου για το widget σχολίων μπορεί να βρεθεί εδώ.
Ας εμβαθύνουμε περισσότερο στο τι σημαίνουν αυτές οι παράμετροι.
Το widget σχολίων δέχεται ένα αντικείμενο διαμόρφωσης - το περνάτε ήδη αν χρησιμοποιείτε το FastComments για να περάσετε το αναγνωριστικό πελάτη σας (ονομάζεται tenantId).
Για να ενεργοποιήσετε το SSO, περάστε ένα νέο αντικείμενο "sso", το οποίο πρέπει να περιέχει τις ακόλουθες παραμέτρους. Οι τιμές πρέπει να δημιουργούνται από τον διακομιστή.
- userDataJSONBase64: Τα δεδομένα του χρήστη σε μορφή JSON, τα οποία κωδικοποιούνται στη συνέχεια σε Base64.
- verificationHash: Το hash HMAC‑SHA256 που δημιουργείται από UNIX_TIME_MILLIS + userDataJSONBase64.
- timestamp: Χρονική σήμανση Epoch, σε χιλιοστά του δευτερολέπτου. Δεν πρέπει να είναι στο μέλλον ή περισσότερο από δύο ημέρες στο παρελθόν.
- loginURL: Ένα URL που το widget σχολίων μπορεί να εμφανίσει για να συνδέσει τον χρήστη.
- logoutURL: Ένα URL που το widget σχολίων μπορεί να εμφανίσει για να αποσυνδέσει τον χρήστη.
- loginCallback: Όταν παρέχεται αντί του login URL, μια συνάρτηση που το widget σχολίων θα καλέσει όταν ο χρήστης κάνει κλικ στο κουμπί σύνδεσης.
- logoutCallback: Όταν παρέχεται αντί του logout URL, μια συνάρτηση που το widget σχολίων θα καλέσει όταν ο χρήστης κάνει κλικ στο κουμπί αποσύνδεσης.
Το Αντικείμενο Χρήστη
Συντονιστές και Διαχειριστές
Για διαχειριστές και συντονιστές, περάστε τις αντίστοιχες σημαίες isAdmin ή isModerator στο αντικείμενο SSOUser.
Ειδοποιήσεις
Για να ενεργοποιήσετε ή να απενεργοποιήσετε τις ειδοποιήσεις, ορίστε την τιμή του optedInNotifications σε true ή false αντίστοιχα. Την πρώτη φορά που ο χρήστης φορτώνει τη σελίδα με αυτήν την τιμή στο payload SSO, οι ρυθμίσεις ειδοποιήσεων του θα ενημερωθούν.
Επιπλέον, εάν θέλετε οι χρήστες να λαμβάνουν email ειδοποιήσεις για δραστηριότητα σε σελίδες στις οποίες έχουν εγγραφεί (αντί για απλώς ειδοποιήσεις στην εφαρμογή), ορίστε το optedInSubscriptionNotifications σε true.
Χρήστες VIP & Ειδικές Ετικέτες
Μπορείτε να εμφανίσετε μια ειδική ετικέτα δίπλα στο όνομα του χρήστη χρησιμοποιώντας το προαιρετικό πεδίο "displayLabel".
Μη Αυθεντικοποιημένοι Χρήστες
Για να αντιπροσωπεύσετε έναν μη αυθεντικοποιημένο χρήστη, απλώς μην συμπληρώσετε τα userDataJSONBase64, verificationHash ή timestamp. Παρέχετε ένα loginURL.
Αυτοί οι χρήστες δεν θα μπορούν να σχολιάσουν, και αντί αυτού θα εμφανιστεί ένα μήνυμα σύνδεσης (μήνυμα, σύνδεσμος ή κουμπί, ανάλογα με τη διαμόρφωση).
Άμεσα Παραδείγματα για Σειριοποίηση και Κατακερματισμό Δεδομένων Χρήστη
Περισσότερες λεπτομέρειες ως παραδείγματα εδώ (js), εδώ (java) και εδώ (php).
Καταλαβαίνουμε ότι οποιαδήποτε ενσωμάτωση μπορεί να είναι μια πολύπλοκη και επίπονη διαδικασία. Μην διστάσετε να επικοινωνήσετε με τον αντιπρόσωπό σας ή να χρησιμοποιήσετε τη σελίδα υποστήριξης.
Προσαρμοσμένες ενσωματώσεις - Απλό Single Sign-On (SSO)
Με το Simple SSO, μπορούμε να παρέχουμε στο widget σχολιασμού πληροφορίες για τον χρήστη ώστε να μην χρειάζεται να εισάγει το όνομα χρήστη ή το email του για να σχολιάσει.
Μπορούμε να διαμορφώσουμε το Simple SSO ως εξής:
Run Ο χρήστης θα είναι συνδεδεμένος, και θα δημιουργηθεί ένας χρήστης SSO στο παρασκήνιο. Ο χρήστης θα έχει createdFromSimpleSSO ορισμένο σε true εάν ανακτηθεί από το API.
Σημειώσεις:
- Το email είναι ο μοναδικός αναγνωριστής για το Simple SSO.
- Η παροχή email στο Simple SSO δεν είναι απαραίτητη, ωστόσο εξ ορισμού τα σχόλιά τους θα εμφανίζονται ως "Unverified". Εάν δεν δοθεί email, ο χρήστης δεν μπορεί να πιστοποιηθεί πλήρως.
- NEW Από τον Ιαν 2022: Τα ονόματα χρήστη δεν χρειάζεται να είναι μοναδικά σε όλο το fastcomments.com
- Το Simple SSO μπορεί να δημιουργεί και να ενημερώνει αυτόματα χρήστες SSO, εάν παρέχεται email και ο χρήστης δεν είχε αρχικά δημιουργηθεί μέσω Secure SSO.
- Μπορείτε να ορίσετε badges για τον χρήστη με την ιδιότητα
badgeConfig. Ο πίνακαςbadgeIdsπεριέχει τα IDs των παγκόσμιων badges που θα συσχετιστούν με τον χρήστη. Ο πίνακαςpageBadgeIdsπεριέχει τα badge IDs που αφορούν στην τρέχουσα σελίδα (urlId) — αυτά τα 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 σας και τις προωθείτε.
Προστασία νημάτων σχολίων με Single Sign-On (SSO)
FastComments SSO (λεπτομέρειες εδώ) παρέχει στους χρήστες σας έναν τρόπο να σχολιάζουν χωρίς να χρειάζεται να συνδεθούν σε άλλη πλατφόρμα.
Ωστόσο, αυτό από μόνο του δεν ασφαλίζει τις αλληλουχίες σχολίων σας, καθώς από προεπιλογή τα δεδομένα των σχολίων είναι δημόσια διαθέσιμες πληροφορίες - όποιος μπορεί να δει τη σελίδα μπορεί να δει και τα σχόλια.
Αλλάζοντας μια ρύθμιση, μπορούμε να περιορίσουμε την ανάκτηση των σχολίων εκτός εάν γίνει από διαχειριστή ή έγκυρο χρήστη SSO.
Ρύθμιση χωρίς κώδικα
Μπορούμε να αποτρέψουμε την προβολή και την αλληλεπίδραση με τις αλληλουχίες σχολίων μας, όταν το SSO είναι ρυθμισμένο, δημιουργώντας έναν κανόνα προσαρμογής.
Κατά τη διαδικασία, αναζητήστε το SSO και θα βρείτε αυτήν την επιλογή:
Ενεργοποιήστε το και αποθηκεύστε τον κανόνα προσαρμογής.
Προστασία μόνο ενός συγκεκριμένου τομέα ή σελίδας
Για να προστατεύσετε μόνο έναν συγκεκριμένο τομέα ή σελίδα, θα ρυθμίσουμε απλώς τον κανόνα προσαρμογής ώστε να το κάνει.
Στην κορυφή του UI προσαρμογής, θα βρούμε δύο πεδία εισαγωγής, Domain και URL ID.
Για να προστατεύσετε μόνο έναν συγκεκριμένο τομέα, εισάγετε τον εν λόγω τομέα στο πεδίο "domain".
Για να προστατεύσετε μια συγκεκριμένη σελίδα, εισάγετε το URL της σελίδας στο πεδίο "URL ID". Εάν έχετε προσαρμοσμένη ενσωμάτωση με το FastComments, μπορείτε να εισάγετε έναν τύπο αναγνωριστικού εδώ αντί για URL.
Επίπεδα ασφαλείας
Κατά την απαίτηση SSO, θα θέλετε να αποφασίσετε αν απαιτείτε Simple SSO ή Secure SSO. Εάν απαιτήσετε Simple SSO, τότε και τα δύο επιτρέπονται, αλλά εάν απαιτήσετε Secure SSO, το περιεχόμενο πρέπει να ανακτηθεί με ένα Secure SSO payload που είναι κρυπτογραφημένο με το κλειδί API σας για να προβληθεί.
Η επιλογή επιπέδου ασφαλείας θα εμφανιστεί όταν επιλέξετε "Απαιτείται SSO για την προβολή σχολίων".
Προστασία πέρα από την ανάγνωση
Η ενεργοποίηση αυτής της επιλογής θα προστατεύσει τη σελίδα ή τον τομέα από το να σχολιαστεί, εκτός εάν ο χρήστης είναι συνδεδεμένος μέσω SSO.
Προβλήματα
Οποιοιδήποτε χρήστες που δημιούργησαν σχόλια πριν από την ενσωμάτωση του SSO δεν θα μπορούν να τα δουν, εκτός εάν συνδεθούν μέσω της ενσωμάτωσης SSO σας.
Επιτρέπονται ανώνυμα σχόλια
Από προεπιλογή, το FastComments απαιτεί ένα email για να σχολιάσει. Δεν χρειάζεται να είναι έγκυρο email, όμως μέχρι ο χρήστης να κάνει κλικ σε έναν σύνδεσμο που του αποστέλλεται, το σχόλιό του θα εμφανίζει την ετικέτα «Μη επαληθευμένο σχόλιο».
Ωστόσο, μπορούμε να αφαιρέσουμε την απαίτηση για email. Το πεδίο εισαγωγής email θα εμφανίζεται ακόμη, αλλά δεν θα είναι πλέον υποχρεωτικό.
Αυτό μπορεί να ρυθμιστεί μέσω της διεπαφής προσαρμογής widget:
Αποτροπή λήξης ανώνυμων σχολίων
FastComments μπορεί να ρυθμιστεί ώστε να αφαιρεί τα μη επαληθευμένα σχόλια μετά από έναν επιθυμητό αριθμό ημερών. Αυτό βοηθά στην καταπολέμηση του spam.
Από προεπιλογή, δεν το κάνει.
Αυτό μπορεί να ρυθμιστεί ή να απενεργοποιηθεί μέσω της σελίδας Ρυθμίσεις Εποπτείας.
Απενεργοποίηση πεδίων email
When users comment, and they are not logged in, they will be asked to provide their email.
This will create an “unverified session” for that user, and we will ask them to verify that session via email.
For some sites, or applications, it's desirable not to ask the user for their email when commenting or voting.
Enabling anonymous commenting makes the email input field optional. However, we can disable it completely. First, enable anonymous commenting, and then the option to disable the email input fields will appear.
With this on, the email fields will not show at all in all of our commenting products.
Note that, with this configuration, all comments will be unverified unless the user creates an account and logs into https://fastcomments.com.
You may want to consider απενεργοποίηση της ετικέτας μη επαληθευμένου.
Απενεργοποίηση της ετικέτας 'μη επαληθευμένο'
Από προεπιλογή, το FastComments θα εμφανίζει μια ετικέτα "Μη επαληθευμένο Σχόλιο" για σχόλια που έχουν αφήσει για χρήστη που έχει μια μη επαληθευμένη συνεδρία προγράμματος περιήγησης. Διαβάστε περισσότερα για τα μη επαληθευμένα σχόλια εδώ.
Run Επιπλέον, αυτή η λειτουργία μπορεί να χρησιμοποιηθεί, χωρίς να γράψετε κώδικα, στη Διεπαφή Προσαρμογής UI:
Επιτρέπονται ανώνυμες ψήφοι
Όταν οι χρήστες προσπαθούν να ψηφίσουν ένα σχόλιο και δεν είναι συνδεδεμένοι, θα τους ζητηθεί να παρέχουν το όνομα χρήστη και το email τους.
Μπορούμε να αφαιρέσουμε αυτήν την απαίτηση, επιτρέποντας σε οποιονδήποτε να ψηφίσει ένα σχόλιο χωρίς να αφήσει καμία πληροφορία.
Ορισμός προεπιλεγμένου ονόματος χρήστη
Όταν οι χρήστες σχολιάζουν ή ψηφίζουν και δεν είναι συνδεδεμένοι, θα τους ζητηθεί να παρέχουν το email και το όνομα χρήστη τους.
Στην περίπτωση ανώνυμων σχολίων, μερικές φορές είναι επιθυμητό να οριστεί ένα προεπιλεγμένο όνομα χρήστη για να μειωθεί η τριβή κατά το σχολιασμό. Αυτό μπορεί να γίνει από το UI Προσαρμογής. Η ανώνυμη σχολιαστική λειτουργία πρέπει να ενεργοποιηθεί πρώτα.
Callbacks
Όλες οι βιβλιοθήκες για το widget σχολίων (προς το παρόν Angular, React, Vue) υποστηρίζουν callbacks.
Οι callbacks ορίζονται στο αντικείμενο διαμόρφωσης, με την ίδια υπογραφή για κάθε βιβλιοθήκη.
Οι υποστηριζόμενες callbacks είναι:
- onInit
- onAuthenticationChange
- onRender
- commentCountUpdated
- onReplySuccess
- onVoteSuccess
- onImageClicked
- onOpenProfile
- onCommentSubmitStart
- onCommentsRendered
Τις ακριβείς υπογραφές μπορείτε να βρείτε στους ορισμούς TypeScript.
Εδώ είναι ένα παράδειγμα που χρησιμοποιεί όλες τις callbacks:
Run Χειροκίνητος ορισμός τοπικής ρύθμισης του χρήστη
Από προεπιλογή, το FastComments θα εμφανίζει το widget σχολίων στη γλώσσα που καθορίζεται από το σύστημα και το πρόγραμμα περιήγησης του χρήστη.
Όταν ένας χρήστης σχολιάζει ή συνδέεται, ενημερώνουμε την τελευταία του χρησιμοποιημένη γλώσσα και τη χρησιμοποιούμε επίσης για την αποστολή email.
Αυτό επηρεάζει το πώς το widget σχολίων μεταφράζεται για τον χρήστη. Η γλώσσα αποτελείται από τη γλώσσα και την περιοχή του χρήστη, έτσι η ρύθμιση της γλώσσας συνήθως αλλάζει τη γλώσσα που χρησιμοποιείται για την εμφάνιση κειμένου στον χρήστη.
Μέσω της διεπαφής χρήστη
Αυτό μπορεί να οριστεί χρησιμοποιώντας τη διεπαφή προσαρμογής του widget. Δείτε την επιλογή "Locale / Language":
Μέσω κώδικα
Αυτό μπορεί να παρακαμφθεί με μια επιθυμητή γλώσσα.
Run Υποστηριζόμενες γλώσσες και κωδικοί γλώσσας
Σημείωση SSO
Αν χρησιμοποιείτε SSO, ίσως θέλετε να περάσετε τη γλώσσα του χρήστη στο αντικείμενο χρήστη, ώστε τα email και άλλα στοιχεία να εντοπίζονται σωστά για αυτόν.
Περιορισμός επιτρεπόμενων γλωσσών
Από προεπιλογή, το FastComments δεν περιορίζει τις γλώσσες που χρησιμοποιούνται για σχόλια.
Μπορεί να είναι επιθυμητό να περιοριστούν οι γλώσσες που χρησιμοποιεί μια κοινότητα.
Αυτό μπορεί να ρυθμιστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Το σύστημα θα αναλύσει το σχόλιό τους, θα προσδιορίσει τη γλώσσα του και στη συνέχεια θα το συγκρίνει με τη λίστα των επιτρεπόμενων.
Εάν το σχόλιο είναι γραμμένο σε γλώσσα που δεν επιτρέπεται, τότε εμφανίζεται ένα τοπικοποιημένο μήνυμα σφάλματος.
Τίτλοι σελίδων
Ο τρέχων τίτλος της σελίδας συσχετίζεται με το καθορισμένο urlId και αποθηκεύεται για χρήση στα εργαλεία εποπτείας.
Από προεπιλογή, αυτό ανακτάται από το document.title.
Εάν θέλετε, μπορείτε να καθορίσετε τον δικό σας τίτλο σελίδας ως εξής:
Run Απαγόρευση νέων απαντήσεων και απενεργοποίηση ψήφων
Η δυνατότητα σχολιασμού μπορεί να κλειδωθεί ώστε να μην μπορούν να υποβληθούν νέα σχόλια ή ψήφοι ορίζοντας τη σημαία readonly σε true.
Τα σχόλια επίσης δεν θα μπορούν να επεξεργαστούν ή να διαγραφούν.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής widget, για ολόκληρο το domain ή τη σελίδα:
Update!
Από τον Νοέμβριο του 2022, τα νήματα μπορούν να κλειδωθούν ή να ξεκλειδωθούν ζωντανά από διαχειριστές και συντονιστές μέσω του μενού με τρία σημεία πάνω από την περιοχή απάντησης.
Αυτό θα αποτρέψει νέα σχόλια, ενώ θα επιτρέπει ακόμη τη ψηφοφορία και θα επιτρέπει στους χρήστες να διαγράψουν τα σχόλιά τους εάν το επιθυμούν, ενώ το readonly δεν επιτρέπει αυτά.
Αυτό αντιστοιχεί στο πεδίο isClosed του API Page.
Περιορισμός τομέων συνδέσμων
Από προεπιλογή, το FastComments επιτρέπει τη σύνδεση σε οποιονδήποτε εξωτερικό ιστότοπο.
Αυτό μπορεί να περιοριστεί σε μια επιθυμητή λίστα ιστότοπων ή domain. Η προσπάθεια να δημοσιευτεί ένας σύνδεσμος σε ιστότοπο ή domain που δεν βρίσκεται στη καθορισμένη λίστα θα προκαλέσει εμφάνιση σφάλματος στον χρήστη.
Αυτή η επικύρωση ισχύει μόνο για το Comment 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 ομάδων για αναφορές
Μια λίστα με ids για χρήση στην αυτόματη συμπλήρωση των @mentions. Χρήσιμο όταν θέλετε να αποτρέψετε τη σήμανση χρηστών όταν δεν έχουν κοινές ομάδες.
Όταν καθορίζεται, μόνο χρήστες από άλλες ομάδες θα εμφανίζονται στην αυτόματη συμπλήρωση μετά την πληκτρολόγηση του χαρακτήρα @.
Run Παράκαμψη cookies τρίτων
Για την πιστοποίηση, το FastComments εξαρτάται από το ότι τα cookies τρίτων είναι ενεργοποιημένα στο πρόγραμμα περιήγησής σας. Χωρίς αυτά, οι χρήστες θα πρέπει πάντα να αφήνουν το email τους για να σχολιάσουν (εκτός εάν το πεδίο εισαγωγής email είναι κρυφό), και τα σχόλιά τους θα εμφανίζονται πάντα ως μη επαληθευμένα (από προεπιλογή).
Για να παρακάμψετε αυτό, μπορείτε να ενεργοποιήσετε την παράκαμψη των cookies τρίτων.
Όταν αυτή η ρύθμιση είναι ενεργοποιημένη, θα εμφανίσει ένα μικρό αναδυόμενο παράθυρο που δείχνει ένα μήνυμα ότι ο χρήστης συνδέεται. Αυτό το αναδυόμενο παράθυρο εμφανίζεται όποτε ο χρήστης αλληλεπιδρά με το widget σχολίων· για παράδειγμα, αν αφήσει ένα σχόλιο.
Μπορούμε να το κάνουμε αυτό με κώδικα ορίζοντας τη σημαία enableThirdPartyCookieBypass σε true:
Run Μπορούμε επίσης να το ρυθμίσουμε μέσω του UI Προσαρμογής Widget, κάτω από Enable Third-Party Cookie Popup:
Διαγραφή σχολίων που έχουν απαντήσεις
Από προεπιλογή, οι χρήστες μπορούν να διαγράψουν τα δικά τους σχόλια. Επίσης, η διαγραφή του σχολίου τους διαγράφει αυτόματα όλα τα παιδικά και προσωρινά σχόλια στο νήμα. Αυτή η συμπεριφορά είναι επίσης ενεργή.
Μπορείτε να περιορίσετε αυτό με τους ακόλουθους τρόπους:
- Αντίθετα, ανωνυμοποιήστε το διαγραμμένο σχόλιο (ορίστε το όνομα και το κείμενο σε
[deleted]ή μια προσαρμοσμένη τιμή). - Μην επιτρέπετε τη διαγραφή σχολίων όταν υπάρχουν απαντήσεις. Εμφανίζεται ένα προσαρμόσιμο μήνυμα σφάλματος.
- Περιορίστε τη διαγραφή όταν ένα σχόλιο έχει απαντήσεις μόνο σε διαχειριστές και συντονιστές.
Αυτό μπορεί να ρυθμιστεί μέσω της ενότητας Comment Thread Deletion στο UI προσαρμογής Widget.
Εμφάνιση διακριτικών στη γραμμή κορυφής
Από προεπιλογή, το FastComments θα εμφανίζει τα εμβλήματα χρηστών μόνο στα σχόλιά τους μέσα στο νήμα σχολίων.
Ωστόσο, μπορούμε να εμφανίσουμε τα εμβλήματα χρηστών δίπλα στο όνομά τους πάνω από τη φόρμα σχολίου ενεργοποιώντας αυτή τη δυνατότητα στη σελίδα προσαρμογής του widget:
Αυτό θα εμφανίσει τα εμβλήματα του χρήστη δίπλα στο όνομά του στην περιοχή της επάνω μπάρας, καθιστώντας τα επιτεύγματα και την κατάσταση του πιο εμφανή όταν συνθέτει ένα σχόλιο.
Σημειώστε ότι αυτή η δυνατότητα πρέπει να είναι ενεργοποιημένη στη διεπαφή προσαρμογής του widget για να λειτουργήσει. Μπορείτε προαιρετικά να ορίσετε τη σημαία showBadgesInTopBar σε false στη διαμόρφωση του κώδικά σας για να την απενεργοποιήσετε επιλεκτικά ακόμη και όταν είναι ενεργοποιημένη σε επίπεδο διακομιστή:
Run Εμφάνιση λίστας συνδεδεμένων χρηστών
Από προεπιλογή, το FastComments δεν εμφανίζει λίστα χρηστών στη σελίδα.
Μπορείτε να αποδώσετε μια λίστα ατόμων που βλέπουν αυτή τη στιγμή τη σελίδα, δίπλα στο widget σχολίων. Η λίστα ενημερώνεται ζωντανά καθώς οι χρήστες εντάσσονται ή αποχωρούν, και εμφανίζει το όνομά τους, το avatar και έναν δείκτη online.
Υπάρχουν τρεις επιλογές διάταξης:
1- Κορυφή: μια οριζόντια σειρά επικαλυπτόμενων avatar που εμφανίζονται πάνω από τα σχόλια.2- Αριστερά: μια πλαϊνή μπάρα με ονόματα και σημεία online που εμφανίζεται στα αριστερά του widget.3- Δεξιά: η ίδια πλαϊνή μπάρα που εμφανίζεται στα δεξιά του widget.
Ορίστε τη σημαία usersListLocation για να ενεργοποιήσετε τη λειτουργία:
Run Από προεπιλογή η λίστα εμφανίζει μόνο χρήστες που είναι online. Για να συμπεριλάβετε επίσης άτομα που έχουν σχολιάσει στη σελίδα στο παρελθόν (αλλά δεν την βλέπουν αυτή τη στιγμή), ορίστε usersListIncludeOffline σε true:
Run Οι παλαιοί σχολιαστές εμφανίζονται χωρίς το πράσινο σημείο online, ώστε να είναι σαφές ποιος είναι παρόν αυτή τη στιγμή.
Οι χρήστες με ιδιωτικά προφίλ εμφανίζονται με ένα γενικό avatar και ετικέτα «Ιδιωτικό προφίλ», ώστε ο αριθμός να παραμένει ακριβής χωρίς αποκάλυψη ταυτοτήτων.
Αυτό μπορεί επίσης να ρυθμιστεί χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την επιλογή «Θέση λίστας χρηστών». Όταν η θέση οριστεί σε κάτι διαφορετικό από Off, εμφανίζεται ένα πλαίσιο ελέγχου «Συμπερίληψη παλαιών σχολιαστών» κάτω από αυτό.
Για τους τελευταίους 500 ζωντανούς χρήστες, η λίστα μπορεί να είναι έως και 30 δευτερόλεπτα εκτός ημερομηνίας.