Add Live Commenting to Drupal Sites
Γρήγορη Εκκίνηση 
Αυτή είναι η σύντομη (TL;DR) έκδοση των οδηγιών για το Drupal.
- Εγκαταστήστε το module με
composer require drupal/fcom, ή τοποθετήστε το στοmodules/custom/fastcomments/. - Ενεργοποιήστε το με
drush en fastcomments, ή από το περιβάλλον διαχείρισης στη διεύθυνση/admin/modules. - Μεταβείτε στο
Administration > Configuration > Content > FastComments(/admin/config/content/fastcomments). - Εισάγετε το Tenant ID και το API Secret σας από Settings > API/SSO (EU).
- Προσθέστε το πεδίο
FastCommentsσε οποιοδήποτε τύπο περιεχομένου μέσωStructure > Content types > [type] > Manage fields.
Το module δημοσιεύεται στο drupal.org/project/fcom.
Εγκατάσταση
Το module FastComments για το Drupal αντικαθιστά τα ενσωματωμένα σχόλια του Drupal με ένα γρήγορο, σε πραγματικό χρόνο σύστημα σχολιασμού. Το module είναι δημοσιευμένο στο drupal.org και λειτουργεί με Drupal 10 και 11.
Υπάρχουν δύο τρόποι εγκατάστασης.
Εγκατάσταση μέσω Composer
composer require drupal/fcom
drush en fastcommentsΕγκατάσταση χειροκίνητα
Κατεβάστε το module από drupal.org/project/fcom και τοποθετήστε το στον κατάλογο modules/custom/fastcomments/ του ιστότοπού σας. Στη συνέχεια ενεργοποιήστε το με drush en fastcomments, ή από το γραφικό περιβάλλον διαχείρισης στο Extend (/admin/modules).
Σημείωση! Το module εξαρτάται μόνο από τον πυρήνα του Drupal (user και field). Δεν απαιτούνται άλλα modules ή βιβλιοθήκες του Drupal.
Μόλις ενεργοποιηθεί το module, μεταβείτε στην ενότητα Configuration για να ρυθμίσετε το Tenant ID και το API Secret.
Διαμόρφωση
Όλες οι ρυθμίσεις βρίσκονται κάτω από Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
Απαραίτητα
- Tenant ID - Το Tenant ID του FastComments σας. Find this under Settings > API/SSO (EU).
- API Secret - Απαιτείται για Secure SSO, επαλήθευση webhook και συγχρονισμό σελίδας. Found under Settings > API/SSO (EU).
Commenting Style
Επιλέξτε το widget που ταιριάζει με τον τρόπο που θέλετε να συνομιλούν οι χρήστες στον ιστότοπό σας.
- Live Comments - Σχόλια με νήματα σε πραγματικό χρόνο.
- Streaming Chat - Διεπαφή ζωντανής συνομιλίας, κατάλληλη για εκδηλώσεις και livestreams.
- Collab Chat - Σχολιασμός με επιλογή κειμένου στην κύρια περιοχή περιεχομένου. Οι επισκέπτες επισημαίνουν κείμενο και ξεκινούν μια συζήτηση στο πλαίσιο.
- Collab Chat + Comments - Και collaborative chat και τυπικά σχόλια στην ίδια σελίδα.
SSO Mode
- None - Χωρίς SSO. Οι χρήστες σχολιάζουν ως επισκέπτες ή δημιουργούν έναν λογαριασμό FastComments.
- Simple - Μεταβιβάζει πληροφορίες χρήστη του Drupal (όνομα, email, avatar) στο FastComments χωρίς επαλήθευση από τον διακομιστή.
- Secure - Χρησιμοποιεί HMAC-SHA256 για να επαληθεύει χρήστες Drupal με το FastComments. Συνιστάται όταν έχετε διαμορφώσει ένα API Secret.
Δείτε την ενότητα Single Sign-On (SSO) για λεπτομέρειες.
Άλλες Ρυθμίσεις
- CDN URL - Προεπιλογή:
https://cdn.fastcomments.com. - Site URL - Προεπιλογή:
https://fastcomments.com. - Email notifications - Αποστολή email στον συγγραφέα του περιεχομένου όταν δημοσιεύεται νέο σχόλιο στο περιεχόμενό του.
Για την κατοικία δεδομένων στην ΕΕ, δείτε την ενότητα EU Data Residency.
Μπλοκ widget
Το module περιλαμβάνει αρκετά μπλοκ που μπορείτε να τοποθετήσετε από το Structure > Block layout (/admin/structure/block).
- FastComments Widget - Το κύριο widget σχολιασμού. Ανιχνεύει αυτόματα την τρέχουσα οντότητα. Θα παραλείψει τις οντότητες που έχουν ήδη το πεδίο FastComments επισυναπτόμενο, οπότε δεν θα δείτε διπλά widgets στην ίδια σελίδα.
- FastComments Live Chat - Συνομιλία ροής σε πραγματικό χρόνο. Μπορεί να τοποθετηθεί δίπλα στο πεδίο σχολίου στην ίδια σελίδα.
- FastComments Collab Chat - Σχολιασμός και συζήτηση με επιλογή κειμένου.
- FastComments Image Chat - Σχολιασμός βάσει συντεταγμένων σε εικόνες. Οι επισκέπτες κάνουν κλικ σε μια εικόνα για να αφήσουν σχόλια συνδεδεμένα με συγκεκριμένες τοποθεσίες.
- FastComments Recent Comments - Εμφανίζει πρόσφατα σχόλια σε όλο τον ιστότοπό σας. Ο αριθμός είναι ρυθμιζόμενος στο μπλοκ.
- FastComments Top Pages - Εμφανίζει τις σελίδες του ιστότοπού σας με τα περισσότερα σχόλια.
Τα μπλοκ που επικεντρώνονται στο περιεχόμενο (Live Chat, Collab Chat, Image Chat) ανιχνεύουν αυτόματα την τρέχουσα οντότητα και καταφεύγουν σε ένα αναγνωριστικό με βάση τη διαδρομή σε σελίδες που δεν είναι οντότητες. Αυτό σημαίνει ότι λειτουργούν σε σελίδες ταξονομίας, views και προσαρμοσμένες διαδρομές χωρίς επιπλέον ρύθμιση.
Πεδία τύπου περιεχομένου
Για τις περισσότερες ιστοσελίδες, ο πιο εύκολος τρόπος για να προσθέσετε σχόλια είναι να επισυνάψετε το πεδίο FastComments στους τύπους περιεχομένου σας. Μεταβείτε στο Structure > Content types > [type] > Manage fields και προσθέστε το πεδίο.
Κάθε οντότητα που έχει το πεδίο αποκτά:
- Έναν διακόπτη κατάστασης ώστε οι συντάκτες να μπορούν να ενεργοποιούν ή να απενεργοποιούν τα σχόλια ανά οντότητα.
- Ένα προαιρετικό προσαρμοσμένο αναγνωριστικό ώστε να μπορείτε να χρησιμοποιήσετε ένα σταθερό ID που δεν συνδέεται με το μονοπάτι οντότητας του Drupal.
Το κύριο μπλοκ FastComments Widget γνωρίζει αυτό το πεδίο και θα παραλείψει οντότητες που το έχουν ήδη επισυνάψει. Με αυτόν τον τρόπο μπορείτε να συνδυάσετε σχόλια ανά οντότητα με το μπλοκ χωρίς να βλέπετε το widget δύο φορές στην ίδια σελίδα.
Ενιαία σύνδεση (SSO)
FastComments ενσωματώνεται στο σύστημα χρηστών του Drupal μέσω SSO, ή single-sign-on. Οι χρήστες σας συνδέονται στον ιστότοπό σας Drupal, και το module μεταβιβάζει αυτόματα την ταυτότητά τους στο FastComments. Δεν χρειάζεται να δημιουργηθούν επιπλέον λογαριασμοί, ούτε να τρέξει αρχικός συγχρονισμός.
Το module υποστηρίζει τρεις λειτουργίες SSO, που ρυθμίζονται στο Administration > Configuration > Content > FastComments.
Καμία
Χωρίς SSO. Οι χρήστες σχολιάζουν ως επισκέπτες ή δημιουργούν λογαριασμό FastComments. Χρησιμοποιήστε αυτό αν ο ιστότοπός σας είναι δημόσιος και δεν χρειάζεται να συσχετίσετε τα σχόλια με χρήστες Drupal.
Απλό
Μεταβιβάζει το όνομα του χρήστη Drupal, το email και το avatar στο FastComments χωρίς επαλήθευση από τον server. Δεν απαιτείται API Secret. Κατάλληλο για εσωτερικούς ή χαμηλού κινδύνου ιστότοπους.
Secure (συνιστάται)
Χρησιμοποιεί HMAC-SHA256 για να επαληθεύει κάθε ταυτότητα χρήστη με το FastComments. Αυτή είναι η λειτουργία που θέλετε όταν έχετε ρυθμίσει ένα API Secret, και είναι η μόνη λειτουργία που αποτρέπει έναν επισκέπτη από το να αναπαριστά άλλον χρήστη.
Η ταυτότητα του χρήστη μεταβιβάζεται στο FastComments κάθε φορά που ένας χρήστης βλέπει ένα νήμα σχολίων. Δεν υπάρχει αρχικός ή συνεχής συγχρονισμός που χρειάζεται να τρέξει.
(Προαιρετικό) Προσθέστε τους διαχειριστές σας στους Χρήστες & Διαχειριστές και τους συντονιστές στους Συντονιστές Σχολίων για να βελτιώσετε την εμπειρία τους και να ενεργοποιήσετε την καταγραφή στατιστικών για τους συντονιστές.
Για μια πιο αναλυτική περιγραφή του πώς λειτουργεί το SSO, δείτε την ενότητα SSO της τεκμηρίωσης προσαρμογών.
Δικαιώματα
Το module προσθέτει τρία δικαιώματα Drupal τα οποία μπορείτε να αναθέσετε ανά ρόλο κάτω από People > Permissions.
- Administer FastComments - Πρόσβαση στη φόρμα ρυθμίσεων του FastComments στη διεύθυνση
/admin/config/content/fastcomments. - View FastComments - Απαιτείται για να δείτε το widget σχολίων. Χωρίς αυτό το δικαίωμα το widget δεν θα εμφανιστεί.
- Toggle FastComments - Επιτρέπει στους χρήστες να ενεργοποιούν ή να απενεργοποιούν τα σχόλια ανά οντότητα χρησιμοποιώντας το widget πεδίου.
Από προεπιλογή, μόνο οι χρήστες με το δικαίωμα administer site configuration μπορούν να αλλάξουν τις ρυθμίσεις του FastComments. Χορηγήστε View FastComments σε ανώνυμους και πιστοποιημένους χρήστες αν θέλετε οι επισκέπτες να δουν το widget.
Πολυγλωσσικότητα
Η μονάδα προωθεί αυτόματα τη γλώσσα του τρέχοντος ιστότοπου Drupal σε κάθε widget του FastComments. Εάν ο ιστότοπός σας Drupal είναι ρυθμισμένος για πολλαπλές γλώσσες, το περιβάλλον σχολιασμού θα εμφανιστεί στην αντίστοιχη γλώσσα χωρίς καμία επιπλέον ρύθμιση.
Αυτό ισχύει για όλους τους τύπους widget: Live Comments, Streaming Chat, Collab Chat, Image Chat, Recent Comments, και Top Pages.
Αποθήκευση δεδομένων στην ΕΕ
Εάν ο λογαριασμός FastComments σας φιλοξενείται στην ΕΕ, ενημερώστε δύο ρυθμίσεις στο Administration > Configuration > Content > FastComments:
- CDN URL -
https://cdn-eu.fastcomments.com - Site URL -
https://eu.fastcomments.com
Επίσης, θα πρέπει να ανακτήσετε το Tenant ID και το API Secret από τον πίνακα ελέγχου της ΕΕ στη διεύθυνση eu.fastcomments.com/auth/my-account/api αντί για τον προεπιλεγμένο πίνακα ελέγχου των ΗΠΑ. Όλα τα υπόλοιπα στη μονάδα λειτουργούν με τον ίδιο τρόπο.
Προσαρμογή
Το FastComments έχει σχεδιαστεί ώστε να προσαρμόζεται και να ταιριάζει με τον ιστότοπό σας.
Εάν θέλετε να προσθέσετε προσαρμοσμένο στυλ ή να τροποποιήσετε τη διαμόρφωση, Δείτε την τεκμηρίωση προσαρμογής για να μάθετε πώς.
Απαιτήσεις
- Drupal 10 ή 11
- PHP 8.1 ή νεότερη
- Ένας λογαριασμός FastComments
Το module δεν απαιτεί κανένα άλλο module του Drupal ή βιβλιοθήκες τρίτων. Εξαρτάται μόνο από τον πυρήνα του Drupal (user, field).
Ένα fallback <noscript> παρέχει σχόλια που αποδίδονται από τον διακομιστή για επισκέπτες χωρίς JavaScript, οπότε τα Live Comments και Streaming Chat εξακολουθούν να λειτουργούν σε προγράμματα περιήγησης στα οποία η εκτέλεση σεναρίων είναι απενεργοποιημένη.