Προσαρμογές & Διαμόρφωση
Προσαρμογές και Διαμόρφωση
Πλαίσιο
Εδώ θα βρείτε εκτενή τεκμηρίωση για κάθε μία από τις λειτουργίες και τις ρυθμίσεις που υποστηρίζει το 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 που αποστέλλονται από την πλατφόρμα μας.
Υποστήριξη Σκοτεινών Φόντων (Dark Mode)
Εξ ορισμού, το widget σχολίων FastComments θα ανιχνεύει αυτόματα τη σκοτεινή λειτουργία στις περισσότερες ιστοσελίδες.
Όταν εντοπιστεί η σκοτεινή λειτουργία, το FastComments θα αλλάξει από μαύρο κείμενο σε λευκό φόντο σε λευκό κείμενο σε μαύρο φόντο. Οι εικόνες θα αλλάξουν επίσης.
Κατά τη φόρτωση της σελίδας, το widget θα προσπαθήσει να προσδιορίσει πόσο σκοτεινό είναι το φόντο της σελίδας πίσω από το widget σχολίων. Αυτό σημαίνει ότι η σελίδα μπορεί να έχει λευκό φόντο, αλλά αν τοποθετήσετε το widget σχολίων μέσα σε ένα κοντέινερ με μαύρο φόντο, η σκοτεινή λειτουργία θα πρέπει να ενεργοποιηθεί αυτόματα ώστε τα σχόλια να είναι ευανάγνωστα.
Ωστόσο, ο μηχανισμός ανίχνευσης, που βασίζεται στον προσδιορισμό της "φωτεινότητας", ενδέχεται να μην ενεργοποιήσει τη σκοτεινή λειτουργία όταν το επιθυμείτε. Για να την ενεργοποιήσετε υποχρεωτικά, ορίστε τη σημαία hasDarkBackground σε true ως εξής:
Run Εναλλαγή Dark Mode
Για ιστότοπους που επιτρέπουν την εναλλαγή σε σκοτεινή λειτουργία μετά την αρχική φόρτωση της σελίδας, αυτό απαιτεί λίγο περισσότερη εργασία.
Πρώτον, όλες οι τρέχουσες εκδόσεις της βιβλιοθήκης 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. Εκεί, μπορούμε απλώς να βρούμε το κείμενο που εμφανίζεται στο widget σχολίων στην τοπική ρύθμιση EN_US και να καθορίσουμε μια αντικατάσταση.
Όλες οι αντικαταστάσεις μεταφράσεων επηρεάζουν επί του παρόντος όλες τις τοπικές ρυθμίσεις.
Αυτό καλύπτει το δικό του κείμενο του widget. Για να μεταφράσετε τα σχόλια που γράφουν οι επισκέπτες σας, δείτε Comment Translation.
Αλλαγή του Προεπιλεγμένου Avatar
Όταν ένας χρήστης σχολιάζει με FastComments για πρώτη φορά, θα προσπαθήσουμε να λάβουμε το avatar του από https://gravatar.com/.
Ωστόσο, εάν δεν βρούμε avatar ή ο χρήστης δεν έχει ορίσει ποτέ ένα στο λογαριασμό του, θα εμφανίσουμε μια στατική προεπιλεγμένη εικόνα avatar.
Για να καθορίσετε τη δική σας στατική εικόνα avatar, μπορείτε να χρησιμοποιήσετε τη ρύθμιση defaultAvatarSrc.
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής widget, δείτε την ενότητα "Default Avatar".
Σημειώστε ότι ο ορισμός του avatar για έναν συγκεκριμένο χρήστη, όπως με το SSO, καλύπτεται σε δική του ενότητα.
Απενεργοποίηση Avatar
Τα avatar μπορούν να αφαιρεθούν εντελώς από το widget σχολίων, ακόμη και αν οι χρήστες έχουν ορίσει το δικό τους avatar.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Απενεργοποίηση Όλων των Προεπιλεγμένων Στυλ
Για μεγαλύτερα προσαρμοσμένα έργα στυλ, μπορεί να είναι επιθυμητό να ξεκινήσετε από το μηδέν και να μην χρησιμοποιήσετε καθόλου το προεπιλεγμένο στυλ.
Όλο το προεπιλεγμένο στυλ μπορεί να αφαιρεθεί ορίζοντας την παράμετρο noStyles σε true, όπως φαίνεται παρακάτω:
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής widget, κάτω από τις Προηγμένες Επιλογές:
Σύνδεση από Σχόλια σε Σελίδες
Όταν αποστέλλονται email ειδοποιήσεων ή όταν τα σχόλια εμφανίζονται σε διεπαφές χρήστη όπως η σελίδα διαχείρισης, είναι χρήσιμο να υπάρχει δυνατότητα σύνδεσης από το σχόλιο προς τη σελίδα στην οποία βρίσκεται.
Αν το URL ID δεν είναι πάντα ένα ID, τότε πρέπει να αποθηκεύουμε το URL κάπου αλλού. Αυτός είναι ο σκοπός της ιδιότητας "url", η οποία ορίζεται ως εξής.
Run Μια συνηθισμένη περίπτωση χρήσης είναι η σύνδεση του νήματος σχολίων με ένα αναγνωριστικό, όπως ένα άρθρο, και στη συνέχεια η επιστροφή σε μια συγκεκριμένη σελίδα, για παράδειγμα:
Run Το 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 είναι το αναγνωριστικό της σελίδας ή του άρθρου στο οποίο είναι συνδεδεμένα τα σχόλια.
Επίσης, για να το επαναλάβουμε, αν δεν οριστεί, το urlId θα πάρει ως προεπιλογή το URL της τρέχουσας σελίδας.
Τι γίνεται όμως με τα SPAs, ή Single-Page-Applications, όπου η σελίδα ή το περιεχόμενο στο οποίο είναι συνδεδεμένα τα σχόλια αλλάζει δυναμικά χωρίς νέα επαναφόρτωση της σελίδας;
Angular, React, Vue, κ.λπ.
Με τις βιβλιοθήκες μας όπως το Angular και το React, η απλή ενημέρωση της ιδιότητας urlId που περνάει στο widget
θα προκαλέσει την ανανέωση του widget σχολίων. Μπορείτε να το δείτε σε δράση για την εφαρμογή React, για παράδειγμα, εδώ.
VanillaJS
Αν χρησιμοποιείτε τη βιβλιοθήκη VanillaJS, τα πράγματα είναι λίγο πιο περίπλοκα, καθώς δεν υπάρχει ένα framework όπως το Angular ή το React που να χειρίζεται το data binding ή τη διάδοση της κατάστασης.
Όταν δημιουργείτε το 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), συνιστούμε να το συνδυάσετε με κάποια στυλ ώστε να αφαιρέσετε την εντύπωση ότι η εικόνα μπορεί να γίνει κλικ.
Απενεργοποίηση Αυτόματης Δημιουργίας Hashtag
Όταν οι χρήστες εισάγουν 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:
Αλλαγή της Κατηγορίας Περιεχομένου των GIFs
Από προεπιλογή, το 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:
Επιτρέψτε Ενσωμάτωση Πολυμέσων
Από προεπιλογή, το FastComments δεν επιτρέπει iframes στα σχόλια. Όταν ενεργοποιείτε την ενσωμάτωση πολυμέσων, όσοι σχολιάζουν μπορούν να επικολλήσουν τον κώδικα ενσωμάτωσης (το απόσπασμα <iframe>) από αξιόπιστους παρόχους όπως YouTube, Vimeo, SoundCloud και Spotify, και θα εμφανιστεί ενσωματωμένος στο σχόλιο.
Για λόγους ασφαλείας, αυτή δεν είναι μια ρύθμιση παραμέτρων widget στο client-side. Είναι μια ρύθμιση στο server-side, η οποία επικυρώνεται κατά την αποθήκευση κάθε σχολίου, ώστε να μην μπορεί να ενεργοποιηθεί από τη σελίδα. Επιτρέπονται μόνο iframes που δείχνουν σε μια ενσωματωμένη λίστα αξιόπιστων παρόχων. Κάθε άλλο iframe αφαιρείται.
Αυτό γίνεται χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Προσθήκη Δικών σας Παρόχων
Αν θέλετε να επιτρέψετε ενσωματώσεις από έναν πάροχο που δεν βρίσκεται στην ενσωματωμένη λίστα αξιόπιστων, προσθέστε το hostname του στο πεδίο "Additional Embed Domains" στην ίδια σελίδα. Αυτά τα hostnames επιτρέπονται επιπλέον των ενσωματωμένων παρόχων. Η αντιστοίχιση είναι ακριβής, οπότε συμπεριλάβετε το πλήρες hostname (για παράδειγμα, player.example.com). Ό,τι δεν αναφέρετε παραμένει αποκλεισμένο.
Τόσο το απλό πλαίσιο σχολίων όσο και ο επεξεργαστής WYSIWYG υποστηρίζουν την επικόλληση ενσωμάτωσης. Στον επεξεργαστή WYSIWYG η ενσωμάτωση εισάγεται ως ένα αφαιρέσιμο μπλοκ.
Ενεργοποίηση Πλαισίου Αναζήτησης
Από προεπιλογή, δεν εμφανίζεται πλαίσιο αναζήτησης στο 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 Με αυτή τη ρύθμιση ενεργοποιημένη:
- Τα νέα ζωντανά σχόλια που δημοσιεύονται από άλλους χρήστες θα εμφανίζονται στο κάτω μέρος της λίστας σχολίων
- Οι χρήστες θα βλέπουν τα νέα σχόλια να εμφανίζονται κάτω από τα υπάρχοντα σχόλια σε πραγματικό χρόνο
- Αυτό επηρεάζει μόνο τις ενημερώσεις ζωντανών σχολίων — όχι την αρχική φόρτωση της σελίδας
- Αυτό μπορεί να βοηθήσει στη διατήρηση της ροής ανάγνωσης όταν οι χρήστες ακολουθούν μια συζήτηση
Σημειώστε ότι αυτή η ρύθμιση επηρεάζει μόνο τη θέση όπου τοποθετούνται τα νέα ζωντανά σχόλια καθώς καταφθάνουν σε πραγματικό χρόνο. Δεν επηρεάζει την αρχική σειρά ταξινόμησης κατά τη φόρτωση της σελίδας.
Ενεργοποίηση Άπειρης Κύλισης
Από προεπιλογή, το widget του FastComments προσαρμόζει το ύψος του κάθετα ώστε να χωράνε όλα τα ορατά σχόλια. Η σελιδοποίηση επιτυγχάνεται μέσω ενός κουμπιού "View Next" στο τέλος της τρέχουσας σελίδας, καθώς έχουμε διαπιστώσει ότι αυτή η αλληλεπίδραση είναι η πιο ευχάριστη για τους περισσότερους χρήστες.
Ωστόσο, υπάρχουν περιπτώσεις όπου προτιμάται η ατελείωτη κύλιση (infinite scrolling). Για παράδειγμα, χρησιμοποιούμε αυτή τη λειτουργία στο προϊόν μας Stream Chat.
Μπορούμε να κρύψουμε τα κουμπιά "View Next" και να μεταβούμε σε ατελείωτη κύλιση ορίζοντας τη σημαία enableInfiniteScrolling σε true:
Run Αυτό απαιτεί επίσης την προσθήκη προσαρμοσμένου CSS. Προσθέστε προσαρμοσμένο CSS για τον selector .comments ώστε να ενεργοποιηθεί η κύλιση, για παράδειγμα:
Run Ένα πλήρες λειτουργικό παράδειγμα θα ήταν:
Run Στο παραπάνω παράδειγμα χρησιμοποιούμε την ιδιότητα customCSS, ωστόσο προτείνεται, για λόγους απόδοσης, να χρησιμοποιείται αντ' αυτού το Widget Configuration UI. Δείτε την τεκμηρίωση Custom 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: Όταν ενημερώνετε τους Όρους Χρήσης, ορίστε αυτήν την ημερομηνία. Οι χρήστες που αποδέχτηκαν πριν από αυτήν την ημερομηνία θα χρειαστεί να αποδεχτούν ξανά.
Πώς Λειτουργεί
- Η χρονική σήμανση αποδοχής των Όρων Χρήσης αποθηκεύεται ανά χρήστη και ανά σχόλιο
- Όταν ένας χρήστης αποδέχεται τους Όρους Χρήσης, η ημερομηνία καταγράφεται στο προφίλ του χρήστη (ανά ενοικιαστή)
- Εάν ορίσετε μια ημερομηνία «Τελευταίας ενημέρωσης» που είναι μετά την ημερομηνία αποδοχής του χρήστη, θα χρειαστεί να αποδεχτεί ξανά
- Για ανώνυμους χρήστες που δεν μπορούν να παρακολουθηθούν, το πλαίσιο ελέγχου εμφανίζεται σε κάθε υποβολή σχολίου
Προειδοποίηση πριν την Αναχώρηση με Μη Απεσταλμένο Σχόλιο
Από προεπιλογή, εάν ένας χρήστης πληκτρολογήσει ένα σχόλιο και στη συνέχεια ανανεώσει τη σελίδα, κλείσει την καρτέλα ή απομακρυνθεί πριν υποβάλει, το προσχέδιο χάνεται σιωπηρά.
Ορίζοντας το warnOnUnsavedComment σε true, ο φυλλομετρητής ζητάει από τον χρήστη να επιβεβαιώσει πριν φύγει από τη σελίδα ενώ οποιοδήποτε πλαίσιο σχολίου ή μια επεξεργασία σε εξέλιξη περιέχει ακόμη κείμενο. Μόλις υποβληθεί το σχόλιο, το κείμενο διαγράφεται, έτσι δεν εμφανίζεται προτροπή.
Run Η προτροπή χρησιμοποιεί το δικό του διάλογο του φυλλομετρητή. Οι σύγχρονοι φυλλομετρητές εμφανίζουν τη δική τους διατύπωση και αγνοούν το προσαρμοσμένο κείμενο, έτσι το μήνυμα δεν μπορεί να προσαρμοστεί.
Αυτή η επιλογή φορτώνει μια μικρή επέκταση κατόπιν ζήτησης, έτσι δεν προσθέτει τίποτα στο widget για ιστότοπους που δεν την ενεργοποιούν.
Ενεργοποίηση Δημοσκοπήσεων
Οι δημοσκοπήσεις επιτρέπουν στους σχολιαστές να επισυνάπτουν μια ερώτηση με 2 έως 10 επιλογές σε ένα σχόλιο. Όλοι στη σελίδα ψηφίζουν επιτόπου και βλέπουν τα αποτελέσματα να ενημερώνονται ζωντανά.
Οι δημοσκοπήσεις είναι απενεργοποιημένες από προεπιλογή. Επιλέξτε Enable Polls στις ρυθμίσεις προσαρμογής του widget για να προσθέσετε ένα κουμπί δημοσκόπησης στη γραμμή εργαλείων των σχολίων. Στη συνέχεια εμφανίζονται δύο ακόμη ρυθμίσεις:
- Who Can Create Polls: Μόνο Διαχειριστές/Συντονιστές (η προεπιλογή), ή Όλοι.
- Allow Anonymous Poll Votes: όταν είναι αποεπιλεγμένο (η προεπιλογή), μόνο οι συνδεδεμένοι χρήστες μπορούν να ψηφίσουν.
Δείτε τον Οδηγό δημοσκοπήσεων για το πώς λειτουργούν η δημιουργία, η ψηφοφορία, το απόρρητο και οι ειδοποιήσεις δημοσκοπήσεων.
Επισκόπηση 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 ή ονόματος χρήστη. Ορισμένες πλατφόρμες δεν παρέχουν emails στην εξαγωγή, όπως το Disqus, οπότε σε αυτή την περίπτωση χρησιμοποιούμε το όνομα χρήστη.
- Αρκεί να περάσετε ένα αντίστοιχο όνομα χρήστη, και ένα email στο SSO payload, και θα προσθέσουμε το email στα μεμονωμένα αντικείμενα σχολίων ώστε οι ειδοποιήσεις και οι αναφορές να λειτουργούν.
Αν επιθυμείτε να εισαγάγετε τα σχόλια και τους χρήστες σας ταυτόχρονα, συνεργαστείτε με την υποστήριξη για να μεταφερθούν τα σχόλια στους αντίστοιχους λογαριασμούς των χρηστών αφού οι χρήστες εισαχθούν μέσω του API.
Έτσι, για να συνοψίσουμε την ευκολότερη διαδρομή για τη μετάβαση:
- Εισαγωγή σχολίων.
- Τα avatars και άλλα πολυμέσα μεταφέρονται αυτόματα αν χρησιμοποιείτε το Import UI στο
Manage Data -> Imports.
- Τα avatars και άλλα πολυμέσα μεταφέρονται αυτόματα αν χρησιμοποιείτε το Import UI στο
- Ρύθμιση Secure ή Simple SSO.
- Αφήστε τη μετάβαση να γίνει ανά χρήστη αυτόματα όταν συνδεθεί για πρώτη φορά.
- Αυτό συνήθως προσθέτει λιγότερο από ένα δευτερόλεπτο στον χρόνο φόρτωσης της σελίδας αν ο χρήστης έχει λιγότερα από 50k σχόλια.
Χρήστες WordPress
Αν χρησιμοποιείτε το WordPress plugin μας, τότε δεν χρειάζεται να γράψετε κώδικα! Απλώς πηγαίνετε στη σελίδα Admin του plugin, κάντε κλικ στο SSO Settings, και μετά στο Enable.
Αυτό θα σας οδηγήσει σε έναν οδηγό ενός κλικ που θα δημιουργήσει το API key σας, θα το στείλει στην εγκατάσταση WordPress σας και θα ενεργοποιήσει το SSO. Το έχουμε ενοποιήσει σε ένα μόνο κλικ για εσάς.
Σημειώστε ότι αν εγκαθιστάτε το plugin για πρώτη φορά, θα πρέπει να ολοκληρώσετε τη διαδικασία εγκατάστασης πριν δείτε τη σελίδα admin με το κουμπί SSO Settings.
WordPress SSO - Συντονιστές
Σημειώστε ότι επί του παρόντος, για να εμφανίζεται το σήμα "Moderator" δίπλα στους συντονιστές σας όταν σχολιάζουν με το FastComments WordPress plugin, πρέπει επίσης να έχουν προστεθεί ως Moderators στο dashboard του FastComments, και να έχουν επαληθευμένο email τους.
Προσαρμοσμένες Ενσωματώσεις
Για προσαρμοσμένες ενσωματώσεις, υπάρχουν δύο επιλογές.
Επιλογή Ένα - Secure SSO
Με το Secure SSO, το FastComments γνωρίζει ότι ο χρήστης που σχολιάζει, ψηφίζει και διαβάζει σχόλια είναι πραγματικός χρήστης στον ιστότοπό σας.
Αρκεί να δημιουργήσετε ένα έγκυρο payload, ο χρήστης θα έχει πάντα μια απρόσκοπτη εμπειρία σχολιασμού.
Με το Secure SSO, το SSO payload δημιουργείται server-side χρησιμοποιώντας HMAC authentication και στη συνέχεια περνάει στο widget στο client.
Με το Secure SSO, ο λογαριασμός του χρήστη είναι εντελώς ξεχωριστός από την υπόλοιπη βάση χρηστών του FastComments. Αυτό σημαίνει ότι αν έχουμε δύο συνεργάτες την Εταιρεία Α και την Εταιρεία Β, η καθεμία μπορεί να έχει χρήστη SSO με το όνομα χρήστη "Bob".
Απαιτήσεις
- Βασικές γνώσεις ανάπτυξης backend.
- Βασικές γνώσεις διαχείρισης μυστικών API keys.
- Βασικές γνώσεις ανάπτυξης API ή server-side rendering.
Πλεονεκτήματα
- Ασφαλές.
- Απρόσκοπτη εμπειρία σχολιασμού.
Μειονεκτήματα
- Απαιτεί ανάπτυξη backend.
Ενημέρωση Δεδομένων Χρήστη
Με το Secure SSO, κάθε φορά που περνάτε το sso user payload, θα ενημερώνουμε τον χρήστη με τις πιο πρόσφατες πληροφορίες. Για παράδειγμα, αν
ο χρήστης έχει όνομα χρήστη X, και περάσετε Y στο SSO payload, το όνομα χρήστη του θα γίνει Y.
Αν θέλετε να αφαιρέσετε τιμές με αυτή την προσέγγιση, τότε ορίστε τις σε null (όχι undefined).
Secure SSO API
Παρέχουμε επίσης ένα API για αλληλεπίδραση με τους χρήστες SSO. Δείτε την τεκμηρίωση.
Σημειώστε ότι όταν χρησιμοποιείτε Secure SSO, οι χρήστες δημιουργούνται αυτόματα στο παρασκήνιο κατά τη φόρτωση της σελίδας. Δεν χρειάζεται να κάνετε μαζική εισαγωγή των χρηστών σας.
Επιλογή Δύο - Simple SSO
Η εναλλακτική του Secure SSO είναι να περάσετε απλώς τις πληροφορίες του χρήστη στο widget σχολιασμού.
Η παροχή email με το Simple SSO δεν απαιτείται, ωστόσο χωρίς αυτό τα σχόλιά τους θα εμφανίζονται ως "Unverified".
Σημείωση! Από τις αρχές του 2022, τα ονόματα χρήστη με Simple SSO δεν χρειάζεται να είναι μοναδικά σε όλο το FastComments.com.
Ιδανικά, το Simple SSO θα πρέπει να επιλέγεται μόνο όταν αναπτύσσετε σε μια πλατφόρμα που δεν παρέχει πρόσβαση σε backend.
Απαιτήσεις
- Βασικές γνώσεις ανάπτυξης client-side.
- Πρέπει να γνωρίζετε τουλάχιστον το email του χρήστη.
Πλεονεκτήματα
- Απλό.
- Όλη η δραστηριότητα εξακολουθεί να επαληθεύεται.
- Ο χρήστης δεν εισάγει ποτέ το όνομα χρήστη ή το email του.
Μειονεκτήματα
- Λιγότερο ασφαλές από το Secure SSO καθώς το payload στο client side θα μπορούσε να κατασκευαστεί ώστε να γίνει οποιοσδήποτε χρήστης.
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 User στο παρασκήνιο. Ο χρήστης θα έχει το createdFromSimpleSSO ορισμένο σε true αν ανακτηθεί μέσω του API.
Σημειώσεις:
- Το email είναι το μοναδικό αναγνωριστικό για το Simple SSO.
- Η παροχή email με το Simple SSO δεν είναι υποχρεωτική, ωστόσο από προεπιλογή τα σχόλιά τους θα εμφανίζονται ως "Unverified". Αν δεν παρέχεται email, ο χρήστης δεν μπορεί να πιστοποιηθεί πλήρως.
- ΝΕΟ Από τον Ιανουάριο του 2022: Τα ονόματα χρήστη δεν χρειάζεται να είναι μοναδικά σε όλο το fastcomments.com
- Το Simple SSO μπορεί να δημιουργεί και να ενημερώνει αυτόματα χρήστες SSO, αν παρέχεται email και ο χρήστης δεν είχε δημιουργηθεί αρχικά από το Secure SSO. Αν ένα payload Simple SSO αναφέρεται σε χρήστη που δημιουργήθηκε από Secure SSO ή το API, αυτός ο χρήστης μένει ανέγγιχτος και ο επισκέπτης λαμβάνει ξεχωριστό χρήστη.
- Μπορείτε να ορίσετε σήματα (badges) για τον χρήστη με την ιδιότητα
badgeConfig. Ο πίνακαςbadgeIdsπεριέχει τα IDs των καθολικών badges που θα συσχετιστούν με τον χρήστη. Ο πίνακαςpageBadgeIdsπεριέχει badge IDs με εμβέλεια στην τρέχουσα σελίδα (urlId) — αυτά τα badges εμφανίζονται μόνο στη σελίδα όπου ορίστηκαν. Αν τοoverrideοριστεί σεtrue, θα αντικαταστήσει τα υπάρχοντα εμφανιζόμενα badges (τα καθολικά και τα σελίδας παρακάμπτονται ανεξάρτητα)· αν είναιfalse, θα προστεθούν στα υπάρχοντα badges.
Ρυθμίσεις Simple SSO
Το Simple SSO είναι πάντα διαθέσιμο. Δύο ρυθμίσεις ελέγχουν πόσο εμπιστεύεται το FastComments το Simple SSO. Μπορείτε να τις βρείτε αναζητώντας SSO σε έναν κανόνα προσαρμογής. Και οι δύο είναι απενεργοποιημένες από προεπιλογή και ισχύουν ανεξάρτητα από το αν είναι ενεργό το "Require SSO To View Comments".
Οι λογαριασμοί που χρησιμοποιούσαν ήδη Simple SSO όταν προστέθηκαν αυτές οι ρυθμίσεις έχουν και τις δύο ενεργοποιημένες, οπότε τίποτα δεν άλλαξε για αυτούς.
Ισχύει μόνο ο κανόνας προσαρμογής που ταιριάζει καλύτερα με μια σελίδα, οπότε αν έχετε περισσότερους από έναν κανόνες, ορίστε αυτές τις ρυθμίσεις σε καθέναν από αυτούς. Ένας νέος κανόνας ξεκινά με αυτές ενεργοποιημένες αν κάποιος από τους άλλους κανόνες σας τις έχει ενεργοποιημένες.
Αυτόματη επαλήθευση σχολίων μέσω Simple SSO
Όταν αυτή είναι ενεργή, τα σχόλια από χρήστες Simple SSO επαληθεύονται αμέσως.
Όταν αυτή είναι ανενεργή, τα σχόλια από χρήστες Simple SSO εμφανίζονται ως "Unverified" μέχρι ο χρήστης να κάνει κλικ σε έναν σύνδεσμο που στέλνουμε με email στη διεύθυνση του payload του Simple SSO. Αν εγκρίνετε αυτόματα μόνο επαληθευμένα σχόλια, αυτά περιμένουν επίσης τον σύνδεσμο. Αν δεν υπάρχει email στο payload, το σχόλιο μένει ανεπαλήθευτο.
Αυτή η ρύθμιση επηρεάζει μόνο τα σχόλια. Οι ψήφοι από χρήστες Simple SSO μετρώνται πάντα αμέσως.
Να επιτρέπονται διαχειριστές μέσω Simple SSO
Όταν αυτή είναι ενεργή, ένας χρήστης Simple SSO μπορεί να είναι διαχειριστής ή συντονιστής του λογαριασμού σας:
- Ένας χρήστης Simple SSO που έχει δικαιώματα διαχειριστή ή συντονιστή τα διατηρεί.
- Ένας χρήστης Simple SSO με το ίδιο email με έναν από τους διαχειριστές ή συντονιστές σας αποκτά τα δικαιώματά τους.
Όταν αυτή είναι ανενεργή, το Simple SSO δεν χορηγεί αυτά τα δικαιώματα. Ένα payload Simple SSO που αναφέρεται σε χρήστη που τα έχει λαμβάνει έναν ξεχωριστό χρήστη χωρίς δικαιώματα, και ο αρχικός χρήστης μένει ανέγγιχτος.
Τα payloads του Simple SSO δεν είναι υπογεγραμμένα, οπότε όταν αυτή η ρύθμιση είναι ενεργή, οποιοσδήποτε γνωρίζει το email ή το user id ενός διαχειριστή μπορεί να ενεργήσει ως αυτός. Αν αυτό έχει σημασία για τον ιστότοπό σας, αφήστε την ανενεργή και χρησιμοποιήστε Secure SSO για τους διαχειριστές σας.
Χρήστες που δημιουργήθηκαν από Secure SSO ή το API δεν μπορούν να προσεγγιστούν μέσω Simple SSO, ανεξάρτητα από το αν αυτή η ρύθμιση είναι ενεργή.
Προσαρμοσμένες Ενσωματώσεις - Μεταφορά από 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
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 για προβολή σχολίων", και θα ισχύει μόνο ενώ αυτή η επιλογή είναι ενεργή.
Οι ρυθμίσεις Αυτόματη Επαλήθευση Σχολίων μέσω Simple SSO και Επίτρεψη Simple SSO Διαχειριστών είναι ξεχωριστές και εφαρμόζονται ανεξάρτητα από το αν αυτή η επιλογή είναι ενεργή.
Προστασία πέρα από την ανάγνωση
Η ενεργοποίηση αυτής της επιλογής θα προστατεύσει τη σελίδα ή τον τομέα από το να σχολιαστεί, εκτός εάν ο χρήστης είναι συνδεδεμένος μέσω SSO.
Προβλήματα
Οι χρήστες που δημιούργησαν σχόλια πριν από την ενσωμάτωση του SSO δεν θα μπορούν να τα δουν, εκτός εάν συνδεθούν μέσω της ενσωμάτωσης SSO.
Επιτρέψτε Ανώνυμα Σχόλια
Από προεπιλογή, το FastComments θα απαιτεί ένα email για να σχολιάσει. Δεν χρειάζεται να είναι έγκυρο email, ωστόσο μέχρι ο χρήστης να κάνει κλικ σε έναν σύνδεσμο που του αποστέλλεται, το σχόλιό του θα εμφανίζει την ετικέτα «Μη επαληθευμένο σχόλιο».
Ωστόσο, μπορούμε να αφαιρέσουμε την απαίτηση για email. Το πεδίο εισαγωγής email θα εξακολουθεί να εμφανίζεται, αλλά δεν θα είναι πλέον υποχρεωτικό.
Αυτό μπορεί να ρυθμιστεί μέσω της διεπαφής προσαρμογής widget:
Απαιτείται ακόμη ένα όνομα χρήστη. Για να αφαιρέσετε και αυτό το βήμα, μπορείτε ορίσετε ένα προεπιλεγμένο όνομα χρήστη που όλοι μοιράζονται, ή να έχετε το FastComments δημιουργήσετε ένα μοναδικό όνομα χρήστη για κάθε επισκέπτη.
Αποτροπή Λήξης Ανώνυμων Σχολίων
FastComments μπορεί να ρυθμιστεί ώστε να αφαιρεί τα μη επαληθευμένα σχόλια μετά από έναν επιθυμητό αριθμό ημερών. Αυτό βοηθά στην καταπολέμηση του spam.
Από προεπιλογή, δεν το κάνει.
Αυτό μπορεί να ρυθμιστεί ή να απενεργοποιηθεί μέσω της σελίδας Ρυθμίσεις Εποπτείας.
Απενεργοποίηση Εισόδων Email
Όταν οι χρήστες σχολιάζουν και δεν είναι συνδεδεμένοι, θα τους ζητηθεί να δώσουν το email τους.
Αυτό θα δημιουργήσει μια "μη επαληθευμένη συνεδρία" για τον χρήστη, και θα του ζητήσουμε να επαληθεύσει τη συνεδρία μέσω email.
Για ορισμένους ιστότοπους ή εφαρμογές, είναι επιθυμητό να μην ζητείται το email του χρήστη κατά το σχολιασμό ή την ψηφοφορία.
Η ενεργοποίηση του ανώνυμου σχολιασμού κάνει το πεδίο email προαιρετικό. Ωστόσο, μπορούμε να το απενεργοποιήσουμε πλήρως. Πρώτα, ενεργοποιήστε τον ανώνυμο σχολιασμό, και στη συνέχεια θα εμφανιστεί η επιλογή απενεργοποίησης των πεδίων email.
Με αυτή τη ρύθμιση ενεργή, τα πεδία email δεν θα εμφανίζονται καθόλου σε κανένα από τα προϊόντα σχολιασμού μας.
Σημειώστε ότι, με αυτή τη διαμόρφωση, όλα τα σχόλια θα είναι μη επαληθευμένα, εκτός αν ο χρήστης δημιουργήσει λογαριασμό και συνδεθεί στο https://fastcomments.com.
Ίσως θέλετε να εξετάσετε το απενεργοποίηση της ετικέτας μη επαληθευμένου.
Απενεργοποίηση Ετικέτας Μη Επαληθευμένου
Από προεπιλογή, το FastComments θα εμφανίζει μια ετικέτα "Μη επαληθευμένο Σχόλιο" για σχόλια που έχουν αφήσει για χρήστη που έχει μια μη επαληθευμένη συνεδρία προγράμματος περιήγησης. Διαβάστε περισσότερα για τα μη επαληθευμένα σχόλια εδώ.
Run Επιπλέον, αυτή η λειτουργία μπορεί να χρησιμοποιηθεί, χωρίς να γράψετε κώδικα, στη Διεπαφή Προσαρμογής UI:
Επιτρέψτε Ανώνυμη Ψηφοφορία
Όταν οι χρήστες προσπαθούν να ψηφίσουν ένα σχόλιο και δεν είναι συνδεδεμένοι, θα τους ζητηθεί να παρέχουν το όνομα χρήστη και το email τους.
Μπορούμε να αφαιρέσουμε αυτήν την απαίτηση, επιτρέποντας σε οποιονδήποτε να ψηφίσει ένα σχόλιο χωρίς να αφήσει καμία πληροφορία.
Ορισμός Προεπιλεγμένου Ονόματος Χρήστη
Όταν οι χρήστες σχολιάζουν ή ψηφίζουν και δεν είναι συνδεδεμένοι, θα τους ζητηθεί να δώσουν το email και το όνομα χρήστη τους.
Στην περίπτωση της ανώνυμης σχολίασης, μερικές φορές είναι επιθυμητό να οριστεί ένα προεπιλεγμένο όνομα χρήστη για τη μείωση της τριβής κατά τη σχολίαση. Αυτό μπορεί να γίνει από το UI προσαρμογής. Πρώτα πρέπει να είναι ενεργοποιημένη η Ανώνυμη Σχολίαση.
Κοινή Χρήση του Προεπιλεγμένου Ονόματος Χρήστη
Το προεπιλεγμένο όνομα χρήστη είναι ένα κοινό εμφανιζόμενο όνομα, όχι μια ταυτότητα. Ένας επισκέπτης που κρατά το προεπιλεγμένο και εισάγει το email του αποκτά τον δικό του λογαριασμό, με το προεπιλεγμένο να εμφανίζεται ως το δημόσιο όνομά του. Απεριόριστοι επισκέπτες μπορούν να κρατήσουν το ίδιο προεπιλεγμένο, οπότε το "Anonymous" δεν αναφέρεται ποτέ ως ήδη κατειλημμένο.
Τα ονόματα χρήστη που πληκτρολογεί ο ίδιος ο επισκέπτης πρέπει εξακολουθούν να είναι μοναδικά.
Αν προτιμάτε κάθε επισκέπτης να αποκτά διακριτό όνομα χωρίς να χρειάζεται να το σκεφτεί, δείτε το Αυτόματη Δημιουργία Ονομάτων Χρήστη.
Αυτόματη Δημιουργία Ονομάτων Χρήστη
Όταν οι χρήστες σχολιάζουν ή ψηφίζουν και δεν είναι συνδεδεμένοι, θα τους ζητηθεί να παρέχουν το email και το όνομα χρήστη τους.
Για ορισμένες ιστοσελίδες, το να ζητάτε από έναν επισκέπτη να δημιουργήσει ένα μοναδικό όνομα χρήστη αποτελεί εμπόδιο, ιδιαίτερα σε κινητές συσκευές. Το FastComments μπορεί να δημιουργήσει ένα ουδέτερο όνομα χρήστη για κάθε νέο επισκέπτη και να το προσυμπληρώσει στο πεδίο ονόματος χρήστη, όπως BraveOtter4172.
Ο επισκέπτης μπορεί να το αφήσει όπως είναι ή να το αντικαταστήσει με ένα όνομα της επιλογής του.
Αυτό μπορεί να ενεργοποιηθεί από το UI Προσαρμογής, κάτω από τη ρύθμιση που ονομάζεται Generate Usernames Automatically:
Πώς Συμπεριφέρεται
- Κάθε παραγόμενο όνομα είναι μοναδικό. Ελέγχεται έναντι των υπαρχόντων λογαριασμών και κρατιέται για τη συνεδρία του προγράμματος περιήγησης του επισκέπτη, ώστε δύο επισκέπτες να μην προσφέρεται το ίδιο όνομα.
- Το όνομα δημιουργείται μόνο για επισκέπτες που δεν το έχουν ακόμη. Οι συνδεδεμένοι χρήστες, οι χρήστες SSO και οι επισκέπτες που έχουν ήδη σχολιάσει διατηρούν το υπάρχον όνομά τους.
- Λειτουργεί με ή χωρίς anonymous commenting. Όταν ο ανώνυμος σχολιασμός είναι απενεργοποιημένος, ο επισκέπτης εξακολουθεί να εισάγει το email του, αλλά δεν χρειάζεται πλέον να σκεφτεί ένα όνομα χρήστη.
- Ένας επισκέπτης που επιστρέφει και εισάγει ένα email που έχει χρησιμοποιήσει προηγουμένως ταιριάζει με τον υπάρχοντα λογαριασμό του και διατηρεί το όνομα σε αυτόν τον λογαριασμό.
- Εάν έχει οριστεί επίσης ένα Default Username, το παραγόμενο όνομα έχει προτεραιότητα.
Κλήσεις Επιστροφής
Όλες οι βιβλιοθήκες για το 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:
Το σύστημα θα αναλύσει το σχόλιό τους, θα προσδιορίσει τη γλώσσα του και στη συνέχεια θα το συγκρίνει με τη λίστα των επιτρεπόμενων.
Εάν το σχόλιο είναι γραμμένο σε γλώσσα που δεν επιτρέπεται, τότε εμφανίζεται ένα τοπικοποιημένο μήνυμα σφάλματος.
Μετάφραση Σχολίων
Από προεπιλογή, το FastComments μεταφράζει τη διεπαφή του widget (κουμπιά, ετικέτες, μηνύματα σφάλματος) στη γλώσσα του θεατή, αλλά τα σχόλια εμφανίζονται ακριβώς όπως γράφτηκαν.
Η Μετάφραση Σχολίων προσθέτει τη μετάφραση των ίδιων των σχολίων, ώστε μια κοινότητα που γράφει σε περισσότερες από μία γλώσσες να μπορεί να διαβάσει κάθε σχόλιο στη δική της.
Υπάρχουν δύο τρόποι:
- Automatic: σχόλια που γράφτηκαν σε γλώσσα διαφορετική από τη γλώσσα του widget εμφανίζονται μεταφρασμένα. Μια γραμμή «Translated from Spanish» εμφανίζεται κάτω από το σχόλιο με έναν σύνδεσμο Show original που εναλλάσσει μεταξύ της μετάφρασης και του αμετάφραστου κειμένου.
- Manual: κάθε σχόλιο λαμβάνει έναν σύνδεσμο Translate. Κάνοντας κλικ, μεταφράζεται αυτό το σχόλιο στη γλώσσα του θεατή, με το ίδιο κουμπί Show original μετά. Τα σχόλια που είναι ήδη στη γλώσσα του θεατή το δηλώνουν αντίθετα.
Η γλώσσα‑στόχος είναι η γλώσσα του widget: η ρύθμιση Locale / Language στον ίδιο κανόνα προσαρμογής εάν έχει οριστεί, διαφορετικά η γλώσσα του προγράμματος περιήγησης του επισκέπτη. Δεν απαιτείται τίποτα από τον επισκέπτη, χωρίς λογαριασμό, επέκταση ή επιπλέον λογισμικό, και λειτουργεί το ίδιο στο ενσωματωμένο widget και σε αυτόνομες σελίδες σχολίων.
Αυτό ενεργοποιείται ανά κανόνα προσαρμογής, ώστε να μπορεί να εφαρμοστεί σε ολόκληρο τον ιστότοπό σας, σε έναν τομέα ή σε μια μόνο σελίδα. Είναι απενεργοποιημένο από προεπιλογή.
Η μετάφραση είναι ρύθμιση διακομιστή. Η μεταβίβαση commentTranslation στη διαμόρφωση JavaScript του widget δεν την ενεργοποιεί· ο κανόνας το κάνει.
Κάθε σχόλιο μεταφράζεται το πολύ μία φορά ανά γλώσσα‑στόχο και το αποτέλεσμα αποθηκεύεται με το σχόλιο, έτσι ένα σχόλιο που διαβάζεται από χίλιους Ισπανομιλάτες μεταφράζεται μία φορά. Εάν ο συγγραφέας ή ένας συντονιστής επεξεργαστεί το σχόλιο, η αποθηκευμένη μετάφραση απορρίπτεται και το σχόλιο μεταφράζεται ξανά στην επόμενη προβολή. Το μεταφρασμένο κείμενο περνάει από την ίδια διαδικασία απολύμανσης και κανόνες συνδέσμων όπως το αρχικό σχόλιο. Τα σχόλια που είναι πολύ μεγάλα ή των οποίων η γλώσσα δεν μπορεί να εντοπιστεί, εμφανίζονται αμετάφραστα.
Η χρήση χρεώνεται ως tokens LLM με τον ίδιο ρυθμό όπως οι AI Agents και εμφανίζεται στην ίδια θέση στις λεπτομέρειες χρέωσής σας.
Τίτλοι Σελίδας
Ο τρέχων τίτλος της σελίδας συσχετίζεται με το καθορισμένο 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 δευτερόλεπτα εκτός ημερομηνίας.