Προσαρμογές και Διαμόρφωση
Πλαίσιο
Εδώ θα βρείτε εκτενή τεκμηρίωση για κάθε μία από τις λειτουργίες και τις ρυθμίσεις που υποστηρίζει το widget σχολίων.
Αυτή η τεκμηρίωση θα καλύψει βασικές έννοιες και θα εισέλθει σε βάθος σε κάθε περιοχή λειτουργικότητας, με οδηγίες βήμα-προς-βήμα και κοινές παγίδες.
Θα παρέχονται παραδείγματα κώδικα, με τις σχετικές γραμμές επισημασμένες. Θα παρέχονται στιγμιότυπα οθόνης των σελίδων ρυθμίσεων όπου εφαρμόζεται.
Τα παραδείγματα κώδικα θα χρησιμοποιούν τη βιβλιοθήκη vanilla JavaScript μας, ωστόσο οι επιλογές διαμόρφωσης χρησιμοποιούν ακριβώς τα ίδια ονόματα για όλες τις εκδόσεις του widget σχολίων (React, Vue, κ.λπ.).
Οι περισσότερες ρυθμίσεις και λειτουργίες που περιγράφονται σε αυτόν τον οδηγό δεν απαιτούν τη γραφή κώδικα.
Ταυτοποίηση του λογαριασμού σας 
Μπορεί να παρατηρήσετε ότι το widget σχολίων μπορεί να χρησιμοποιηθεί με Tenant ID "demo", για παράδειγμα:
Run 
Αυτό προορίζεται μόνο για να δοκιμάσετε και να πειραματιστείτε με το widget σχολίων. Σε παραγωγή, θα περάσετε το Tenant ID σας ως εξής:
Run Το Tenant ID σας μπορεί να βρεθεί ήδη εφαρμοσμένο στο widget σχολίων στο απόσπασμα κώδικα στον λογαριασμό σας.
Μπορείτε επίσης να βρείτε το Tenant ID σας και να διαχειριστείτε τα κλειδιά API σας στη σελίδα διαπιστευτηρίων API.
Από αυτό το σημείο και μετά, αν είστε συνδεδεμένοι στο FastComments, τα παραδείγματα κώδικα θα χρησιμοποιούν το πραγματικό Tenant ID σας (αν είστε συνδεδεμένοι στο https://fastcomments.com).
Πώς συνδέονται τα σχόλια με σελίδες και άρθρα
Κατά την απόδοση ενός θέματος σχολίων, ή όταν αφήνετε ένα σχόλιο, το FastComments πρέπει να γνωρίζει σε ποια σελίδα, άρθρο ή προϊόν ανήκουν αυτά τα σχόλια.
Για αυτό χρησιμοποιούμε κάτι που ονομάζουμε "URL ID". Είναι είτε ένας αναγνωριστής, όπως μια συμβολοσειρά ή ένας αριθμός, είτε ένα URL.
Από προεπιλογή, αν δεν καθορίσετε το urlId, θα γίνει το URL της σελίδας. Θα πάρουμε το τρέχον URL της σελίδας και θα το καθαρίσουμε για να αφαιρέσουμε οποιεσδήποτε κοινές παραμέτρους μάρκετινγκ ή αναγνωριστικά παρακολούθησης.
Στην περίπτωση ενσωματώσεων τρίτων, όπως το WordPress, το plugin μας συνήθως θα χρησιμοποιεί τον αναγνωριστή που αντιπροσωπεύει την τρέχουσα πληροφορία που προβάλλεται ως URL ID, για παράδειγμα το id του άρθρου/της σελίδας.
Run Κάτι που θα αναφέρουμε συχνά σε αυτό το έγγραφο είναι η Widget Customization UI.
Αυτή η διεπαφή μπορεί να χρησιμοποιηθεί για να γίνουν πολλές αλλαγές στο widget σχολίων χωρίς χρήση κώδικα.
Κατά τη δημιουργία ενός κανόνα προσαρμογής, συχνά θέλουμε να εφαρμόζεται σε όλες τις σελίδες του ιστότοπού μας. Ωστόσο, σε ορισμένες περιπτώσεις θέλουμε να προσαρμόσουμε το widget σχολίων σε μια συγκεκριμένη σελίδα, είτε για να εφαρμόσουμε προσαρμοσμένο στυλ, είτε για να κάνουμε τα σχόλια για εκείνη τη σελίδα ανώνυμα. Για παράδειγμα, μπορείτε επίσης να έχετε ζωντανά σχόλια που εμφανίζονται αμέσως σε κάποιες σελίδες, ενώ να τα κρύβετε υπό κουμπιά ειδοποίησης σε άλλες.
Όλα αυτά είναι δυνατά μέσω του πεδίου εισαγωγής URL ID σε αυτήν τη σελίδα, το οποίο φαίνεται ως εξής:
Η τιμή σε αυτό το πεδίο πρέπει να ταιριάζει με την παράμετρο urlId που περνιέται στο widget σχολίων. Εάν θέλετε ο κανόνας προσαρμογής σας να είναι ανεξάρτητος από το urlId, αφήστε αυτό το πεδίο κενό ή εισάγετε *.
Από το 2023 το πεδίο URL ID στην προσαρμογή widget δέχεται πλέον και πρότυπα (patterns)! Για παράδειγμα, μπορείτε να έχετε */blog/* για να προσθέσετε στυλ ειδικά για το blog σας και */store/* για να έχετε στυλ ειδικά για το κατάστημά σας, όλα ενώ χρησιμοποιείτε το ίδιο domain.
Σημεία προσοχής
- Εάν η σελίδα σας έχει παραμέτρους κατακερματισμού (hash) (όπως example.com#page-1) - αυτό θα γίνει μέρος του URL ID, από προεπιλογή.
- Κατά τη διάρκεια μεταναστεύσεων (migrations), για παράδειγμα από WordPress σε Gatsby, ίσως χρειαστεί να μεταφέρετε τις τιμές σχολίων URL ID μετά την αρχική μετανάστευση. Για αυτό, επικοινωνήστε μαζί μας.
Απεικόνιση των ίδιων σχολίων σε διαφορετικές σελίδες
Εφόσον η παράμετρος urlId μας επιτρέπει να ορίσουμε σε ποια σελίδα, ή σε ποιο id, συνδέονται τα σχόλια, μπορούμε απλώς να ορίσουμε την urlId στην ίδια τιμή σε αυτές τις σελίδες.
Run Προσαρμοσμένο στυλ
Το FastComments έχει σχεδιαστεί για να προσαρμόζεται. Το widget σχολιασμού τρέχει μέσα σε ένα iframe για λόγους ασφάλειας, οπότε για να εφαρμόσετε προσαρμοσμένο στυλ πρέπει να ακολουθήσετε μία από δύο προσεγγίσεις.
Η πρώτη, η πιο εύκολη προσέγγιση, και η προτιμώμενη από εμάς, είναι να χρησιμοποιήσετε τη σελίδα προσαρμογής του widget.
In the widget customization page, see the "Show Advanced Options" section, under which there is an area labeled "Custom CSS":
Αυτή η προσέγγιση έχει μερικά πλεονεκτήματα:
- Το CSS που εισάγετε συμπιέζεται (minified) πριν σταλεί στον χρήστη, και η μορφοποίηση διατηρείται συνεπής στο περιβάλλον επεξεργασίας.
- Απολαμβάνετε όλα τα οφέλη της διεπαφής προσαρμογής του widget, για παράδειγμα την εύκολη προσαρμογή του widget σχολιασμού διαφορετικά για διαφορετικές ιστοσελίδες.
- Όταν κάνουμε αλλαγές στο widget σχολιασμού, το προσαρμοσμένο στυλ σας θα δοκιμάζεται ως μέρος της διαδικασίας κυκλοφορίας μας.
Η δεύτερη προσέγγιση είναι να ορίσετε την παράμετρο customCSS στην διαμόρφωση του widget, ως εξής:
Run Ωστόσο, αυτό έχει περιορισμούς:
- Υπάρχει όριο στο πόσο custom CSS μπορεί να σταλεί πριν οι διακομιστές μας απορρίψουν το αίτημα, λόγω του μεγέθους των headers.
- Πρέπει να διαχειρίζεστε το custom CSS στην υποδομή και στο σύστημα κατασκευής (build system) σας. Αυτό μπορεί να είναι πλεονέκτημα αντί για μειονέκτημα.
- Υπάρχει επιπλέον κόστος αποστολής του custom CSS στο δίκτυο δύο φορές σε αυτή την περίπτωση, καθώς πρέπει να σταλεί στους διακομιστές μας και στη συνέχεια να επιστραφεί στο περιεχόμενο του iframe. Ωστόσο για τα περισσότερα μεγέθη δεδομένων, αυτό δεν είναι αντιληπτό.
- Μια συνηθισμένη βελτιστοποίηση είναι η συμπίεση (minifying) του CSS για να μειωθεί το μέγεθός του στο δίκτυο, ωστόσο με αυτή την προσέγγιση θα πρέπει να το χειριστείτε εσείς.
- Το custom CSS σας δεν θα δοκιμάζεται όταν κάνουμε αλλαγές.
External CSS Files
You can tell the widget to fetch an external file by using @import!
It's recommended to put the @import in a customization rule. This way, if we ever need to make a change to the comment widget, we can use our automation
tooling to verify your setup. So for example, you would create a customization rule in the Widget Customization UI, click Advanced, and enter in Custom CSS:
@import url(https://example.com/styles.css);In Code - Not Recommended
You can also load an external CSS file via the customCSS property:
Run However, remember that your CSS won't be able to be tested by us if you do this.
User Profile Modal Styling
Τα αναδυόμενα παράθυρα προφίλ χρήστη μπορούν επίσης να μορφοποιηθούν με custom CSS. Ωστόσο, για να εξασφαλιστεί ότι το προσαρμοσμένο στυλ εφαρμόζεται στα προφίλ χρηστών, όλοι οι επιλεκτές CSS πρέπει να έχουν πρόθεμα .user-profile. Χωρίς αυτό το πρόθεμα, το προσαρμοσμένο στυλ θα αγνοείται για τα αναδυόμενα παράθυρα προφίλ χρήστη.
For example:
Run Backwards Compatibility
Στην FastComments, γνωρίζουμε ότι οι πελάτες μας προσαρμόζουν το widget σχολιασμού. Αυτό είναι σχεδιασμένο - το τελευταίο πράγμα που θέλουμε είναι το προϊόν μας να προκαλεί ασυνέπειες σχεδίασης στο δικό σας προϊόν.
Εφόσον αυτό είναι ένα σημαντικό μέρος του προϊόντος μας, έχουμε μια διαδικασία build που μας επιτρέπει να εξετάζουμε αλλαγές στο widget σχολιασμού, ανά πελάτη, σε κάθε έκδοση.
Αν εντοπίσουμε μικρά θέματα, θα ενημερώσουμε τον λογαριασμό σας για να διασφαλίσουμε ότι η κυκλοφορία μας θα προχωρήσει ομαλά. Αν εντοπίσουμε σημαντικές αλλαγές που προκαλούν σπασίματα, αυτό μας δίνει τη δυνατότητα να σταματήσουμε την κυκλοφορία.
Προσαρμοσμένες γραμματοσειρές
FastComments is designed to be customized, and the font our widgets use is no exception.
By default, FastComments uses the system font stack to look as good as possible on a wide range of devices.
To define your own fonts, see the Τεκμηρίωση προσαρμοσμένου CSS.
Εκεί θα βρείτε έναν τρόπο να ορίσετε προσαρμοσμένο CSS, το οποίο θα σας επιτρέψει να καθορίσετε τις γραμματοσειρές που επιθυμείτε.
Πώς να Ορίσετε τη Γραμματοσειρά
To override the font, we recommend you define your CSS using the .fast-comments, textarea selectors. For example:
Run Κατάργηση εμπορικής σήμανσης
Για πελάτες με λογαριασμούς Pro ή Enterprise, επιτρέπεται το white-labeling. Απλώς επικοινωνήστε μαζί μας και θα χαρούμε να βοηθήσουμε.
Αν απλώς θέλετε να αφαιρέσετε το λογότυπό μας από το widget σχολίων, αυτό ενεργοποιείται αυτόματα στα προγράμματα Flex και Pro.
Τα προγράμματα αυτά παρέχουν επίσης την ίδια λειτουργικότητα για τα ηλεκτρονικά μηνύματα που αποστέλλονται από την πλατφόρμα μας.
Υποστήριξη σκούρων φόντων (Σκοτεινή λειτουργία)
Εξ ορισμού, το widget σχολίων FastComments θα εντοπίζει αυτόματα τη σκοτεινή λειτουργία στις περισσότερες ιστοσελίδες.
Όταν εντοπιστεί η σκοτεινή λειτουργία, το FastComments θα αλλάξει από μαύρο κείμενο σε λευκό φόντο, σε λευκό κείμενο σε μαύρο φόντο. Οι εικόνες θα αλλάξουν επίσης.
Κατά τη φόρτωση της σελίδας, το widget θα προσπαθήσει να προσδιορίσει πόσο σκούρο είναι το φόντο της σελίδας πίσω από το widget σχολίων. Αυτό σημαίνει ότι η σελίδα μπορεί να έχει λευκό φόντο, αλλά αν τοποθετήσετε το widget σχολίων μέσα σε ένα κοντέινερ με μαύρο φόντο, η σκοτεινή λειτουργία θα πρέπει να ενεργοποιηθεί αυτόματα ώστε τα σχόλια να είναι ευανάγνωστα.
Ωστόσο, ο μηχανισμός ανίχνευσης, που βασίζεται στον προσδιορισμό της «φωτεινότητας» (luminance), ενδέχεται να μην ενεργοποιήσει τη σκοτεινή λειτουργία όταν το θέλετε. Για να την ενεργοποιήσετε καταναγκαστικά, ορίστε τη σημαία hasDarkBackground σε true ως εξής:
Run Εναλλαγή σκοτεινής λειτουργίας
Για ιστότοπους που επιτρέπουν την εναλλαγή σκοτεινής λειτουργίας μετά την αρχική φόρτωση της σελίδας, αυτό είναι λίγο πιο περίπλοκο.
Καταρχάς, όλες οι τρέχουσες εκδόσεις της βιβλιοθήκης widget Σχολίων (React, Vue) περιέχουν παραδείγματα εναλλαγής σκοτεινής λειτουργίας στα αντίστοιχα αποθετήριά τους.
Για το widget VanillaJS, θα χρειαστεί να κάνουμε λίγη περισσότερη δουλειά. Αρχικά, το FastCommentsUI επιστρέφει ένα αντικείμενο με τις συναρτήσεις "destroy" και "update".
Μπορούμε απλά να καλέσουμε τη συνάρτηση update κάθε φορά που θέλουμε να ενημερώσουμε τη διαμόρφωση του widget σχολίων, ως εξής. Εδώ είναι ένα πλήρες λειτουργικό παράδειγμα εναλλαγής σκοτεινής λειτουργίας με το widget VanillaJS.
Run Αντικατάσταση κειμένου
Με το FastComments, όλο το κείμενο στο widget σχολίων μπορεί να προσαρμοστεί.
Μπορείτε να αντικαταστήσετε ένα μόνο κομμάτι κειμένου, όπως το κουμπί υποβολής, ή όλο το κείμενο στο widget σχολίων.
Από προεπιλογή, το κείμενο στο widget σχολίων μεταφράζεται βάσει της τοπικής ρύθμισης (locale) του χρήστη. Ωστόσο, μπορούμε να αντικαταστήσουμε το κείμενο, αν είμαστε βέβαιοι ότι η βάση χρηστών μας χρησιμοποιεί την ίδια τοπική ρύθμιση/γλώσσα, για παράδειγμα:
Run Όλες οι προσαρμόσιμες μεταφράσεις βρίσκονται εδώ στην καρτέλα "προηγμένες επιλογές".
Ωστόσο, υπάρχει ένας πιο εύκολος τρόπος, μέσω του UI προσαρμογής του widget. Εκεί, μπορούμε απλώς να βρούμε το κείμενο που εμφανίζεται στο widget σχολιασμού στην τοπική ρύθμιση EN_US, και να καθορίσουμε μια αντικατάσταση.
Όλες οι αντικαταστάσεις μεταφράσεων επηρεάζουν επί του παρόντος όλες τις τοπικές ρυθμίσεις.
Αλλαγή της προεπιλεγμένης εικόνας προφίλ
Όταν ένας χρήστης σχολιάζει με το FastComments για πρώτη φορά θα προσπαθήσουμε να ανακτήσουμε το avatar του από http://gravatar.com/.
Ωστόσο, αν δεν βρούμε avatar, ή ο χρήστης ποτέ δεν ορίσει ένα στον λογαριασμό του, εμφανίζουμε μια στατική προεπιλεγμένη εικόνα avatar.
Για να καθορίσετε τη δική σας στατική εικόνα avatar μπορείτε να χρησιμοποιήσετε την ρύθμιση defaultAvatarSrc.
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα εξατομίκευσης του widget, δείτε την ενότητα "Προεπιλεγμένο Avatar".
Σημειώστε ότι ο ορισμός του avatar για έναν συγκεκριμένο χρήστη, όπως με SSO, καλύπτεται σε ξεχωριστή ενότητα.
Απενεργοποίηση εικόνων προφίλ
Τα avatars μπορούν να αφαιρεθούν εντελώς από το widget σχολίων, ακόμη και αν οι χρήστες έχουν ορίσει το δικό τους avatar.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Απενεργοποίηση όλων των προεπιλεγμένων στυλ
Για μεγαλύτερα έργα προσαρμοσμένου στιλ, μπορεί να είναι επιθυμητό να ξεκινήσετε από μια καθαρή βάση και να μην χρησιμοποιήσετε καθόλου τα προεπιλεγμένα στυλ.
Όλα τα προεπιλεγμένα στυλ μπορούν να αφαιρεθούν ρυθμίζοντας την παράμετρο noStyles σε true, ως εξής:
Run Αυτό μπορεί να εξατομικευτεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, στις Σύνθετες Επιλογές:
Σύνδεση από σχόλια σε σελίδες
Κατά την αποστολή ειδοποιητικών email, ή κατά την απόδοση σχολίων σε διεπαφές χρήστη όπως η σελίδα μετριασμού, είναι χρήσιμο να μπορείτε να συνδέσετε το σχόλιο με τη σελίδα στην οποία βρίσκεται.
Αν το URL ID δεν είναι πάντα ένα ID, τότε πρέπει να αποθηκεύσουμε το URL κάπου αλλού. Γι' αυτό υπάρχει η ιδιότητα "url", ορισμένη ως εξής.
Run Μια συνηθισμένη περίπτωση χρήσης είναι να συσχετίσετε το νήμα σχολίων με έναν αναγνωριστικό, όπως ένα άρθρο, και στη συνέχεια να συνδέσετε πίσω σε μια συγκεκριμένη σελίδα, για παράδειγμα:
Run Το URL δεν καθαρίζεται από κοινές παραμέτρους μάρκετινγκ. Από προεπιλογή, όποιο κι αν είναι το τρέχον URL της σελίδας, αυτό είναι το URL που αποθηκεύεται με το σχόλιο.
Σύμπτυξη απαντήσεων ως προεπιλογή
Από προεπιλογή, οι απαντήσεις στα σχόλια ανώτατου επιπέδου εμφανίζονται.
Αυτό μπορεί να ρυθμιστεί έτσι ώστε ο χρήστης να πρέπει να κλικάρει "Εμφάνιση Απαντήσεων" στα σχόλια ανώτατου επιπέδου για να δει τα υποσχόλια.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Αυτή η ρύθμιση δεν θα επηρεάσει τον αριθμό των αρχικά φορτωμένων σχολίων ανώτατου επιπέδου. Αν έχετε ένα σχόλιο ανώτατου επιπέδου και 29 υποσχόλια, με αυτή τη ρύθμιση ενεργοποιημένη θα:
- Θα δείτε το σχόλιο ανώτατου επιπέδου.
- Θα δείτε "Εμφάνιση Απαντήσεων (29)" κάτω από αυτό το σχόλιο.
Εάν θέλετε να εμφανίζετε όλα τα σχόλια ανώτατου επιπέδου σε συνδυασμό με αυτή την επιλογή, ορίστε την αρχική σελίδα σε -1.
Ενεργοποίηση WYSIWYG
Από προεπιλογή, οι λειτουργίες μορφοποίησης στο FastComments εκτελούνται προσθέτοντας ορατές ετικέτες anchor όπως <b></b> γύρω από το κείμενό σας. Το πάτημα στη γραμμή εργαλείων
ή η χρήση συντομεύσεων το κάνει αυτό για εσάς. Ωστόσο, κάποιες κοινότητες ενδέχεται να θέλουν να επιλέξουν τη χρήση μορφοποίησης χωρίς ετικέτες anchor. Αυτό ονομάζεται ενεργοποίηση του
WYSIWYG (αυτό που βλέπεις είναι αυτό που παίρνεις) επεξεργαστή. Αυτός ο επεξεργαστής φαίνεται ακριβώς όπως ο προεπιλεγμένος, εκτός του ότι φορτώνει κάποιο
επιπλέον κώδικα που επιτρέπει στους χρήστες να κάνουν έντονη γραφή, υπογράμμιση κ.λπ. στο κείμενό τους χωρίς ορατές ετικέτες anchor.
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Enable Advanced Formatting".
Απενεργοποίηση της γραμμής εργαλείων
Εξ ορισμού, το FastComments θα εμφανίζει μια γραμμή εργαλείων όταν γράφετε ένα σχόλιο για να παρέχει συντομεύσεις για τη διακόσμηση του κειμένου και τη μεταφόρτωση εικόνων.
Αυτή η γραμμή εργαλείων μπορεί να απενεργοποιηθεί μέσω κώδικα ή μέσω της Διεπαφής Προσαρμογής.
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Απενεργοποίηση της γραμμής εργαλείων απάντησης".
Απενεργοποίηση αποκλεισμού
Κατά προεπιλογή, το FastComments επιτρέπει στους χρήστες να αποκλείουν άλλους χρήστες. Ο αποκλεισμός ενός χρήστη θα έχει ως αποτέλεσμα τα σχόλιά του να αποκρύπτονται, θα αποτρέπει τις ειδοποιήσεις μεταξύ των χρηστών, κ.λπ.
Ενδέχεται να είναι επιθυμητό να απενεργοποιηθεί αυτή η λειτουργία. Αυτό μπορεί να γίνει ως εξής:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα, κάτι που ενεργοποιεί και την κατάλληλη επικύρωση στην πλευρά του διακομιστή, μέσω της διεπαφής προσαρμογής του Widget:
Προσδιορισμός ποια σελίδα θα αποδοθεί
Κατά την ανάκτηση και απόδοση σχολίων, το widget σχολίων χρειάζεται να γνωρίζει από ποια σελίδα να ξεκινήσει. Από προεπιλογή, ξεκινά με την πρώτη σελίδα, αποδίδοντας μόνο εκείνη τη σελίδα.
Εάν επιθυμείτε, η ακριβής σελίδα που θα αποδοθεί μπορεί να περαστεί στο widget σχολίων ως η ρύθμιση startingPage.
Run Σημειώστε ότι οι αριθμοί των σελίδων ξεκινούν από το μηδέν, οπότε το παραπάνω παράδειγμα αποδίδει τη δεύτερη σελίδα.
Αλλαγή νημάτων σχολίων χωρίς επαναφόρτωση της σελίδας
Έχουμε εξηγήσει πως το urlId είναι το αναγνωριστικό της σελίδας ή του άρθρου στο οποίο συνδέονται τα σχόλια.
Επίσης, για επανάληψη, αν δεν οριστεί, το urlId θα έχει προεπιλογή το URL της τρέχουσας σελίδας.
Τι γίνεται με τις εφαρμογές μίας σελίδας (SPAs), όπου η σελίδα ή το περιεχόμενο στο οποίο συνδέονται τα σχόλια αλλάζει δυναμικά χωρίς πλήρη επαναφόρτωση της σελίδας;
Angular, React, Vue, κ.λπ.
Με τις βιβλιοθήκες μας όπως οι Angular και React, το απλό ενημέρωμα της ιδιότητας urlId που δίνεται στο widget θα προκαλέσει ανανέωση του widget σχολίων. Μπορείτε να δείτε αυτό σε δράση για την εφαρμογή React, για παράδειγμα, εδώ.
VanillaJS
Αν χρησιμοποιείτε τη βιβλιοθήκη VanillaJS είναι ελαφρώς πιο περίπλοκο καθώς δεν υπάρχει ένα πλαίσιο όπως ο Angular ή ο React για να χειριστεί το binding δεδομένων ή τη διάδοση κατάστασης.
Όταν δημιουργείτε μια παρουσία του widget VanillaJS, επιστρέφει μερικές συναρτήσεις που μπορούν να κληθούν για να το ενημερώσουν.
Ιδού ένα λειτουργικό παράδειγμα όπου αλλάζουμε το hash της σελίδας και ενημερώνουμε το widget σχολίων:
Run Απόλυτες ημερομηνίες (Απενεργοποίηση φιλικών χρονοσημειώσεων)
Κατά προεπιλογή χρησιμοποιούνται τοπικοποιημένες σχετικές ημερομηνίες. Για παράδειγμα, δίπλα σε ένα πρόσφατα δημοσιευμένο σχόλιο μπορεί να δείτε "11 λεπτά πριν".
Ενδέχεται να είναι απαραίτητο ή επιθυμητό να χρησιμοποιήσετε απόλυτες ημερομηνίες, οπότε ορίζετε αυτήν την παράμετρο σε true.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, κάτω από τις Προηγμένες Επιλογές:
Εμφάνιση τόσο απόλυτων όσο και σχετικών ημερομηνιών
Από προεπιλογή χρησιμοποιούνται τοπικοποιημένες σχετικές ημερομηνίες. Για παράδειγμα, δίπλα σε ένα πρόσφατα δημοσιευμένο σχόλιο μπορεί να δείτε "11 λεπτά πριν".
Μπορεί να είναι αναγκαίο ή επιθυμητό να διατηρηθεί αυτή η σχετική μορφή ημερομηνίας, αλλά επίσης να εμφανίζεται και η πλήρης ημερομηνία παράλληλα — σε αυτή την περίπτωση ορίστε αυτή την παράμετρο σε true.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, στην ενότητα Advanced Options. Πρώτα θα πρέπει να ενεργοποιήσετε τις Απόλυτες Ημερομηνίες για να δείτε αυτή την επιλογή στο UI.
Προσθήκη κειμένου κεφαλίδας
Μπορεί να εμφανιστεί κάποιο κείμενο, όπως μια επικεφαλίδα ή μήνυμα, κάτω από τον αριθμό σχολίων αλλά πάνω από το κείμενο κατάστασης σύνδεσης.
Αυτό το ονομάζουμε επικεφαλίδα, και εξ ορισμού είναι κρυφό.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, στις Προηγμένες Επιλογές:
Εμφάνιση συνδέσμων ως κείμενο
Από προεπιλογή, το FastComments θα εμφανίζει συνδέσμους όπως τούτο: https://exmaple.com - όπου το URL του συνδέσμου γίνεται κλικαίο HTML σύνδεσμος.
Κάποιες ιστοσελίδες μπορεί να θέλουν να απενεργοποιήσουν αυτό, για παράδειγμα για να αποθαρρύνουν απατεώνες. Αυτό επιτυγχάνεται ρυθμίζοντας την Comment HTML Rendering Option σε Links as Text.
Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, για ολόκληρο τον τομέα, ή σε μεμονωμένη σελίδα:
Εναλλαγή σχολίων με κουμπί
Από προεπιλογή, το FastComments θα αποδώσει το πλαίσιο εισαγωγής σχολίου και το νήμα σχολίων ταυτόχρονα. Για να εξοικονομήσει κάθετο χώρο, θα κρύψει επίσης οποιαδήποτε άλλα απαιτούμενα πεδία μέχρι να αλληλεπιδράσει ο χρήστης με το widget.
Ωστόσο, το widget σχολίων μπορεί να κρυφτεί πίσω από ένα κουμπί, για παράδειγμα:
Το κουμπί χρησιμοποιεί διαφορετικό μεταφρασμένο κείμενο ανάλογα με το αν τα σχόλια εμφανίζονται αυτήν τη στιγμή ή όχι. Εάν τα σχόλια είναι κρυμμένα, χρησιμοποιεί το translations.SHOW_COMMENTS_BUTTON_TEXT. Εάν τα σχόλια εμφανίζονται, χρησιμοποιεί το translations.HIDE_COMMENTS_BUTTON_TEXT. Οι μεταφράσεις μπορούν να περιέχουν το κείμενο [count] το οποίο θα αντικατασταθεί με τον τοπικό αριθμό.
Run Αυτό έχει σχεδιαστεί για να αντικαταστήσει τη ρύθμιση hideCommentsUnderCountTextFormat.
Ο αριθμός ενημερώνεται σε πραγματικό χρόνο μαζί με το νήμα σχολίων. Το κουμπί δεν εμφανίζεται εάν δεν υπάρχουν σχόλια.
Αυτό μπορεί να ενεργοποιηθεί χωρίς κώδικα δημιουργώντας έναν κανόνα εξατομίκευσης και ενεργοποιώντας "Κάντε κλικ για εμφάνιση σχολίων":
Προσαρμογή του κειμένου αριθμού σχολίων
Ο αριθμός σχολίων που εμφανίζεται στην κορυφή του widget σχολίων μπορεί να προσαρμοστεί.
Αυτό μπορεί να αντικατασταθεί με οποιαδήποτε συμβολοσειρά, και η τιμή [count] θα αντικατασταθεί με την τιμή του μετρητή, τοπικοποιημένη για τον χρήστη.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Απενεργοποίηση ανακατεύθυνσης εικόνων
Από προεπιλογή, το FastComments επιτρέπει στους χρήστες να ανεβάζουν εικόνες. Όταν ένας χρήστης κάνει κλικ σε αυτήν την εικόνα, το FastComments θα, εξ ορισμού, ανοίξει μια νέα καρτέλα για να δείξει την εικόνα σε πλήρες μέγεθος. Ορισμός αυτής της σημαίας σε true απενεργοποιεί αυτή τη συμπεριφορά:
Run Εάν δεν σκοπεύετε να χειριστείτε το κλικ στην εικόνα εσείς οι ίδιοι (δείτε onImageClicked), προτείνουμε να συνδυάσετε αυτό με κάποια μορφοποίηση ώστε να αφαιρέσετε την εντύπωση ότι η εικόνα μπορεί να κλικάρεται.
Απενεργοποίηση αυτόματης δημιουργίας hashtag
Όταν οι χρήστες εισάγουν hashtags, με τη μορφή #someexampletag, το FastComments θα δημιουργήσει αυτόματα εκείνο το HashTag και
θα το επισημάνει στο σχόλιό τους.
Σε ορισμένες περιπτώσεις είναι επιθυμητό να απενεργοποιήσετε αυτή τη λειτουργία ή να ελέγξετε ποια hashtags μπορούν να χρησιμοποιηθούν μέσω του API.
Για να το κάνετε, απλώς ενεργοποιήστε το Disable Automatic #hashtag Creation μέσω της διεπαφής προσαρμογής του Widget.
Απενεργοποίηση κουδουνιού ειδοποιήσεων
Από προεπιλογή, το FastComments θα εμφανίζει ένα κουδούνι ειδοποιήσεων στην επάνω δεξιά γωνία της περιοχής σχολίων.
Αυτό το κουδούνι θα γίνει κόκκινο και θα εμφανίσει τον αριθμό των ειδοποιήσεων που έχει ο χρήστης. Μερικά παραδείγματα ειδοποιήσεων είναι:
- Κάποιος χρήστης σας απάντησε.
- Κάποιος χρήστης απάντησε σε ένα νήμα όπου σχολιάσατε.
- Κάποιος χρήστης ψήφισε θετικά το σχόλιό σας.
- Κάποιος χρήστης απάντησε σε μια σελίδα στην οποία έχετε εγγραφεί.
Το κουδούνι ειδοποιήσεων παρέχει επίσης έναν μηχανισμό για εγγραφή σε ολόκληρη σελίδα.
Ωστόσο, μπορούμε να απενεργοποιήσουμε εντελώς το κουδούνι ειδοποιήσεων:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Απενεργοποίηση κουδουνιού ειδοποιήσεων".
Απενεργοποίηση προφίλ
Από προεπιλογή, το FastComments θα εμφανίζει το προφίλ του χρήστη όταν κάνετε κλικ στο avatar του.
Ωστόσο, μπορούμε να απενεργοποιήσουμε αυτή τη λειτουργία:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα «Απενεργοποίηση Προφίλ».
Απενεργοποίηση μηνύματος επιτυχίας
Από προεπιλογή, το FastComments θα εμφανίζει μήνυμα επιτυχίας μετά την υποβολή σχολίου. Αυτό μπορεί να απενεργοποιηθεί ως εξής:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget:
Αλλαγή της βαθμολογίας περιεχομένου των GIFs
Κατά προεπιλογή, το widget σχολίων του FastComments θα ορίσει το gif rating σε pg.
Οι διαθέσιμες επιλογές είναι g, pg, pg-13 και r.
Αυτό μπορεί να οριστεί στον κώδικα ή μέσω του UI. Στον κώδικα μπορούμε να το κάνουμε ως εξής:
Run Στο UI, θα το βρείτε κάτω από Gif Picker Rating, εφόσον το Disable Image Uploads? δεν είναι επιλεγμένο.
Έλεγχος περιεχομένου εικόνων
Από προεπιλογή, το widget σχολίων FastComments έχει τη λογοκρισία περιεχομένου εικόνων απενεργοποιημένη (off).
Οι διαθέσιμες επιλογές είναι off, low, medium, και high.
Στο περιβάλλον προσαρμογής του widget, θα βρείτε αυτήν την επιλογή κάτω από Image Content Moderation Level, εφόσον το Disable Image Uploads? δεν είναι επιλεγμένο.
Αλλαγή του στυλ ψηφοφορίας
Εξ ορισμού, το FastComments θα εμφανίζει επιλογές ψήφου ως βέλη πάνω και κάτω, επιτρέποντας στους χρήστες να ψηφίσουν είτε θετικά είτε αρνητικά ένα σχόλιο.
Ωστόσο, είναι δυνατόν να αλλάξετε το στυλ της γραμμής εργαλείων ψήφου. Οι τρέχουσες επιλογές είναι τα προεπιλεγμένα κουμπιά Up/Down, ή η χρήση ενός μηχανισμού ψήφου με σχήμα Καρδιάς.
Χρησιμοποιούμε τη σημαία voteStyle ως εξής:
Run Συνιστούμε ανεπιφύλακτα να το κάνετε αυτό χωρίς κώδικα καθώς ενεργοποιεί επίσης επικυρώσεις στην πλευρά του διακομιστή. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Vote Style".
Μπορείτε επίσης να απενεργοποιήσετε την ψήφιση, δείτε Disable Voting παραπάνω στις επιλογές στυλ.
Απενεργοποίηση διαγραφής
Εξ ορισμού, το FastComments θα επιτρέπει στους χρήστες να διαγράφουν τα σχόλιά τους.
Ωστόσο, είναι δυνατό να το αποτρέψετε.
Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Απενεργοποίηση Διαγραφής".
- Αυτό επηρεάζει μόνο τους κανονικούς Σχολιαστές και όχι τους συντονιστές ή τους διαχειριστές, οι οποίοι θα εξακολουθούν να μπορούν να διαγράφουν.
- Αυτό θα επηρεάσει επίσης τις ενσωματώσεις API όταν περνάται
contextUserId.
Απενεργοποίηση επεξεργασίας
Από προεπιλογή, το FastComments θα επιτρέπει στους χρήστες να επεξεργάζονται τα σχόλιά τους.
Ωστόσο, είναι δυνατόν να αποτραπεί αυτό.
Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Απενεργοποίηση Επεξεργασίας".
- Αυτό επηρεάζει μόνο τους κανονικούς σχολιαστές και όχι τους συντονιστές ή τους διαχειριστές, οι οποίοι θα εξακολουθούν να μπορούν να επεξεργάζονται.
- Αυτό θα επηρεάσει επίσης τις ενσωματώσεις API όταν περαστεί το
contextUserId.
Επισήμανση νέων σχολίων
Το FastComments παρέχει διάφορους τρόπους για να επισημαίνονται νέα σχόλια.
Πρώτα απ' όλα, εξ ορισμού τα σχόλια που προκάλεσαν ειδοποίηση εντός της εφαρμογής (απαντήσεις, απαντήσεις στο ίδιο νήμα, ή σχόλια σε μια σελίδα
στην οποία έχετε εγγραφεί), θα επισημαίνονται αυτόματα με το avatar του χρήστη να έχει μια ελαφριά λάμψη. Το χρώμα μπορεί να προσαρμοστεί μέσω CSS
χρησιμοποιώντας την κλάση is-unread.
Τα σχόλια που δημοσιεύτηκαν τις τελευταίες 24 ώρες έχουν εφαρμοσμένη την κλάση 24hr που μπορεί να χρησιμοποιηθεί για εφαρμογή στυλ.
Τέλος, οποιαδήποτε νέα ζωντανά σχόλια που εμφανίζονται στη συνεδρία του χρήστη θα επισημαίνονται για μερικά δευτερόλεπτα μέσω μιας κινούμενης απεικόνισης. Αυτό γίνεται μέσω της
is-live κλάσης CSS και μπορεί επίσης να προσαρμοστεί.
Μεγέθη σελίδων
Κατά προεπιλογή, το μέγεθος σελίδας του FastComments είναι 30. Αυτό περιλαμβάνει απαντήσεις σε νήματα.
Το μέγεθος σελίδας μπορεί να προσαρμοστεί στη Διεπαφή ρύθμισης του widget σε διάφορα μεγέθη που κυμαίνονται από 10 έως 200.
Σημειώστε ότι η αλλαγή του μεγέθους σελίδας απαιτεί επαναϋπολογισμό όλων των νημάτων σχολίων στον λογαριασμό σας. Αυτό μπορεί να διαρκέσει μερικά λεπτά.
Αυτό δεν μπορεί να ρυθμιστεί στο widget από την πλευρά του πελάτη, καθώς οι σελίδες υπολογίζονται στον διακομιστή.
Παράδειγμα ρύθμισης φαίνεται παρακάτω:
Τα μεγέθη σελίδας μπορούν να προσαρμοστούν παγκοσμίως, ανά domain ή ανά σελίδα, δημιουργώντας διαφορετικούς κανόνες προσαρμογής.
Αυτό θα επηρεάσει όλους τους clients, integrations και frameworks που μπορεί να χρησιμοποιείτε για να προβάλλετε σχόλια μέσω της πλατφόρμας μας.
Πρότυπα ηλεκτρονικού ταχυδρομείου
Τα email που αποστέλλονται από το FastComments στους πελάτες σας μπορούν να προσαρμοστούν. Το πρότυπο, η λογική, και οι μεταφράσεις μπορούν όλα να αλλάξουν. Το κείμενο μπορεί να προσαρμοστεί ανά locale, και το στυλ μπορεί ακόμη να αλλάξει ανά domain. Μάθετε περισσότερα για τα προσαρμοσμένα πρότυπα email εδώ.
Μορφές ονόματος χρήστη
Κατά προεπιλογή, το FastComments θα εμφανίζει το όνομα του χρήστη όπως το εισήγαγε, ή όπως μας παραδόθηκε μέσω SSO.
Ωστόσο, μπορεί να θέλετε να αποκρύψετε ή να εμφανίσετε το όνομα του χρήστη με διαφορετικό τρόπο. Για παράδειγμα, αν το όνομα του χρήστη είναι Allen Rex, ίσως θέλετε να εμφανίζεται μόνο "Allen R.".
Αυτό μπορεί να γίνει χωρίς κώδικα στο UI Προσαρμογής Widget, υπό την ρύθμιση με όνομα Commenter Name Format:
Οι διαθέσιμες μορφές είναι:
- Capitalize (εμφανίζει τον Example User ως Example User)
- Last Initial (εμφανίζει τον Example User ως Example U.)
- All Initials (εμφανίζει τον Example User ως E. U.)
- Show "Anonymous"
Η αλλαγή εφαρμόζεται άμεσα. Οι χρήστες θα βλέπουν ακόμη το πλήρες όνομα χρήστη στην κορυφή της περιοχής σχολίων για τον εαυτό τους, αλλά τα σχόλιά τους θα εμφανίζουν το τροποποιημένο όνομα χρήστη.
Τα ονόματα χρηστών αποκρύπτονται στην πλευρά του διακομιστή για να προστατευτούν οι χρήστες.
Απενεργοποίηση μεταφόρτωσης εικόνων
Εξ ορισμού το FastComments επιτρέπει τη μεταφόρτωση εικόνων. Αυτό μπορεί να απενεργοποιηθεί θέτοντας τη σημαία noImageUploads σε true.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Ενεργοποίηση πεδίου αναζήτησης
Από προεπιλογή, δεν εμφανίζεται πλαίσιο αναζήτησης στο widget σχολίων.
Ωστόσο, μπορούμε να το ενεργοποιήσουμε θέτοντας τη σημαία enableSearch σε true:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Enable Search Box".
Ενεργοποίηση spoilers
Μπορούμε να ενεργοποιήσουμε την υποστήριξη spoiler θέτοντας τη σημαία enableSpoilers σε true:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την επιλογή "Ενεργοποίηση Spoilers".
Όταν το κείμενο επισημαίνεται και πατηθεί το πλέον ορατό κουμπί SPOILER, το κείμενο θα καλυφθεί μέχρι ο χρήστης να μετακινήσει τον δείκτη του ποντικιού πάνω από αυτό. Για το σκοτεινό θέμα κάνουμε το ίδιο, με διαφορετικά
χρώματα που ταιριάζουν καλύτερα στο σκοτεινό θέμα.
Αυτό είναι επίσης συμβατό με τον WYSIWYG επεξεργαστή.
Ενεργοποίηση μέτρησης προβολών σχολίων
Προεπιλεγμένα, το FastComments δεν παρακολουθεί ποιος είδε κάθε σχόλιο ούτε παρέχει στατιστικά σχετικά με αυτό.
Ωστόσο, μπορούμε να ενεργοποιήσουμε αυτή τη δυνατότητα, και τότε το σύστημα θα αρχίσει να παρακολουθεί όταν κάθε χρήστης κάνει κύλιση σε ένα σχόλιο.
Όταν συμβεί αυτό, ένας μετρητής δίπλα σε ένα εικονίδιο ματιού που εμφανίζεται σε κάθε σχόλιο θα αυξάνεται. Ο μετρητής ενημερώνεται σε πραγματικό χρόνο και συντομεύεται σύμφωνα με την τοπική ρύθμιση (locale) του χρήστη.
Μπορούμε να το ενεργοποιήσουμε ρυθμίζοντας τη σημαία enableViewCounts σε true:
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Παρακολουθούμε το user id* που είδε το σχόλιο, έτσι ώστε αν δείτε ξανά το σχόλιο να μην αυξάνεται. Αν δείτε ξανά το σχόλιο μετά από δύο χρόνια, ο μετρητής θα αυξηθεί ξανά.
- *Σημείωση: ή το anon session id, ή η IP του χρήστη ως τιμή κατακερματισμένη.
Εμφάνιση ζωντανών σχολίων αμέσως
Από προεπιλογή, τα ζωντανά σχόλια είναι ενεργοποιημένα. Αυτό σημαίνει ότι αν προστεθούν, διαγραφούν, επεξεργαστούν ή καρφιτσωθούν σχόλια, οι αλλαγές θα πρέπει να εμφανιστούν σε όλους τους χρήστες που βλέπουν το νήμα σχολίων ταυτόχρονα.
Ωστόσο, από προεπιλογή αυτά τα νέα σχόλια θα εμφανιστούν κάτω από ένα δυναμικά εμφανιζόμενο κουμπί με κείμενο παρόμοιο με "Show 2 New Comments".
Εάν τα νέα σχόλια είναι απαντήσεις απευθείας στη σελίδα, το κουμπί θα εμφανιστεί στην κορυφή του νήματος σχολίων. Εάν είναι απαντήσεις σε κάποιο συγκεκριμένο σχόλιο, το κουμπί θα εμφανιστεί κάτω από εκείνο το σχόλιο.
Αυτό γίνεται για να αποφεύγεται η συνεχής αλλαγή του μεγέθους της σελίδας για τον χρήστη, κάτι που μπορεί να προκαλέσει απογοήτευση όταν προσπαθεί να πιάσει τη γραμμή κύλισης.
Για κάποιες περιπτώσεις χρήσης, όπως ζωντανές δημοπρασίες ή διαδικτυακές εκδηλώσεις, αυτή η συμπεριφορά δεν είναι επιθυμητή — ίσως θέλετε το widget σχολίων να λειτουργεί περισσότερο σαν κουτί "chat" όπου τα νέα σχόλια "εμφανίζονται αμέσως".
Επομένως, το όνομα της ρύθμισης που ενεργοποιεί αυτή τη δυνατότητα: showLiveRightAway.
Μπορούμε να το ενεργοποιήσουμε ως εξής:
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Απενεργοποίηση ζωντανών σχολίων
Από προεπιλογή, το FastComments θα έχει ενεργοποιημένα τα ζωντανά σχόλια.
Αυτό σημαίνει ότι κάθε θεατής του νήματος σχολίων θα βλέπει το ίδιο περιεχόμενο.
Για παράδειγμα, αν προστεθεί ένα σχόλιο, αυτό το σχόλιο θα εμφανίζεται. Εάν ένα σχόλιο επεξεργαστεί ή διαγραφεί, τότε τα σχόλια αυτά θα επεξεργαστούν ή θα διαγραφούν για όλους τους θεατές του νήματος. Το ίδιο ισχύει για τις ψήφους και για όλες τις ενέργειες διαχείρισης.
Ωστόσο, μπορούμε να απενεργοποιήσουμε αυτό:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα «Απενεργοποίηση ζωντανών σχολίων».
Νέα ζωντανά σχόλια στο κάτω μέρος
Από προεπιλογή, τα νέα σχόλια που δημοσιεύονται σε πραγματικό χρόνο εμφανίζονται στην κορυφή της λίστας σχολίων.
Όταν αυτή η επιλογή είναι ενεργοποιημένη, τα νέα σχόλια σε πραγματικό χρόνο προστίθενται στο κάτω μέρος της λίστας. Αυτό επηρεάζει τον τρόπο με τον οποίο τα σχόλια εμφανίζονται όταν δημοσιεύονται σε πραγματικό χρόνο ενώ οι χρήστες βλέπουν τη συνομιλία σχολίων.
Run Με αυτή τη ρύθμιση ενεργοποιημένη:
- Τα νέα σχόλια σε πραγματικό χρόνο που δημοσιεύονται από άλλους χρήστες θα εμφανίζονται στο κάτω μέρος της λίστας σχολίων
- Οι χρήστες θα βλέπουν τα νέα σχόλια να εμφανίζονται κάτω από τα υπάρχοντα σχόλια σε πραγματικό χρόνο
- Αυτό επηρεάζει μόνο τις ενημερώσεις σχολίων σε πραγματικό χρόνο - όχι την αρχική φόρτωση της σελίδας
- Αυτό μπορεί να βοηθήσει στη διατήρηση της ροής ανάγνωσης όταν οι χρήστες ακολουθούν μια συζήτηση
Σημειώστε ότι αυτή η ρύθμιση επηρεάζει μόνο το πού τοποθετούνται τα νέα σχόλια σε πραγματικό χρόνο καθώς φτάνουν. Δεν επηρεάζει την αρχική σειρά ταξινόμησης όταν φορτώνει η σελίδα.
Ενεργοποίηση άπειρης κύλισης
Από προεπιλογή, το widget FastComments θα αλλάζει το ύψος του κάθετα ώστε να χωράει όλα τα ορατά σχόλια. Η σελιδοποίηση επιτυγχάνεται μέσω ενός κουμπιού "Προβολή Επόμενων" στο τέλος της τρέχουσας σελίδας, καθώς διαπιστώσαμε ότι αυτή η αλληλεπίδραση είναι η πιο άνετη για τους περισσότερους χρήστες.
Ωστόσο, υπάρχουν περιπτώσεις όπου προτιμάται η άπειρη κύλιση. Για παράδειγμα, χρησιμοποιούμε αυτή τη δυνατότητα στο προϊόν Stream Chat.
Μπορούμε να αποκρύψουμε τα κουμπιά "Προβολή Επόμενων" και να μεταβούμε στην άπειρη κύλιση ρυθμίζοντας τη σημαία enableInfiniteScrolling σε true:
Run Αυτό απαιτεί επίσης την προσθήκη προσαρμοσμένου CSS. Προσθέστε προσαρμοσμένο CSS για τον επιλεκτή .comments για να ενεργοποιήσετε την κύλιση, για παράδειγμα:
Run Ένα πλήρες λειτουργικό παράδειγμα θα ήταν:
Run Στο παραπάνω παράδειγμα χρησιμοποιούμε την ιδιότητα customCSS, ωστόσο συνιστάται να χρησιμοποιηθεί η διεπαφή διαμόρφωσης του widget (Widget Configuration UI) για λόγους απόδοσης. Δείτε την τεκμηρίωση για το Custom CSS.
Αλλαγή της προεπιλεγμένης κατεύθυνσης ταξινόμησης
Εξ ορισμού, το FastComments θα ταξινομεί τα σχόλια με την κατεύθυνση ταξινόμησης "Most Relevant".
Η ταξινόμηση "Most Relevant" λαμβάνει υπόψη τον χρόνο που γράφτηκε το σχόλιο και τον αριθμό ψήφων για την ταξινόμηση.
Ο χρήστης μπορεί στη συνέχεια να αλλάξει την κατεύθυνση ταξινόμησης είτε σε "Oldest First" είτε σε "Newest First" στο UI του widget σχολίων.
Ωστόσο, μπορούμε να αλλάξουμε την προεπιλογή σε οποιαδήποτε από τις τρεις. Για παράδειγμα, αν θέλετε να εμφανίζονται πρώτα τα παλαιότερα σχόλια:
Run Ορίζουμε την τιμή του defaultSortDirection σε "OF" για να ορίσουμε την κατεύθυνση σε "OF".
Για την κατεύθυνση ταξινόμησης νεότερα-πρώτα, θα κάναμε το ακόλουθο:
Run Οι έγκυρες τιμές για το defaultSortDirection είναι:
- MR: "Most Recent"
- NF: "Newest First"
- OF: "Oldest First"
Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Προεπιλεγμένη Κατεύθυνση Ταξινόμησης".
Σημειώστε ότι τα σχόλια σε κάθε σελίδα για κάθε κατεύθυνση ταξινόμησης υπολογίζονται εκ των προτέρων, επομένως όλες οι κατευθύνσεις ταξινόμησης έχουν την ίδια απόδοση.
Απόδοση όλων των σχολίων ταυτόχρονα - Απενεργοποίηση σελιδοποίησης
Για να απενεργοποιήσετε τη σελιδοποίηση και να εμφανίσετε όλα τα σχόλια ταυτόχρονα, ορίστε το startingPage σε -1.
Run Μετακίνηση του πεδίου απάντησης μετά τα σχόλια
Κατά προεπιλογή η περιοχή εισαγωγής σχολίων είναι πριν το νήμα σχολίων. Ωστόσο, ρυθμίζοντας αυτή την παράμετρο διαμόρφωσης σε true μπορούμε να τη μετακινήσουμε μετά.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Περιορισμός του μήκους σχολίου
Ο μέγιστος αριθμός χαρακτήρων που επιτρέπεται να εισαχθούν στο πεδίο εισαγωγής σχολίου μπορεί να περιοριστεί από την παράμετρο maxCommentCharacterLength.
Η προεπιλεγμένη τιμή είναι 2000.
Στοιχεία όπως οι διευθύνσεις URL εικόνων δεν περιλαμβάνονται στον υπολογισμό του μήκους.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Απενεργοποίηση σχολιασμού πολλαπλών γραμμών
Από προεπιλογή, το FastComments θα επιτρέψει στον χρήστη να εισάγει ένα σχόλιο με όσες γραμμές θέλει, μέχρι το προεπιλεγμένο όριο χαρακτήρων.
Ωστόσο, μπορεί να είναι επιθυμητό να περιορίσετε τον χρήστη ώστε να εισάγει μόνο μία γραμμή κειμένου. Μερικά παραδείγματα χρήσης περιλαμβάνουν ηλεκτρονικές δημοπρασίες ή ζωντανή συνομιλία, για τις οποίες το FastComments μπορεί να χρησιμοποιηθεί.
Ενεργοποιούμε τη useSingleLineCommentInput σημαία ως εξής:
Run Αυτό μπορεί επίσης να γίνει χωρίς κώδικα. Στη σελίδα προσαρμογής του widget, δείτε την ενότητα "Ενεργοποίηση εισαγωγής σχολίου μίας γραμμής".
Σημειώστε ότι, τα σχόλια σε κάθε σελίδα για κάθε κατεύθυνση ταξινόμησης υπολογίζονται προ-υπολογισμένα, οπότε όλες οι κατευθύνσεις ταξινόμησης έχουν την ίδια απόδοση.
Περιορισμός όγκου σχολίων ανά χρήστη
Κατά προεπιλογή, κάθε χρήστης μπορεί να υποβάλει έως 5 comments στο ίδιο λεπτό.
Αυτό παρακολουθείται με βάση το user id, το anon user id και το ip address (hashed).
Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Σημειώστε ότι αν χρησιμοποιείτε το comment creation API ίσως θελήσετε να περάσετε το αρχικό ip address του χρήστη στο αίτημα προς το backend μας, ώστε ο περιορισμός ρυθμού να εφαρμόζεται ανά χρήστη και όχι συνολικά στον λογαριασμό σας.
Αποτροπή νέων σχολίων πρώτου επιπέδου
Ορίζοντας την noNewRootComments σε true θα προκαλέσει το widget να κρύψει τη περιοχή απάντησης ρίζας, αλλά θα επιτρέψει στους χρήστες να απαντούν
σε υποσχόλια. Μπορείτε, για παράδειγμα, να το ορίσετε υπό όρο κατά τη φόρτωση της σελίδας, ώστε να επιτρέπεται μόνο σε ορισμένους χρήστες να αφήνουν σχόλια πρώτου επιπέδου.
Run Μέγιστο βάθος απαντήσεων
Από προεπιλογή, το FastComments επιτρέπει απεριόριστη εμφώλευση απαντήσεων, δημιουργώντας μια δομή συζήτησης όπου οι χρήστες μπορούν να απαντούν σε απαντήσεις επ' αόριστον.
Η επιλογή maxReplyDepth σας επιτρέπει να περιορίσετε πόσο βαθιά μπορούν να φτάσουν τα νήματα απαντήσεων. Όταν επιτευχθεί το μέγιστο βάθος, οι χρήστες δεν θα βλέπουν πλέον κουμπί απάντησης σε σχόλια σε εκείνο το επίπεδο.
Run Με το maxReplyDepth ορισμένο σε 2:
- Οι χρήστες μπορούν να σχολιάζουν στο ανώτερο επίπεδο (βάθος 0)
- Οι χρήστες μπορούν να απαντούν σε σχόλια ανώτερου επιπέδου (βάθος 1)
- Οι χρήστες μπορούν να απαντούν σε αυτές τις απαντήσεις (βάθος 2)
- Δεν επιτρέπονται περαιτέρω απαντήσεις πέραν του βάθους 2
Ορίζοντας το σε 1 θα επιτρέπονται μόνο απαντήσεις σε σχόλια ανώτερου επιπέδου, δημιουργώντας μια πιο επίπεδη δομή συζήτησης.
Ορίζοντας το maxReplyDepth σε 0 θα απενεργοποιηθούν όλες οι απαντήσεις, επιτρέποντας μόνο σχόλια ανώτερου επιπέδου. Αν δεν οριστεί, οι απαντήσεις μπορούν να εμφωλεύονται χωρίς όριο.
Επισκόπηση Ενιαίας Σύνδεσης (SSO)
Το SSO, ή single-sign-on, είναι ένα σύνολο συμβάσεων που χρησιμοποιείται για να επιτρέψει σε εσάς ή στους χρήστες σας να χρησιμοποιείτε το FastComments χωρίς να χρειάζεται να δημιουργήσετε άλλο λογαριασμό.
Αν υποθέσουμε ότι δεν επιτρέπετε ανώνυμα σχόλια, απαιτείται λογαριασμός για να σχολιάσει κάποιος με το FastComments. Κάνουμε αυτή τη διαδικασία εγγραφής πολύ απλή - ο χρήστης απλώς αφήνει το email του όταν σχολιάζει. Ωστόσο, κατανοούμε ότι ακόμα και αυτό είναι επιπλέον τριβή που κάποια sites θέλουν να αποφύγουν.
Μπορούμε να μειώσουμε αυτή την τριβή έχοντας μόνο μια ροή σύνδεσης για ολόκληρο το site σας.
How do I get it?
Όλοι οι τύποι λογαριασμών αποκτούν πρόσβαση στο SSO. Ωστόσο, ο μέγιστος αριθμός χρηστών SSO ποικίλλει ανάλογα με το πακέτο σας. Όπως με άλλα χαρακτηριστικά, τα Pro πλάνα και υψηλότερα παρέχουν άμεση υποστήριξη ανάπτυξης.
Ας συγκρίνουμε τις επιλογές και μετά ας δούμε λεπτομέρειες για κάθε μία.
User and Comment Migrations
Όταν μετακινείστε από μια πλατφόρμα με SSO όπως το Disqus, θα έχετε ήδη χρήστες και τα σχόλιά τους.
Τα σχόλια εισάγονται ως μέρος της μετανάστευσής σας, είτε μέσω του API, είτε μέσω του Import UI, είτε μέσω της υποστήριξης πελατών. Το Import UI προτιμάται εάν υποστηρίζει την πλατφόρμα από την οποία μετακινείστε, καθώς ενσωματώνει χειρισμό σφαλμάτων, εξαγωγή και ανέβασμα avatar και μέσων, και ένα σύστημα παρακολούθησης εργασιών παρτίδας.
Οι ίδιοι οι χρήστες προστίθενται αυτόματα όταν βλέπουν για πρώτη φορά νήματα σχολίων. Εναλλακτικά, μπορούν να προ-προστεθούν μέσω του API, αλλά αυτή η δουλειά δεν έχει πολλά πλεονεκτήματα.
Εάν τα σχόλια εισαχθούν και οι χρήστες SSO δεν προστεθούν χειροκίνητα μέσω του API, τότε τα σχόλια θα μεταφερθούν αυτόματα στον λογαριασμό του χρήστη την πρώτη φορά που θα δημιουργηθεί όταν δει οποιοδήποτε νήμα σχολίων. Θα μπορούν τότε να διαχειρίζονται, να επεξεργάζονται και να διαγράφουν τα σχόλια που αρχικά έγραψαν.
Η αυτόματη μετανάστευση γίνεται μέσω email ή username. Ορισμένες πλατφόρμες δεν παρέχουν emails κατά την εξαγωγή, όπως το Disqus, οπότε σε αυτή την περίπτωση χρησιμοποιούμε ως εναλλακτική το username.
- Εφόσον παρέχετε ένα ταιριαστό username, και ένα email στο SSO payload, θα προσθέσουμε το email στα μεμονωμένα αντικείμενα σχολίων ώστε οι ειδοποιήσεις και οι αναφορές να λειτουργούν.
Εάν επιθυμείτε να εισαγάγετε τα σχόλια και τους χρήστες ταυτόχρονα, συνεργαστείτε με την υποστήριξη για να μεταφέρετε τα σχόλια στους αντίστοιχους λογαριασμούς των χρηστών αφού οι χρήστες εισαχθούν μέσω του API.
Συνοψίζοντας, η πιο εύκολη πορεία για τη μετανάστευση είναι:
- Εισαγάγετε τα σχόλια.
- Τα avatars και άλλα μέσα μεταφέρονται αυτόματα εάν χρησιμοποιείτε το Import UI στο
Manage Data -> Imports.
- Τα avatars και άλλα μέσα μεταφέρονται αυτόματα εάν χρησιμοποιείτε το Import UI στο
- Ρυθμίστε Secure ή Simple SSO.
- Αφήστε τη μετανάστευση να συμβεί ανά χρήστη αυτόματα όταν συνδεθούν για πρώτη φορά.
- Αυτό συνήθως προσθέτει λιγότερο από ένα δευτερόλεπτο στο χρόνο φόρτωσης της σελίδας αν ο χρήστης έχει λιγότερα από 50k σχόλια.
WordPress Users
Εάν χρησιμοποιείτε το πρόσθετό μας για WordPress, τότε δεν χρειάζεται να γράψετε κώδικα! Απλώς πηγαίνετε στη Σελίδα διαχείρισης του πρόσθετου, κάντε κλικ στις Ρυθμίσεις SSO, και μετά Ενεργοποίηση.
Αυτό θα σας οδηγήσει σε έναν οδηγό με ένα κουμπί που θα δημιουργήσει το API key σας, θα το στείλει στην εγκατάσταση WordPress σας και θα ενεργοποιήσει το SSO. Το έχουμε ενοποιήσει σε ένα μόνο κλικ για εσάς.
Σημειώστε ότι αν εγκαθιστάτε το πρόσθετο για πρώτη φορά θα πρέπει να ολοκληρώσετε τη διαδικασία εγκατάστασης πριν δείτε τη σελίδα διαχείρισης με το κουμπί Ρυθμίσεις SSO.
WordPress SSO - Moderators
Σημειώστε ότι αυτή τη στιγμή για να εμφανίζεται η ένδειξη «Διαχειριστής» δίπλα στους moderators όταν σχολιάζουν με το πρόσθετο FastComments για WordPress, πρέπει επίσης να προστεθούν ως Διαχειριστές στον πίνακα ελέγχου του FastComments, και να έχουν το email τους επαληθευμένο.
Custom Integrations
Για προσαρμοσμένες ενσωματώσεις, υπάρχουν δύο επιλογές.
Option One - Secure SSO
Με το Secure SSO, το FastComments γνωρίζει ότι ο χρήστης που σχολιάζει, ψηφίζει και διαβάζει σχόλια είναι ένας πραγματικός χρήστης στον ιστότοπό σας.
Εφόσον δημιουργήσετε ένα έγκυρο payload, ο χρήστης θα έχει πάντα μια αδιάκοπη εμπειρία σχολιασμού.
Με το Secure SSO, το SSO payload δημιουργείται από την πλευρά του server χρησιμοποιώντας HMAC authentication και στη συνέχεια μεταβιβάζεται στο widget στον πελάτη.
Με το Secure SSO, ο λογαριασμός του χρήστη είναι εντελώς ξεχωριστός από το υπόλοιπο user-base του FastComments. Αυτό σημαίνει ότι αν έχουμε δύο συνεργάτες Company A και Company B, ο καθένας μπορεί να έχει έναν χρήστη SSO με το username "Bob".
Requirements
- Κάποιες βασικές γνώσεις ανάπτυξης backend.
- Κάποιες βασικές γνώσεις διαχείρισης μυστικών API keys.
- Κάποιες βασικές γνώσεις ανάπτυξης API ή server-side rendering.
Pros
- Ασφαλές.
- Αδιάλειπτη εμπειρία σχολιασμού.
Cons
- Απαιτεί ανάπτυξη backend.
Updating User Data
Με το Secure SSO, κάθε φορά που στέλνετε το sso user payload, θα ενημερώνουμε τον χρήστη με τις πιο πρόσφατες πληροφορίες. Για παράδειγμα, αν
ο χρήστης έχει username X, και εσείς περάσετε Y στο SSO payload, το username του θα γίνει Y.
Εάν θέλετε να αφαιρέσετε τιμές χρησιμοποιώντας αυτή την προσέγγιση τότε ορίστε τις σε null (όχι undefined).
Secure SSO API
Παρέχουμε επίσης ένα API για αλληλεπίδραση με τους χρήστες SSO. Δείτε την τεκμηρίωση.
Σημειώστε ότι όταν χρησιμοποιείτε Secure SSO, οι χρήστες δημιουργούνται αυτόματα πίσω από τα παρασκήνια κατά τη φόρτωση της σελίδας. Δεν χρειάζεται να κάνετε μαζική εισαγωγή των χρηστών σας.
Option Two - Simple SSO
Η εναλλακτική στο Secure SSO είναι να περάσετε απλώς τις πληροφορίες του χρήστη στο widget σχολιασμού.
Η παροχή email με το Simple SSO δεν είναι απαραίτητη, ωστόσο χωρίς αυτό τα σχόλιά τους θα εμφανίζονται ως "Unverified".
Σημείωση! Από τις αρχές του 2022 τα usernames με το Simple SSO δεν χρειάζεται να είναι μοναδικά σε όλο το FastComments.com.
Ιδανικά, το Simple SSO θα πρέπει να επιλέγεται μόνο όταν αναπτύσσετε σε μια πλατφόρμα που δεν παρέχει πρόσβαση στο backend.
Requirements
- Κάποιες βασικές γνώσεις ανάπτυξης από την πλευρά του πελάτη.
- Πρέπει να γνωρίζετε τουλάχιστον το email του χρήστη.
Pros
- Απλό.
- Όλη η δραστηριότητα εξακολουθεί να επαληθεύεται.
- Ο χρήστης δεν εισάγει ποτέ το username ή το email του.
Cons
- Λιγότερο ασφαλές από το Secure SSO καθώς το payload από την πλευρά του client θα μπορούσε να κατασκευαστεί έτσι ώστε να γίνει οποιοσδήποτε χρήστης.
Simple SSO API
Οι χρήστες που δημιουργούνται αυτόματα μέσω της ροής Simple SSO αποθηκεύονται ως αντικείμενα SSOUser. Μπορούν να προσπελαστούν και να διαχειριστούν μέσω του SSOUser API. Δείτε την τεκμηρίωση.
Προσαρμοσμένες Ενσωματώσεις - Ασφαλής Ενιαία Σύνδεση (SSO)
FastComments Secure SSO χρησιμοποιεί κρυπτογράφηση HMAC-SHA256 ως τον μηχανισμό υλοποίησης του SSO. Πρώτα θα δούμε την συνολική αρχιτεκτονική, θα παρέχουμε παραδείγματα και λεπτομερή βήματα.
Υπάρχει επίσης κάποια τεκμηρίωση σχετικά με τη μετανάστευση από άλλους παρόχους με παρόμοιους μηχανισμούς SSO, και τις διαφορές.
Η ροή έχει ως εξής:
Εφόσον το Secure SSO περιλαμβάνει ανάπτυξη πλήρους στοίβας, πλήρη λειτουργικά παραδείγματα κώδικα σε Java/Spring, NodeJS/Express, και vanilla PHP βρίσκονται στο GitHub.
Αν και χρησιμοποιούμε ExpressJS στο παράδειγμα NodeJS και Spring στο παράδειγμα Java, δεν απαιτούνται πλαίσια/βιβλιοθήκες σε αυτά τα runtime για να υλοποιήσετε το FastComments SSO - οι εγγενείς βιβλιοθήκες κρυπτογραφίας αρκούν.
Δεν χρειάζεται να γράψετε νέα API endpoints με το FastComments SSO. Απλά κρυπτογραφήστε τις πληροφορίες του χρήστη χρησιμοποιώντας το secret key σας και περάστε το payload στο comment widget.
Get Your API Secret Key
Το μυστικό API σας μπορεί να ανακτηθεί από αυτή τη σελίδα. Μπορείτε επίσης να βρείτε αυτή τη σελίδα πηγαίνοντας στο My Account, κάνοντας κλικ στο πλακίδιο API/SSO, και στη συνέχεια κάνοντας κλικ στο "Get API Secret Key".
Comment Widget Parameters
Υψηλού επιπέδου τεκμηρίωση API για το comment widget μπορεί να βρεθεί εδώ.
Ας δούμε λεπτομερέστερα τι σημαίνουν αυτές οι παράμετροι.
Το comment widget παίρνει ένα αντικείμενο ρυθμίσεων - ήδη περνάτε αυτό εάν χρησιμοποιείτε το FastComments για να δώσετε το customer id σας (που ονομάζεται tenantId).
Για να ενεργοποιήσετε το SSO, περάστε ένα νέο αντικείμενο "sso", το οποίο πρέπει να έχει τις ακόλουθες παραμέτρους. Οι τιμές πρέπει να δημιουργούνται από το server.
- userDataJSONBase64: Τα δεδομένα του χρήστη σε μορφή JSON, τα οποία στη συνέχεια κωδικοποιούνται σε Base64.
- verificationHash: Το HMAC-SHA256 hash που δημιουργείται από το UNIX_TIME_MILLIS + userDataJSONBase64.
- timestamp: Epoch timestamp, σε milliseconds. Δεν πρέπει να είναι στο μέλλον, ή περισσότερο από δύο μέρες στο παρελθόν.
- loginURL: Ένα URL που το comment widget μπορεί να εμφανίσει για να συνδεθεί ο χρήστης.
- logoutURL: Ένα URL που το comment widget μπορεί να εμφανίσει για να αποσυνδεθεί ο χρήστης.
- loginCallback: Όταν παρέχεται αντί του login URL, μια συνάρτηση που το comment widget θα καλεί όταν γίνει κλικ στο κουμπί σύνδεσης.
- logoutCallback: Όταν παρέχεται αντί του logout URL, μια συνάρτηση που το comment widget θα καλεί όταν γίνει κλικ στο κουμπί αποσύνδεσης.
Το Αντικείμενο Χρήστη
Το αντικείμενο User περιέχει το ακόλουθο σχήμα:
Συντονιστές και Διαχειριστές
Για τους admins και τους moderators, περάστε τα αντίστοιχα flags isAdmin ή isModerator στο αντικείμενο SSOUser.
Ειδοποιήσεις
Για να ενεργοποιήσετε ή να απενεργοποιήσετε τις ειδοποιήσεις, ορίστε την τιμή του optedInNotifications σε true ή false αντίστοιχα. Την πρώτη φορά που ο χρήστης φορτώνει τη σελίδα με αυτή την τιμή στο SSO payload, οι ρυθμίσεις ειδοποιήσεων του θα ενημερωθούν.
Επιπλέον, εάν θέλετε οι χρήστες να λαμβάνουν email ειδοποιήσεων για δραστηριότητα σε σελίδες στις οποίες έχουν εγγραφεί (σε αντίθεση με μόνο in-app ειδοποιήσεις), τότε ορίστε το optedInSubscriptionNotifications σε true.
VIP Users & Special Labels
Μπορείτε να εμφανίσετε μια ειδική ετικέτα δίπλα στο όνομα του χρήστη χρησιμοποιώντας το προαιρετικό πεδίο "displayLabel".
Μη αυθεντικοποιημένοι χρήστες
Για να αναπαραστήσετε έναν μη αυθεντικοποιημένο χρήστη, απλά μην συμπληρώσετε τα userDataJSONBase64, verificationHash, ή timestamp. Παρέχετε ένα loginURL.
Αυτοί οι χρήστες δεν θα μπορούν να σχολιάσουν, και αντ' αυτού θα τους παρουσιαστεί ένα μήνυμα σύνδεσης (μήνυμα, σύνδεσμος, ή κουμπί, ανάλογα με τη διαμόρφωση).
Άμεσα Παραδείγματα για Σειριοποίηση και Δημιουργία Hash των Δεδομένων Χρήστη
Περισσότερες λεπτομέρειες και παραδείγματα εδώ (js), εδώ (java) και εδώ (php).
Κατανοούμε ότι οποιαδήποτε ενσωμάτωση μπορεί να είναι μια περίπλοκη και επώδυνη διαδικασία. Μη διστάσετε να επικοινωνήσετε με τον εκπρόσωπό σας ή να χρησιμοποιήσετε τη σελίδα υποστήριξης.
Προσαρμοσμένες Ενσωματώσεις - Απλή Ενιαία Σύνδεση (SSO)
Με το Simple SSO, μπορούμε να παρέχουμε στο widget σχολιασμού πληροφορίες για τον χρήστη ώστε να μην χρειάζεται να εισάγει το όνομα χρήστη ή το email του για να σχολιάσει.
Μπορούμε να ρυθμίσουμε το Simple SSO ως εξής:
Run Ο χρήστης θα είναι συνδεδεμένος και θα δημιουργηθεί ένας SSO χρήστης στο παρασκήνιο. Ο χρήστης θα έχει την ιδιότητα createdFromSimpleSSO ορισμένη σε true αν ανακτηθεί από το API.
Σημειώσεις:
- Το email είναι ο μοναδικός αναγνωριστής για το Simple SSO.
- Η παροχή email με το Simple SSO δεν είναι απαραίτητη, ωστόσο από προεπιλογή τα σχόλιά τους θα εμφανίζονται ως "Μη Επαληθευμένο". Εάν δεν παρέχεται email, ο χρήστης δεν μπορεί να πιστοποιηθεί πλήρως.
- ΝΕΟ Από Ιαν 2022: Τα ονόματα χρήστη δεν χρειάζεται να είναι μοναδικά σε όλο το fastcomments.com
- Το Simple SSO μπορεί να δημιουργεί και να ενημερώνει αυτόματα SSO χρήστες, εάν παρέχεται email, και εφόσον ο χρήστης δεν είχε αρχικά δημιουργηθεί μέσω Secure SSO.
- Μπορείτε να καθορίσετε διακριτικά για τον χρήστη με την ιδιότητα
badgeConfig. Ο πίνακαςbadgeIdsπεριέχει τα IDs των διακριτικών που θα συσχετιστούν με τον χρήστη. Εάν τοoverrideοριστεί σεtrue, θα αντικαταστήσει όλα τα υπάρχοντα διακριτικά που εμφανίζονται στα σχόλια· εάν σεfalse, θα προστεθεί στα υπάρχοντα διακριτικά.
Προσαρμοσμένες Ενσωματώσεις - Μεταφορά από Disqus SSO
Οι μεγαλύτερες διαφορές μεταξύ του Disqus και του FastComments Secure SSO είναι ότι το Disqus χρησιμοποιεί SHA1 για κρυπτογράφηση, ενώ εμείς χρησιμοποιούμε SHA256. Αυτό σημαίνει ότι η μετανάστευση από το Disqus είναι εύκολη - αλλάξτε τον αλγόριθμο κατακερματισμού που χρησιμοποιείται από SHA1 σε SHA256 και ενημερώστε τα ονόματα ιδιοτήτων που περνιούνται στο UI.
Προσαρμοσμένες Ενσωματώσεις - Μεταφορά από Commento SSO
Το Commento χρησιμοποιεί μια ριζικά διαφορετική προσέγγιση SSO - απαιτεί να έχετε ένα endpoint το οποίο καλεί για να πιστοποιήσει τον χρήστη. Το FastComments είναι το αντίστροφο - απλώς κωδικοποιήστε και κάντε hash τις πληροφορίες του χρήστη χρησιμοποιώντας το μυστικό σας κλειδί και προωθήστε τις.
Προστασία νημάτων σχολίων με Ενιαία Σύνδεση (SSO)
Το FastComments SSO (λεπτομέρειες εδώ) δίνει στους χρήστες σας έναν τρόπο να σχολιάζουν χωρίς να χρειάζεται να συνδεθούν σε άλλη πλατφόρμα.
Ωστόσο, αυτό από μόνο του δεν ασφαλίζει τις συζητήσεις σχολίων σας, αφού από προεπιλογή τα δεδομένα σχολίων είναι δημόσια διαθέσιμες πληροφορίες - οποιοσδήποτε μπορεί να δει τη σελίδα μπορεί να δει και τα σχόλια.
Αλλάζοντας μία ρύθμιση, μπορούμε να περιορίσουμε την ανάκτηση των σχολίων εκτός αν γίνεται από διαχειριστή ή έγκυρο χρήστη SSO.
Εγκατάσταση χωρίς κώδικα
Μπορούμε να αποτρέψουμε την προβολή και την αλληλεπίδραση με τις συζητήσεις σχολίων μας, όταν το SSO είναι ρυθμισμένο, δημιουργώντας έναν κανόνα προσαρμογής.
Κατά τη διαδικασία, αναζητήστε SSO και θα βρείτε αυτή την επιλογή:
Ενεργοποιήστε το και αποθηκεύστε τον κανόνα προσαρμογής.
Προστασία μόνο συγκεκριμένου τομέα ή σελίδας
Για να προστατεύσετε μόνο έναν συγκεκριμένο τομέα ή σελίδα, αρκεί να ρυθμίσετε τον κανόνα προσαρμογής ώστε να το κάνει.
Στην κορυφή του περιβάλλοντος προσαρμογής, θα βρείτε δύο πεδία εισόδου, Domain και URL ID.
Για να προστατέψετε απλώς έναν συγκεκριμένο τομέα, εισάγετε το σχετικό domain στο πεδίο "domain".
Για να προστατέψετε μια συγκεκριμένη σελίδα, εισάγετε το URL της σελίδας στο πεδίο "URL ID". Αν έχετε μια προσαρμοσμένη ενσωμάτωση με το FastComments, μπορείτε να εισάγετε εδώ έναν τύπο ID αντί για URL.
Επίπεδα ασφάλειας
Όταν απαιτείτε SSO, θα πρέπει να αποφασίσετε αν ζητάτε Simple SSO ή Secure SSO. Αν απαιτείτε Simple SSO, τότε επιτρέπονται και τα δύο, αλλά αν απαιτείτε Secure SSO τότε το περιεχόμενο πρέπει να ανακτηθεί με ένα payload Secure SSO κατακερματισμένο (hashed) με το API key σας για να μπορεί να προβληθεί.
Η επιλογή επιπέδου ασφάλειας θα εμφανιστεί όταν επιλέξετε "Require SSO To View Comments".
Προστασία πέραν της ανάγνωσης
Η ενεργοποίηση αυτής της επιλογής θα προστατεύσει τη σελίδα ή τον τομέα από το να σχολιάζεται εκτός αν ο χρήστης είναι συνδεδεμένος μέσω SSO.
Σημεία προσοχής
Οποιοιδήποτε χρήστες δημιούργησαν σχόλια πριν από την ενσωμάτωση SSO σας δεν θα μπορούν να τα δουν, εκτός αν συνδεθούν μέσω της ενσωμάτωσης SSO σας.
Επιτρέπονται ανώνυμα σχόλια
Εξ ορισμού, το FastComments θα απαιτεί ένα email για να σχολιάσει. Δεν χρειάζεται να είναι έγκυρο email, ωστόσο μέχρι ο χρήστης να κάνει κλικ σε έναν σύνδεσμο που του στάλθηκε, το σχόλιό του θα εμφανίζει την ετικέτα "Unverified Comment".
Ωστόσο, μπορούμε να καταργήσουμε την απαίτηση για email. Το πεδίο εισαγωγής email θα εξακολουθεί να εμφανίζεται, αλλά δεν θα είναι πλέον υποχρεωτικό.
Αυτό μπορεί να ρυθμιστεί μέσω του UI προσαρμογής του widget:
Αποτροπή λήξης ανώνυμων σχολίων
Το FastComments μπορεί να ρυθμιστεί ώστε να αφαιρεί μη επαληθευμένα σχόλια μετά από έναν επιθυμητό αριθμό ημερών. Αυτό βοηθά στην αντιμετώπιση του spam.
Κατά προεπιλογή, δεν το κάνει.
Αυτό μπορεί να ρυθμιστεί, ή να απενεργοποιηθεί, μέσω της σελίδας Ρυθμίσεις Εποπτείας.
Απενεργοποίηση πεδίων email
Όταν οι χρήστες σχολιάζουν και δεν είναι συνδεδεμένοι, θα τους ζητείται να παρέχουν το email τους.
Αυτό θα δημιουργήσει μια "μη επαληθευμένη συνεδρία" για εκείνον τον χρήστη, και θα τους ζητήσουμε να επαληθεύσουν αυτή τη συνεδρία μέσω email.
Για ορισμένες ιστοσελίδες ή εφαρμογές, είναι επιθυμητό να μην ζητείται από τον χρήστη το email του όταν σχολιάζει ή ψηφίζει.
Ενεργοποίηση ανώνυμων σχολίων καθιστά το πεδίο εισαγωγής email προαιρετικό. Ωστόσο, μπορούμε να το απενεργοποιήσουμε εντελώς. Αρχικά, ενεργοποιήστε τα ανώνυμα σχόλια, και στη συνέχεια θα εμφανιστεί η επιλογή για απενεργοποίηση των πεδίων εισαγωγής email.
Με αυτό ενεργοποιημένο, τα πεδία email δεν θα εμφανίζονται καθόλου σε όλα τα προϊόντα σχολιασμού μας.
Σημειώστε ότι, με αυτή τη διαμόρφωση, όλα τα σχόλια θα είναι μη επαληθευμένα εκτός αν ο χρήστης δημιουργήσει λογαριασμό και συνδεθεί στο https://fastcomments.com.
Μπορεί να θέλετε να εξετάσετε το απενεργοποίηση της ετικέτας μη επαληθευμένου.
Απενεργοποίηση ετικέτας μη επαληθευμένου
Από προεπιλογή, το FastComments θα εμφανίζει μια ετικέτα "Μη Επαληθευμένο Σχόλιο" για σχόλια που έχουν γίνει για έναν χρήστη που έχει μη επαληθευμένη συνεδρία προγράμματος περιήγησης. Διαβάστε περισσότερα για τα μη επαληθευμένα σχόλια εδώ.
Run Επιπλέον, αυτή η λειτουργία μπορεί να χρησιμοποιηθεί, χωρίς να γράψετε κώδικα, στην Διεπαφή Προσαρμογής:
Επιτρέπονται ανώνυμες ψήφοι
Όταν οι χρήστες προσπαθούν να ψηφίσουν ένα σχόλιο και δεν είναι συνδεδεμένοι, θα τους ζητηθεί να δώσουν το όνομα χρήστη και το email τους.
Μπορούμε να καταργήσουμε αυτή την απαίτηση, επιτρέποντας σε οποιονδήποτε να ψηφίσει ένα σχόλιο χωρίς να παρέχει καμία πληροφορία.
Ορισμός προεπιλεγμένου ονόματος χρήστη
Όταν οι χρήστες σχολιάζουν ή ψηφίζουν, και δεν έχουν συνδεθεί, θα τους ζητηθεί να παρέχουν τη διεύθυνση email και το όνομα χρήστη τους.
Σε περίπτωση ανώνυμων σχολίων, κάποιες φορές είναι επιθυμητό να οριστεί ένα προεπιλεγμένο όνομα χρήστη για να μειωθεί η τριβή όταν γίνεται σχολιασμός. Αυτό μπορεί να γίνει από τη Διεπαφή Προσαρμογής. Τα ανώνυμα σχόλια πρέπει πρώτα να είναι ενεργοποιημένα.
Κλήσεις επιστροφής
Όλες οι βιβλιοθήκες για το widget σχολίων (προς το παρόν Angular, React, Vue) υποστηρίζουν callbacks.
Οι callbacks ορίζονται στο αντικείμενο ρυθμίσεων, με την ίδια υπογραφή για κάθε βιβλιοθήκη.
Οι υποστηριζόμενες callbacks είναι:
- onInit
- onAuthenticationChange
- onRender
- commentCountUpdated
- onReplySuccess
- onVoteSuccess
- onImageClicked
- onOpenProfile
- onCommentSubmitStart
- onCommentsRendered
Οι ακριβείς υπογραφές μπορούν να βρεθούν στις Ορισμοί TypeScript.
Ακολουθεί ένα παράδειγμα με όλες τις callbacks:
Run Χειροκίνητος ορισμός τοπικής ρύθμισης του χρήστη
Από προεπιλογή, το FastComments θα αποδώσει το widget σχολιασμού στην locale που καθορίζεται από το σύστημα και τον περιηγητή του χρήστη.
Όταν ένας χρήστης σχολιάζει ή συνδέεται, ενημερώνουμε την τελευταία locale που χρησιμοποίησε και τη χρησιμοποιούμε επίσης για την αποστολή email.
Αυτό επηρεάζει τον τρόπο με τον οποίο μεταφράζεται το widget σχολιασμού για τον χρήστη. Η locale αποτελείται από τη γλώσσα και την περιοχή του χρήστη, οπότε η ρύθμιση της locale συνήθως θα αλλάξει τη γλώσσα που χρησιμοποιείται για να εμφανίζεται το κείμενο στον χρήστη.
Μέσω του UI
Αυτό μπορεί να οριστεί χρησιμοποιώντας τη διεπαφή προσαρμογής του widget. Δείτε την επιλογή "Locale / Language":
Μέσω κώδικα
Αυτό μπορεί να παρακαμφθεί με την επιθυμητή locale.
Run Υποστηριζόμενες γλώσσες και κωδικοί locale
Σημείωση SSO
Εάν χρησιμοποιείτε SSO, ίσως θελήσετε να περάσετε την locale του χρήστη στο user object, ώστε τα email και άλλα στοιχεία να είναι σωστά τοπικοποιημένα για τον χρήστη.
Περιορισμός επιτρεπόμενων γλωσσών
Από προεπιλογή, το FastComments δεν περιορίζει τις γλώσσες που χρησιμοποιούνται για σχόλια.
Ίσως είναι επιθυμητό να περιοριστούν οι γλώσσες που χρησιμοποιεί μια κοινότητα.
Αυτό μπορεί να ρυθμιστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Το σύστημα θα αναλύσει το σχόλιό τους και θα προσδιορίσει τη γλώσσα του, και στη συνέχεια θα το αντιστοιχίσει με τη λίστα επιτρεπομένων.
Εάν το σχόλιο είναι γραμμένο σε γλώσσα που δεν επιτρέπεται, τότε εμφανίζεται ένα τοπικοποιημένο μήνυμα σφάλματος.
Τίτλοι σελίδων
Ο τρέχων τίτλος της σελίδας συσχετίζεται με το καθορισμένο urlId και αποθηκεύεται για χρήση στα εργαλεία διαχείρισης περιεχομένου.
Κατά προεπιλογή, αυτό ανακτάται από το document.title.
Εάν το επιθυμείτε, μπορείτε να καθορίσετε τον δικό σας τίτλο σελίδας ως εξής:
Run Αποτροπή νέων απαντήσεων και απενεργοποίηση ψήφων
Τα σχόλια μπορούν να κλειδωθούν ώστε να μην μπορούν να προστεθούν νέα σχόλια ή ψήφοι ορίζοντας τη σημαία readonly σε true.
Τα σχόλια επίσης δεν θα μπορούν να επεξεργαστούν ή να διαγραφούν.
Run Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget, για ολόκληρο domain, ή για σελίδα:
Ενημέρωση!
Από τον Νοέμβριο του 2022, τα threads μπορούν να κλειδωθούν ή να ξεκλειδωθούν σε πραγματικό χρόνο από διαχειριστές και συντονιστές μέσω του μενού με τις τρεις τελείες πάνω από την περιοχή απάντησης.
Αυτό θα αποτρέπει νέα σχόλια, ενώ ταυτόχρονα επιτρέπει την ψήφιση και δίνει τη δυνατότητα στους χρήστες να διαγράψουν τα σχόλιά τους εάν το επιθυμούν, ενώ το readonly δεν επιτρέπει αυτά.
Αυτό αντιστοιχεί στο πεδίο isClosed στο API Page.
Περιορισμός τομέων συνδέσμων
Από προεπιλογή, το FastComments επιτρέπει τη σύνδεση προς οποιονδήποτε εξωτερικό ιστότοπο.
Αυτό μπορεί να περιοριστεί ώστε να επιτρέπεται μόνο μια επιθυμητή λίστα ιστότοπων ή τομέων. Η προσπάθεια δημοσίευσης συνδέσμου προς ιστότοπο ή τομέα, που δεν περιλαμβάνεται στην ορισμένη λίστα θα προκαλέσει εμφάνιση σφάλματος στον χρήστη.
Αυτή η επαλήθευση ισχύει μόνο για το Widget Σχολίων και το API. Οι εισαγωγές δεν επηρεάζονται.
Αυτό γίνεται χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Ο αριθμός σχολίων και η καταμέτρηση όλων των εμφωλευμένων απαντήσεων
Ο αριθμός σχολίων που εμφανίζεται στην κορυφή του στοιχείου σχολιασμού μπορεί είτε να δείχνει όλα τα "σχόλια πρώτου επιπέδου", δηλαδή τις απαντήσεις που είναι απαντήσεις απευθείας στη σελίδα ή στο άρθρο, είτε να είναι καταμέτρηση όλων των εμφωλευμένων σχολίων.
Εξ ορισμού, αυτό είναι true - είναι καταμέτρηση του δεύτερου - όλων των σχολίων. Σε παλαιότερες εκδόσεις του στοιχείου σχολιασμού η προεπιλεγμένη τιμή είναι false.
Μπορούμε να αλλάξουμε τη συμπεριφορά, ώστε να είναι καταμέτρηση όλων των εμφωλευμένων σχολίων ρυθμίζοντας τη σημαία countAll σε true.
Run Αν θέλαμε η καταμέτρηση να αντανακλά μόνο τα σχόλια πρώτου επιπέδου, ορίζουμε τη σημαία σε false.
Run Αυτό προς το παρόν δεν μπορεί να προσαρμοστεί χωρίς αλλαγές στον κώδικα.
Ενεργοποίηση συνδέσμων σχολιαστών
Κατά προεπιλογή, το FastComments θα ζητά μόνο από τον χρήστη το σχόλιό του, το όνομα χρήστη και το email του.
Ωστόσο, σε ορισμένες περιπτώσεις μπορεί να θέλετε ο χρήστης να αφήνει έναν σύνδεσμο προς το δικό του blog ή ιστοσελίδα.
Μπορούμε να ενεργοποιήσουμε την εμφάνιση ενός επιπλέον πεδίου εισαγωγής για να αφήσει ο χρήστης το URL της ιστοσελίδας του ρυθμίζοντας τη σημαία enableCommenterLinks σε true:
Run Όταν δοθεί αυτό το URL, ο λογαριασμός του χρήστη θα ενημερωθεί και όλα τα ονόματα χρήστη του σε όλα τα προηγούμενα και μελλοντικά σχόλια θα συνδέονται με αυτό το URL.
Αυτό μπορεί να προσαρμοστεί χωρίς κώδικα, στη σελίδα προσαρμογής του widget:
Ομάδες εποπτείας
Μια λίστα με ids που δημιουργούνται από τη σελίδα Ομάδες Εποπτείας.
Όταν ορίζεται, τα σχόλια που αφήνονται χρησιμοποιώντας την εν λόγω ρύθμιση θα περιέχουν το ίδιο σύνολο moderationGroupIds.
Εάν ένας Moderator έχει ορισμένη μία ή περισσότερες Ομάδες Εποπτείας, θα
βλέπει μόνο τα σχόλια στη σελίδα Moderate Comments που σχετίζονται με την/τις ομάδα(ές) του.
Run Αναφορά αναγνωριστικών ομάδων
Μια λίστα αναγνωριστικών (IDs) για χρήση στην αυτόματη συμπλήρωση των @mentions. Χρήσιμο όταν θέλετε να αποτρέψετε τη σήμανση χρηστών όταν δεν έχουν κοινές ομάδες.
Όταν καθορίζεται, μόνο χρήστες από άλλες ομάδες θα εμφανίζονται στην αυτόματη συμπλήρωση μετά την πληκτρολόγηση του χαρακτήρα @.
Run Παράκαμψη cookies τρίτων
Για τον έλεγχο ταυτότητας, το FastComments εξαρτάται από τα cookies τρίτων να είναι ενεργοποιημένα στον περιηγητή σας. Χωρίς αυτά, οι χρήστες θα πρέπει πάντα να αφήνουν το e-mail τους για να σχολιάσουν (εκτός αν το πεδίο εισαγωγής e-mail είναι κρυφό), και τα σχόλιά τους θα εμφανίζονται πάντα ως μη επαληθευμένα (από προεπιλογή).
Για να το παρακάμψετε, μπορείτε να ενεργοποιήσετε την παράκαμψη των cookies τρίτων.
Όταν αυτή η ρύθμιση είναι ενεργοποιημένη, θα εμφανίζεται ένα μικρό αναδυόμενο παράθυρο που δείχνει ένα μήνυμα ότι ο χρήστης συνδέεται. Αυτό το αναδυόμενο εμφανίζεται κάθε φορά που ο χρήστης αλληλεπιδρά με το widget σχολίων· για παράδειγμα, αν αφήσει ένα σχόλιο.
Μπορούμε να το κάνουμε στον κώδικα θέτοντας τη σημαία enableThirdPartyCookieBypass σε true:
Run Μπορούμε επίσης να το ρυθμίσουμε μέσω της Διεπαφής Προσαρμογής Widget, κάτω από Enable Third-Party Cookie Popup:
Διαγραφή σχολίων με απαντήσεις
Εξ ορισμού, οι χρήστες μπορούν να διαγράφουν τα δικά τους σχόλια. Επιπλέον, η διαγραφή του σχολίου τους διαγράφει αυτόματα όλα τα υπο-σχόλια και τα προσωρινά σχόλια στο νήμα. Αυτή η συμπεριφορά ισχύει επίσης σε ζωντανό περιβάλλον.
Μπορείτε να περιορίσετε αυτό με τους ακόλουθους τρόπους:
- Αντίθετα, ανωνυμοποιήστε το διαγραμμένο σχόλιο (ορίστε το όνομα και το κείμενο σε
[deleted]ή σε προσαρμοσμένη τιμή). - Μην επιτρέπετε τη διαγραφή σχολίων όταν υπάρχουν απαντήσεις. Εμφανίζεται προσαρμόσιμο μήνυμα σφάλματος.
- Περιορίστε τη διαγραφή σχολίων που έχουν απαντήσεις μόνο σε διαχειριστές και συντονιστές.
Αυτό μπορεί να ρυθμιστεί μέσω της ενότητας Comment Thread Deletion στην διεπαφή προσαρμογής του widget.
Εμφάνιση διακριτικών στην κορυφαία γραμμή
Εξ ορισμού, το FastComments θα εμφανίζει τα διακριτικά των χρηστών μόνο στα σχόλιά τους μέσα στο νήμα σχολίων.
Ωστόσο, μπορούμε να εμφανίσουμε τα διακριτικά των χρηστών δίπλα στο όνομά τους πάνω από τη φόρμα σχολίου ενεργοποιώντας αυτή τη δυνατότητα στη σελίδα προσαρμογής του widget:
Αυτό θα εμφανίσει τα διακριτικά των χρηστών δίπλα στο όνομά τους στην περιοχή της επάνω γραμμής, κάνοντας τα επιτεύγματά τους και την κατάστασή τους πιο εμφανή όταν συντάσσουν ένα σχόλιο.
Σημειώστε ότι αυτή η δυνατότητα πρέπει να είναι ενεργοποιημένη στο UI προσαρμογής του widget για να λειτουργήσει. Προαιρετικά, μπορείτε να ορίσετε τη σημαία showBadgesInTopBar σε false στη διαμόρφωση του κώδικά σας για να την απενεργοποιήσετε επιλεκτικά ακόμα και όταν είναι ενεργοποιημένη σε επίπεδο διακομιστή:
Run