Προσθήκη ζωντανών σχολίων σε ιστότοπους Drupal

Αυτή είναι η σύντομη (TL;DR) έκδοση των οδηγιών για το Drupal.

1. Εγκαταστήστε το module με composer require drupal/fcom, ή τοποθετήστε το στο modules/custom/fastcomments/.
2. Ενεργοποιήστε το με drush en fastcomments, ή από το περιβάλλον διαχείρισης στη διεύθυνση /admin/modules.
3. Μεταβείτε στο Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).
4. Εισάγετε το Tenant ID και το API Secret σας από Settings > API/SSO (EU).
5. Προσθέστε το πεδίο FastComments σε οποιοδήποτε τύπο περιεχομένου μέσω Structure > Content types > [type] > Manage fields.

Το module δημοσιεύεται στο drupal.org/project/fcom.

All settings live under Administration > Configuration > Content > FastComments (/admin/config/content/fastcomments).

Απαιτείται

• Tenant ID - Το FastComments Tenant ID σας. Βρείτε το κάτω από Ρυθμίσεις > API/SSO (EU).
• API Secret - Απαιτείται για ασφαλή SSO, επαλήθευση webhook και συγχρονισμό σελίδας. Βρίσκεται κάτω από Ρυθμίσεις > API/SSO (EU).

Αποθήκευση του API Secret

Το module διαβάζει το API Secret από την πρώτη από τις παρακάτω πηγές που έχει τιμή:

1. Key module - Εγκαταστήστε το Key, δημιουργήστε ένα κλειδί Authentication και επιλέξτε το κάτω από API Secret key στη φόρμα ρυθμίσεων. Το κλειδί μπορεί να υποστηρίζεται από μια μεταβλητή περιβάλλοντος ή ένα αρχείο εκτός του web root.
2. settings.php - Προσθέστε $config['fastcomments.settings']['api_secret'] = 'your-secret'; στο settings.php ή settings.local.php. Το μυστικό δεν εισέρχεται ποτέ στην εξαγόμενη διαμόρφωση.
3. The settings form - Εισάγετε το στο πεδίο API Secret. Αυτό αποθηκεύει την τιμή στο fastcomments.settings, έτσι εμφανίζεται στις εξαγωγές διαμόρφωσης. Η αναφορά κατάστασης του Drupal προειδοποιεί όταν αυτή είναι η ενεργή πηγή.

Η φόρμα δείχνει ποια πηγή είναι ενεργή. Αφήνοντας το πεδίο κενό διατηρεί το αποθηκευμένο μυστικό. Επιλέξτε Αφαιρέστε το API Secret που αποθηκεύεται στη διαμόρφωση για να το διαγράψετε μετά τη μεταφορά του μυστικού στο Key module ή στο settings.php.

Στυλ Σχολιασμού

Επιλέξτε το widget που ταιριάζει με το πώς θέλετε οι χρήστες να μιλούν στον ιστότοπό σας.

• Live Comments - Σχόλια σε πραγματικό χρόνο με νηματοποίηση.
• Streaming Chat - Διεπαφή ζωντανής συνομιλίας, κατάλληλη για εκδηλώσεις και ζωντανές μεταδόσεις.
• Collab Chat - Σχόλιο με επισήμανση κειμένου στην κύρια περιοχή περιεχομένου. Οι επισκέπτες επισημαίνουν κείμενο και ξεκινούν συζήτηση στο πλαίσιο.
• Collab Chat + Comments - Και το collab chat και τα τυπικά σχόλια στην ίδια σελίδα.

Λειτουργία SSO

• 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, δείτε την ενότητα EU Data Residency.

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 της τεκμηρίωσης προσαρμογών.

• Drupal 10 ή 11
• PHP 8.1 ή νεότερη
• Ένας λογαριασμός FastComments

Το module δεν απαιτεί κανένα άλλο module του Drupal ή βιβλιοθήκες τρίτων. Εξαρτάται μόνο από τον πυρήνα του Drupal (user, field).

Ένα fallback <noscript> παρέχει σχόλια που αποδίδονται από τον διακομιστή για επισκέπτες χωρίς JavaScript, οπότε τα Live Comments και Streaming Chat εξακολουθούν να λειτουργούν σε προγράμματα περιήγησης στα οποία η εκτέλεση σεναρίων είναι απενεργοποιημένη.

Μόλις το FastComments είναι στον ιστότοπο Drupal σας, μπορείτε επίσης να εκτελείτε ζωντανές δημοσκοπήσεις απευθείας στα σχόλια. Ενεργοποιήστε Enable Polls στις ρυθμίσεις προσαρμογής του widget και ένα κουμπί δημοσκόπησης εμφανίζεται στη γραμμή εργαλείων του σχολίου. Οι δημοσκοπήσεις δέχονται 2 έως 10 επιλογές, τα αποτελέσματα ενημερώνονται ζωντανά για όλους στη σελίδα, και εσείς επιλέγετε ποιος μπορεί να δημιουργεί δημοσκοπήσεις και αν η ψήφος απαιτεί σύνδεση. Δεν υπάρχει κάτι άλλο να εγκαταστήσετε στο Drupal.

Try the Live Polls demo ή διαβάστε την Polls documentation για να τις ρυθμίσετε.