Add Comments to Your LMS via LTI 1.3

1. Συνδεθείτε στο FastComments και μεταβείτε στη σελίδα διαμόρφωσης LTI 1.3 σας.
2. (Προαιρετικό) Επιλέξτε την πλατφόρμα από το αναπτυσσόμενο μενού Πλατφόρμα - ορίζει την ετικέτα εμφάνισης, αλλά η αυτόματη ανίχνευση λειτουργεί καλά.
3. Κάντε κλικ στο Δημιουργία URL. Εμφανίζεται ένα εφάπαξ URL εγγραφής (ισχύει για 30 λεπτά, μόνο μία χρήση).
4. Στο LMS σας, ανοίξτε την οθόνη Dynamic Registration του LTI 1.3 και επικολλήστε το URL στο πεδίο Tool initiation registration endpoint (ή ισοδύναμο). Υποβάλετε.
5. Το LMS σας εκτελεί κλήση επιστροφής προς το FastComments, ανταλλάσσει κλειδιά και δημιουργεί την ενσωμάτωση. Το αναδυόμενο παράθυρο κλείνει αυτόματα όταν ολοκληρωθεί.
6. Επιστρέφοντας στο FastComments, η νέα διαμόρφωση εμφανίζεται στον πίνακα Υπάρχουσες Διαμορφώσεις. Το εργαλείο είναι πλέον διαθέσιμο μέσα στα μαθήματά σας στο LMS.

FastComments LTI 1.3 έχει δοκιμαστεί με:

• D2L Brightspace (οποιαδήποτε έκδοση με LTI Advantage)
• Moodle 4.0+ (External Tool plugin, LTI Advantage)
• Blackboard Learn (SaaS και Ultra)
• Sakai (εκδόσεις με υποστήριξη LTI Advantage)
• Schoology (Enterprise, Dynamic Registration όπου είναι διαθέσιμο)

Οποιοδήποτε άλλο LMS που υλοποιεί το πρότυπο IMS LTI 1.3 Advantage με Dynamic Registration θα πρέπει επίσης να λειτουργεί - επιλέξτε Other LTI 1.3 platform από το αναπτυσσόμενο μενού πλατφόρμας όταν δημιουργείτε το URL εγγραφής σας (λάβετε το εδώ).

Canvas LMS χρησιμοποιεί διαφορετική διαδικασία ρύθμισης (per-developer-key configuration JSON αντί για Dynamic Registration). Δείτε τον αφιερωμένο οδηγό εγκατάστασης για το Canvas LMS.

Πλοηγηθείτε στη Διαμόρφωση LTI 1.3

Συνδεθείτε στο FastComments και μεταβείτε στη σελίδα Διαμόρφωσης LTI 1.3 σας.

Εάν ο λογαριασμός σας δεν έχει ακόμη πρόσβαση σε LTI, θα δείτε "LTI not enabled for this account" - επικοινωνήστε με την υποστήριξη για να το ενεργοποιήσουν στο πλάνο σας.

Επιλέξτε μια Πλατφόρμα (Προαιρετικό)

Κάτω από Δημιουργία Δυναμικού URL Εγγραφής, χρησιμοποιήστε το αναπτυσσόμενο μενού Πλατφόρμα για να πείτε στο FastComments σε ποιο LMS συνδέεστε:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Other LTI 1.3 platform

Μπορείτε επίσης να το αφήσετε στο Αυτόματη ανίχνευση. Η πλατφόρμα διαβάζεται από το openid-configuration του LMS σας κατά την εγγραφή· το αναπτυσσόμενο μενού απλώς αρχικοποιεί την ετικέτα εμφάνισης για την προκύπτουσα διαμόρφωση.

Δημιουργία του URL

Κάντε κλικ στο Generate URL. Το FastComments δημιουργεί ένα token εγγραφής μίας χρήσης και σας εμφανίζει ένα URL που μοιάζει με:

https://fastcomments.com/lti/v1p3/register/<long-token>

Αντιγράψτε το. Αυτό το URL:

• Είναι για μία μόνο χρήση - μόλις το LMS σας το καλέσει επιτυχώς, το token καταναλώνεται.
• Λήγει μετά από 30 λεπτά αν δεν χρησιμοποιηθεί.
• Πρέπει να παραμένει ιδιωτικό - οποιοσδήποτε έχει το URL μπορεί να εγγράψει ένα εργαλείο στο tenant σας εντός αυτών των 30 λεπτών.

Υπάρχουσες Διαμορφώσεις

Μόλις ολοκληρωθεί επιτυχώς μια εγγραφή, η νέα διαμόρφωση εμφανίζεται στον πίνακα Υπάρχουσες Διαμορφώσεις στην ίδια σελίδα, με την Πλατφόρμα, τον Issuer, το Client ID και την Κατάσταση. Μπορείτε να διαγράψετε διαμορφώσεις από αυτόν τον πίνακα αν χρειαστεί ποτέ να καταργήσετε την εγγραφή.

D2L Brightspace παρέχει Δυναμική Εγγραφή μέσω της διεπαφής διαχείρισης του LTI Advantage. Θα χρειαστείτε δικαιώματα διαχειριστή.

Άνοιγμα της οθόνης εγγραφής

1. Συνδεθείτε στην εγκατάσταση Brightspace ως διαχειριστής.
2. Μεταβείτε σε Admin Tools > Manage Extensibility > LTI Advantage.
3. Κάντε κλικ στο Register Tool. (Το άμεσο URL είναι https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Επικόλληση του URL

Θα δείτε μια φόρμα εγγραφής. Το βασικό πεδίο είναι Tool initiation registration endpoint (κάποιες εκδόσεις του Brightspace το ονομάζουν "Tool Initiation Registration URL").

Επικολλήστε το URL εγγραφής του FastComments (λάβετε το εδώ) σε αυτό το πεδίο. Αφήστε τα υπόλοιπα πεδία κενά — συμπληρώνονται αυτόματα από το FastComments κατά τη διαδικασία εγγραφής.

Κάντε κλικ στο Register.

Έγκριση του εργαλείου

Το Brightspace ανοίγει ένα αναδυόμενο παράθυρο που επικοινωνεί με το FastComments, ανταλλάσσει κλειδιά και εμφανίζει μια οθόνη επιβεβαίωσης. Το αναδυόμενο παράθυρο κλείνει μόνο του όταν ολοκληρωθεί η εγγραφή.

Το νέο εργαλείο εμφανίζεται στη λίστα εργαλείων LTI Advantage. Από προεπιλογή το Brightspace επισημαίνει τα νέα εργαλεία ως απενεργοποιημένα — αλλάξτε τον διακόπτη σε ενεργοποιημένο ώστε τα μαθήματά σας να μπορούν να το χρησιμοποιήσουν.

Προσθήκη ανάπτυξης

Στο Brightspace, τα εργαλεία LTI χρειάζονται μια ανάπτυξη πριν μπορέσουν να χρησιμοποιηθούν σε μαθήματα:

1. Ανοίξτε το πρόσφατα εγγεγραμμένο εργαλείο FastComments.
2. Κάντε κλικ στο View Deployments > New Deployment.
3. Δώστε στην ανάπτυξη ένα όνομα (π.χ. "FastComments - Όλα τα Μαθήματα"), επιλέξτε τις οργανωτικές μονάδες στις οποίες θα είναι διαθέσιμη, και αποθηκεύστε.

Μετά την πρώτη εκκίνηση μέσω αυτής της ανάπτυξης, το FastComments καρφιτσώνει το deployment_id στο αρχείο ρυθμίσεων του — οι επόμενες εκκινήσεις από διαφορετική ανάπτυξη υπό τον ίδιο client θα απορριφθούν εκτός εάν επανεγγραφείτε.

Χρησιμοποιείτε το Moodle; Δημοσιεύουμε επίσης ένα ειδικό πρόσθετο για το Moodle για το FastComments με πιο στενή ενσωμάτωση από το LTI 1.3 (hooks συγχρονισμού βαθμολογιών, βαθύτερη αναφορά δραστηριοτήτων, εγγενές UI ρυθμίσεων του Moodle). Δείτε τον Οδηγό εγκατάστασης πρόσθετου για Moodle. Η ροή LTI 1.3 παρακάτω είναι η κατάλληλη επιλογή αν θέλετε μία μόνο εγγραφή που καλύπτει και άλλα LMS, ή αν ο διαχειριστής του Moodle σας δεν θα εγκαταστήσει πρόσθετα τρίτων.

Το Moodle 4.0+ υποστηρίζει τη Δυναμική Εγγραφή LTI 1.3 μέσω του πρόσθετου External Tool.

Άνοιγμα της οθόνης διαχείρισης εργαλείων

1. Συνδεθείτε στο Moodle ως διαχειριστής του ιστότοπου.
2. Μεταβείτε σε Διαχείριση ιστότοπου > Πρόσθετα > Μονάδες δραστηριότητας > External tool > Διαχείριση εργαλείων.

Επικολλήστε το URL

Θα δείτε μια κάρτα με την ένδειξη Διεύθυνση URL εργαλείου. Επικολλήστε το URL εγγραφής του FastComments (πάρτε το εδώ) στο πεδίο κειμένου και κάντε κλικ στο Προσθήκη LTI Advantage.

Το Moodle ανοίγει μια οθόνη εγγραφής που εμφανίζει την ταυτότητα του εργαλείου και τα δικαιώματα που ζητά. Ελέγξτε και κάντε κλικ στο Ενεργοποίηση (ή Εγγραφή, ανάλογα με την έκδοση του Moodle).

Το αναδυόμενο παράθυρο κλείνει όταν ολοκληρωθεί η εγγραφή· το νέο εργαλείο FastComments εμφανίζεται στη λίστα Εργαλεία με κατάσταση Ενεργό.

Κάντε το διαθέσιμο

Από προεπιλογή το Moodle προσθέτει νέα εργαλεία στη λίστα "Εργαλεία μαθήματος" αλλά δεν τα εμφανίζει στον επιλογέα δραστηριοτήτων. Για να εμφανιστεί το FastComments σε όλο το μάθημα:

1. Κάντε κλικ στο εικονίδιο γραναζιού στο πλακίδιο του FastComments.
2. Κάτω από Χρήση ρύθμισης εργαλείου, επιλέξτε Εμφάνιση στον επιλογέα δραστηριότητας και ως προ-διαμορφωμένο εργαλείο.
3. Αποθήκευση.

Οι διδάσκοντες μπορούν τώρα να προσθέσουν το FastComments σε οποιοδήποτε μάθημα μέσω Προσθήκη δραστηριότητας ή πόρου > FastComments.

Blackboard Learn SaaS and Ultra support LTI 1.3 Dynamic Registration.

Άνοιγμα της οθόνης Tool Provider

1. Κάντε είσοδο στο Blackboard ως διαχειριστής συστήματος.
2. Μεταβείτε στο Administrator Panel > Integrations > LTI Tool Providers.
3. Κάντε κλικ στο Register LTI 1.3 / LTI Advantage Tool.

If you only see "Register LTI 1.1 Provider", your Blackboard version doesn't support LTI 1.3 yet - upgrade or contact Blackboard support.

Επικόλληση του URL

Paste the FastComments registration URL (λάβετε το εδώ) into the Client ID / Registration URL field (Blackboard's labeling varies by version). Submit.

Blackboard performs the registration handshake with FastComments and shows you a confirmation screen.

Έγκριση και Ενεργοποίηση

Blackboard marks newly-registered tools as Approved but excluded by default:

1. Βρείτε την καταχώρηση FastComments στη λίστα παρόχων εργαλείων.
2. Ανοίξτε το μενού και επιλέξτε Edit.
3. Ορίστε το Tool Status σε Approved.
4. Στην ενότητα Institution Policies, ελέγξτε ποια δεδομένα χρήστη αποστέλλονται (όνομα, email, ρόλος). Αποθηκεύστε.

The tool is now available to instructors when they add content to courses.

Sakai

Το Sakai υποστηρίζει το LTI 1.3 Dynamic Registration στις εκδόσεις με LTI Advantage. Από το Administration Workspace:

1. Συνδεθείτε ως διαχειριστής Sakai και ανοίξτε το Administration Workspace.
2. Επιλέξτε External Tools > Install LTI 1.3 Tool.
3. Επικολλήστε το URL εγγραφής του FastComments (αποκτήστε το εδώ) και υποβάλετε.
4. Εγκρίνετε το εργαλείο όταν ολοκληρωθεί η διαδικασία χειραψίας.

Το εργαλείο εμφανίζεται τότε κάτω από External Tools και μπορεί να προστεθεί σε ιστότοπους από τους συντηρητές τους.

Schoology

Οι εγκαταστάσεις Schoology Enterprise υποστηρίζουν το LTI 1.3 αλλά η διαθεσιμότητα του Dynamic Registration διαφέρει ανά ανάπτυξη. Επικοινωνήστε με τον διαχειριστή λογαριασμού Schoology.

Εάν το Dynamic Registration δεν είναι διαθέσιμο στην εγκατάσταση Schoology σας, θα χρειαστεί να διαμορφώσετε την ενσωμάτωση χειροκίνητα χρησιμοποιώντας αυτά τα endpoints:

• OIDC Login URL: https://fastcomments.com/lti/v1p3/login
• Target Link URL: https://fastcomments.com/lti/v1p3/launch
• Public Keyset URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• Redirect URLs: https://fastcomments.com/lti/v1p3/launch

Αφού το Schoology σας δώσει ένα Client ID και Deployment ID, επικοινωνήστε με την υποστήριξη FastComments για να καταχωρήσετε τη ρύθμιση στον tenant σας.

Other LTI 1.3 Platforms

Κάθε LMS που ακολουθεί το πρότυπο IMS LTI 1.3 Advantage θα πρέπει να λειτουργεί με το ίδιο URL εγγραφής (αποκτήστε το εδώ). Αναζητήστε μια ρύθμιση με την ονομασία "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" ή παρόμοια.

Εάν η πλατφόρμα σας υποστηρίζει μόνο χειροκίνητη ρύθμιση LTI 1.3, χρησιμοποιήστε τα τέσσερα endpoints που αναφέρονται στην ενότητα Schoology παραπάνω και επικοινωνήστε με την υποστήριξη για να ολοκληρώσετε τη διαδικασία.

Αυτή η σελίδα καλύπτει την προσθήκη του FastComments σε ένα μάθημα Brightspace αφού ένας διαχειριστής έχει εγγράψει το εργαλείο και έχει δημιουργήσει μια ανάπτυξη. Εάν το εργαλείο δεν έχει εγγραφεί ακόμη, δείτε πρώτα τον οδηγό εγγραφής D2L.

Το FastComments ενσωματωμένο ως θέμα μονάδας στο Brightspace

Το Brightspace παρέχει δύο εμπειρίες δημιουργίας περιεχομένου: Κλασικό Περιεχόμενο και η Νέα Εμπειρία Περιεχομένου (επίσης ονομάζεται Μαθήματα). Και οι δύο παρέχουν πρόσβαση στο FastComments, αλλά οι διαδρομές στο μενού διαφέρουν. Κάθε ενότητα παρακάτω καλύπτει και τις δύο όπου διαφοροποιούνται.

Εντοπισμός του εργαλείου FastComments

Το εργαλείο FastComments εμφανίζεται σε δύο σημεία μέσα στον επεξεργαστή περιεχομένου ενός μαθήματος:

1. Στον επιλογέα δραστηριοτήτων, που προσεγγίζεται από το κουμπί Add Existing της μονάδας/ενότητας (επισημασμένο ως Add Existing Activities σε παλαιότερες εκδόσεις Brightspace). Το FastComments εμφανίζεται απευθείας στον επιλογέα στις τρέχουσες εκδόσεις Brightspace· σε παλαιότερες εκδόσεις βρίσκεται μέσα σε υπομενού External Learning Tools. Οποιαδήποτε από τις δύο διαδρομές προσθέτει το FastComments ως αυτόνομο θέμα.
2. Στο διάλογο Insert Stuff μέσα στον HTML επεξεργαστή, κάτω από LTI Advantage. Αυτό ενσωματώνει το FastComments εντός μιας σελίδας HTML μέσω της ροής LTI deep linking.

Αν το FastComments δεν εμφανίζεται σε κανέναν από τους δύο επιλογείς, η ανάπτυξη δεν είναι ενεργοποιημένη για τη μονάδα οργανισμού που φιλοξενεί το μάθημα. Ζητήστε από τον διαχειριστή Brightspace να ανοίξει Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments, να ανοίξει την ανάπτυξη και να προσθέσει τη μονάδα οργανισμού του μαθήματος (ή μια γονική μονάδα οργανισμού) κάτω από Org Units.

Προσθήκη FastComments ως Θέμα σε Μονάδα

Κλασικό Περιεχόμενο:

1. Ανοίξτε το μάθημα και κάντε κλικ στο Content στη γραμμή πλοήγησης.
2. Επιλέξτε τη μονάδα που θα φιλοξενήσει τη συζήτηση (ή δημιουργήστε μία μέσω Add a module).
3. Κάντε κλικ στο Add Existing (παλαιότερο Brightspace: Add Existing Activities > External Learning Tools).
4. Στον επιλογέα, κάντε κλικ στο FastComments. Το Brightspace δημιουργεί ένα θέμα στη μονάδα και σας επιστρέφει στην προβολή περιεχομένου.
5. Κάντε κλικ στο νέο θέμα. Μετονομάστε το σε κάτι περιγραφικό όπως FastComments Discussion χρησιμοποιώντας τον επεξεργαστή τίτλου εντός γραμμής.

Νέα Εμπειρία Περιεχομένου (Μαθήματα):

1. Ανοίξτε το μάθημα και κάντε κλικ στο Content.
2. Ανοίξτε την ενότητα και το μάθημα που θα φιλοξενήσει τη συζήτηση.
3. Κάντε κλικ στο Add > Existing Activity και επιλέξτε FastComments (παλαιότερο Brightspace: εμφιασμένο κάτω από External Learning Tools).
4. Η δραστηριότητα προστίθεται στο μάθημα.
5. Κάντε κλικ στον τίτλο της δραστηριότητας για να τον μετονομάσετε.

Την πρώτη φορά που οποιοσδήποτε χρήστης (διδάσκων ή φοιτητής) ανοίγει το θέμα, το FastComments αρχικοποιεί το νήμα για αυτόν τον resource link. Το νήμα συνδέεται με το resource link ID, οπότε η μετονομασία ή η μετακίνηση του θέματος δεν αλλάζει το νήμα που φορτώνεται.

Ενσωμάτωση FastComments εντός σελίδας HTML

Χρησιμοποιήστε αυτή τη ροή όταν θέλετε τα σχόλια να εμφανίζονται κάτω από ένα ανάγνωσμα, βίντεο ή άλλο περιεχόμενο μέσα στην ίδια σελίδα θέματος αντί ως ξεχωριστό θέμα.

1. Ανοίξτε ή δημιουργήστε ένα θέμα HTML στη μονάδα/μάθημα.
2. Κάντε κλικ στο Edit HTML για να ανοίξετε τον HTML επεξεργαστή του Brightspace.
3. Τοποθετήστε τον κέρσορα εκεί που πρέπει να εμφανιστεί το νήμα σχολίων.
4. Κάντε κλικ στο κουμπί Insert Stuff (εικονίδιο παζλ στη γραμμή εργαλείων του επεξεργαστή).
5. Στο διάλογο Insert Stuff, μετακινηθείτε στο LTI Advantage και κάντε κλικ στο FastComments.
6. Το FastComments ανοίγει έναν επιλογέα deep linking. Επιβεβαιώστε την τοποθέτηση (οι προεπιλεγμένες επιλογές λειτουργούν για συζητήσεις περιεχομένου)· κάντε κλικ στο Insert ή Continue.
7. Το Brightspace επιστρέφει στον HTML επεξεργαστή με ένα πλαίσιο κράτησης που αντιπροσωπεύει το LTI launch. Κάντε κλικ στο Save and Close στο θέμα.

Όταν φορτώνει το θέμα, το Brightspace αντικαθιστά το πλαίσιο κράτησης με ένα iframe που εκκινεί αυτόματα το FastComments μέσω LTI. Οι μαθητές βλέπουν το νήμα συζήτησης εντός της σελίδας.

Μια ενιαία σελίδα HTML μπορεί να περιέχει πολλαπλές ενσωματώσεις FastComments μέσω deep-link. Κάθε ενσωμάτωση λαμβάνει το δικό της νήμα επειδή κάθε deep link παράγει ένα ξεχωριστό resource link ID.

Θέμα Μονάδας έναντι Ενσωματωμένου Συνδέσμου

Διαλέξτε την προσέγγιση του θέματος μονάδας όταν:

• Η συζήτηση είναι η κύρια δραστηριότητα για αυτό το βήμα στη μονάδα.
• Θέλετε το θέμα να εμφανίζεται στον πίνακα περιεχομένων του Brightspace, στην παρακολούθηση ολοκλήρωσης και στο Class Progress.

Διαλέξτε την προσέγγιση του ενσωματωμένου όταν:

• Τα σχόλια πρέπει να βρίσκονται κάτω από άλλο περιεχόμενο στην ίδια σελίδα.
• Δεν θέλετε ένα ξεχωριστό στοιχείο που να παρακολουθείται για ολοκλήρωση στον πίνακα περιεχομένων.

Ορατότητα, Πρόχειρο (Draft) και Όροι Έκδοσης

Ένα νέο θέμα FastComments είναι ορατό στους μαθητές από προεπιλογή. Για να το αποκρύψετε ενώ το ρυθμίζετε:

1. Στον επεξεργαστή περιεχομένου, κάντε κλικ στον τίτλο του θέματος (Κλασικό) ή στο μενού με τις τρεις τελείες στη δραστηριότητα (Νέα Εμπειρία Περιεχομένου).
2. Ορίστε το status σε Draft (Κλασικό) ή απενεργοποιήστε την Visibility (Νέα Εμπειρία Περιεχομένου).

Τα θέματα σε Draft είναι αόρατα για τους μαθητές. Οι εκπαιδευτές και οι Βοηθοί Διδασκαλίας (TAs) εξακολουθούν να τα βλέπουν με ένα σήμα «Draft».

Για να περιορίσετε το θέμα σε μια συγκεκριμένη ομάδα ή ενότητα:

1. Ανοίξτε το θέμα.
2. Κάντε κλικ στο μενού τίτλου θέματος > Edit Properties In-place (Κλασικό) ή Edit > Restrictions (Νέα Εμπειρία Περιεχομένου).
3. Κάτω από Release Conditions, κάντε κλικ στο Create.
4. Επιλέξτε Group enrollment ή Section enrollment, επιλέξτε την ομάδα/ενότητα και αποθηκεύστε.

Οι όροι έκδοσης συσσωρεύονται με τον δικό του χάρτη ρόλων του FastComments. Οι μαθητές που δεν μπορούν να δουν το θέμα δεν λαμβάνουν LTI launch.

Τι βλέπουν οι μαθητές στην πρώτη εκκίνηση

Όταν ένας μαθητής κάνει κλικ στο θέμα (ή φορτώνει ένα θέμα HTML με ενσωμάτωση):

1. Το Brightspace πραγματοποιεί το LTI 1.3 launch στο παρασκήνιο.
2. Το FastComments λαμβάνει το όνομα του μαθητή, το email, το avatar URL και το ρόλο στο LMS, και τον συνδέει αυτόματα. Δεν υπάρχει προτροπή εισόδου στο FastComments.
3. Το νήμα σχολίων για αυτόν τον resource link αποδίδεται μέσα στο Brightspace iframe.

Χαρτογράφηση ρόλων κατά την εκκίνηση:

• Brightspace Administrator γίνεται FastComments admin για το νήμα (πλήρη δικαίωμα μετρίασης, διαγραφής, αποκλεισμού και πρόσβασης στη διαμόρφωση).
• Brightspace Instructor γίνεται FastComments moderator (πινάρισμα, απόκρυψη, διαγραφή, αποκλεισμός).
• Όλοι οι άλλοι ρόλοι (Learner, TeachingAssistant, κ.λπ.) γίνονται κανονικοί σχολιαστές.

Τα σχόλια αποδίδονται στον λογαριασμό Brightspace του μαθητή. Αν ο μαθητής επεξεργαστεί το όνομα ή το avatar του στο Brightspace, το επόμενο LTI launch συγχρονίζει την αλλαγή.

Ύψος iframe και Αλλαγή μεγέθους

Το FastComments στέλνει το postMessage org.imsglobal.lti.frameResize σε κάθε απόδοση νήματος και σε αλλαγές περιεχομένου (νέο σχόλιο, επέκταση απαντήσεων). Το Brightspace ακούει αυτό το μήνυμα και προσαρμόζει το ύψος του iframe ώστε το νήμα να μην αποκόβεται και να μην εμφανίζει εσωτερική γραμμή κύλισης.

Αν το iframe παραμένει σε ένα σταθερό μικρό ύψος:

• Επιβεβαιώστε ότι το μάθημα φορτώνεται μέσω HTTPS. Ο listener postMessage του Brightspace απορρίπτει frames μικτού περιεχομένου.
• Επιβεβαιώστε ότι δεν υπάρχει επέκταση προγράμματος περιήγησης που να μπλοκάρει το κανάλι postMessage.
• Για ενσωματώσεις εντός σελίδας HTML, το περιβάλλον HTML δεν πρέπει να τυλίγει το iframe σε ένα δοχείο με σταθερό ύψος. Αφαιρέστε οποιοδήποτε inline style="height: ..." από το γονικό στοιχείο.

Σημεία προσοχής ειδικά για το Brightspace

Tool not showing in the Add Existing picker. Η ανάπτυξη δεν είναι ενεργοποιημένη για την οργανωτική μονάδα αυτού του μαθήματος. Ένας διαχειριστής πρέπει να προσθέσει την οργανωτική μονάδα (ή μια γονική) στη λίστα Org Units της ανάπτυξης. Η εγγραφή του εργαλείου από μόνη της δεν είναι αρκετή· η ανάπτυξη καθορίζει ποια μαθήματα βλέπουν το εργαλείο.

deployment_id mismatch on launch. Το FastComments TOFU-pins το πρώτο deployment_id που βλέπει για μια εγγραφή. Αν ένας διαχειριστής διαγράψει την αρχική ανάπτυξη και δημιουργήσει μια νέα, οι εκκινήσεις από τη νέα ανάπτυξη απορρίπτονται με σφάλμα ασυμφωνίας ανάπτυξης. Η λύση είναι να ξανα-εγγράψετε το FastComments (δημιουργήστε μια νέα διεύθυνση εγγραφής (παραλάβετε την εδώ) και εκτελέστε ξανά το Dynamic Registration); η παλιά εγγραφή αντικαθίσταται.

Tool launches but shows "Invalid LTI launch". Το μάθημα βρίσκεται σε διαφορετική δομή tenant/οργανισμού από ό,τι καλύπτει η ανάπτυξη, ή η ανάπτυξη απενεργοποιήθηκε μετά την εγγραφή. Ελέγξτε ξανά Admin Tools > Manage Extensibility > LTI Advantage > FastComments > το κουμπί Enabled και τη λίστα οργανωτικών μονάδων της ανάπτυξης.

Names and roles missing inside FastComments. Το Brightspace στέλνει LTI launches με claims Names and Role Provisioning Services (NRPS). Αν ένα μάθημα αναβαθμίστηκε από έναν παλαιότερο σύνδεσμο LTI 1.1, το launch μπορεί να μην περιλαμβάνει claims name και email. Προσθέστε ξανά το θέμα FastComments μέσω Add Existing (μη μεταφέρετε τον παλιό σύνδεσμο) ώστε το launch να χρησιμοποιεί LTI 1.3.

Embed shows a login screen instead of auto-SSO. Το θέμα HTML εισήχθη ως ένα απλό <iframe> που δείχνει στο FastComments αντί μέσω Insert Stuff > LTI Advantage. Τα απλά iframes παρακάμπτουν το LTI launch και οδηγούν τους χρήστες στη δημόσια σελίδα του FastComments. Διαγράψτε το iframe και επαναπροσθέστε το μέσω της ροής Insert Stuff.

Μόλις ένας διαχειριστής έχει καταχωρίσει το FastComments ως εργαλείο LTI 1.3 Advantage και έχει εγκρίνει τις πολιτικές του ιδρύματος, οι εκπαιδευτές το προσθέτουν σε μαθήματα μέσω των τυπικών σημείων τοποθέτησης του Blackboard. Τα ακριβή βήματα διαφέρουν μεταξύ Ultra Course View και Original Course View, οπότε καλύπτονται και οι δύο παρακάτω.

Ultra Course View

Ultra Course View είναι η προεπιλεγμένη επιλογή στο Blackboard Learn SaaS από το 2026.

1. Ανοίξτε το μάθημα και μεταβείτε στη σελίδα Course Content.
2. Τοποθετήστε τον δείκτη ή πατήστε στο σημείο όπου θέλετε να εμφανιστεί το νήμα σχολίων στη δομή και κάντε κλικ στο μοβ + (Add content).
3. Επιλέξτε Content Market. Το πάνελ Content Market απαριθμεί κάθε εγκεκριμένο εργαλείο LTI και κάθε τοποθέτηση Building Block για το ίδρυμά σας.
4. Βρείτε την πλακίδα FastComments και κάντε κλικ σε αυτήν. Το Blackboard δημιουργεί ένα περιεχόμενο στη θέση όπου ανοίξατε το μενού +.
5. Το στοιχείο εμφανίζεται στη δομή ως καταχώριση "Visible to students" από προεπιλογή για εκπαιδευτές που έχουν το προσωπικό τους προεπιλεγμένο Hide from students απενεργοποιημένο. Εάν η προεπιλογή σας είναι Hidden, το στοιχείο δημιουργείται κρυφό και ενεργοποιείτε τον επιλογέα ορατότητας στη γραμμή του στοιχείου όταν είστε έτοιμοι.
6. Για να μετονομάσετε το στοιχείο, κάντε κλικ στον τίτλο στη δομή και πληκτρολογήστε μια νέα ετικέτα. Ο τίτλος που βλέπουν οι φοιτητές στη δομή είναι ανεξάρτητος από τον FastComments thread identifier, οπότε η μετονομασία είναι ασφαλής ανά πάσα στιγμή.

Εάν δεν βλέπετε το Content Market ως επιλογή, το ίδρυμά σας έχει αποκρύψει την τοποθέτηση. Μπορείτε επίσης να έχετε πρόσβαση στον ίδιο επιλογέα μέσω του More tools στο ίδιο μενού + κάτω από την ομάδα LTI Tools.

Original Course View

Original Course View εξακολουθεί να υποστηρίζεται στο Learn SaaS και παραμένει η κύρια εμπειρία για αυτο-φιλοξενούμενες εγκαταστάσεις Learn 9.1 στη γραμμή κυκλοφορίας Q4 2024 CU.

1. Ανοίξτε το μάθημα και μπείτε σε μια Content Area (για παράδειγμα, την προεπιλεγμένη περιοχή Information ή Content στο μενού του μαθήματος).
2. Ενεργοποιήστε το Edit Mode με τον διακόπτη στην πάνω-δεξιά γωνία της σελίδας.
3. Κάντε κλικ στο Build Content στη γραμμή ενεργειών.
4. Κάτω από το υπομενού Learning Tools, κάντε κλικ στο FastComments. Το υπομενού Learning Tools γεμίζει από τις τοποθετήσεις εργαλείων LTI 1.3 αφού ένας διαχειριστής καταχωρίσει το εργαλείο. Εάν δεν το βλέπετε, δείτε την ενότητα με τα προβληματικά θέματα παρακάτω.
5. Στην φόρμα Create FastComments, ορίστε:
   • Name: την ετικέτα που βλέπουν οι φοιτητές στην περιοχή περιεχομένου.
   • Description: προαιρετικό κείμενο που εμφανίζεται πάνω από το ενσωματωμένο νήμα.
   • Permit Users to View this Content: εναλλαγή διαθεσιμότητας Yes/No.
   • Track Number of Views: ενεργοποιήστε εάν θέλετε τις στατιστικές προβολών ανά στοιχείο του Blackboard. Το FastComments τρέχει τα δικά του analytics ανεξάρτητα.
   • Date and Time Restrictions: προαιρετικά παράθυρα Display After / Display Until.
6. Υποβάλετε. Το εργαλείο εμφανίζεται ως κλικ-επιλέξιμο στοιχείο στην περιοχή περιεχομένου.

Embedding Inside an Item or Document

Σε και τις δύο προβολές μαθήματος, οι εκπαιδευτές ενσωματώνουν το FastComments μέσα στο σώμα ενός Item, Document ή οποιουδήποτε πεδίου πλούσιου κειμένου μέσω του κουμπιού LTI Advantage του Content Editor.

Ultra Course View:

1. Δημιουργήστε ή επεξεργαστείτε ένα Document.
2. Κάντε κλικ στο Add content μέσα στο σώμα του εγγράφου στο σημείο όπου θέλετε να εμφανίζεται το νήμα.
3. Στη γραμμή εργαλείων του επεξεργαστή, ανοίξτε το μενού Insert content και κάντε κλικ στο Content Market (το σημείο εισόδου LTI Advantage / Deep Linking).
4. Επιλέξτε FastComments. Το FastComments επιστρέφει ένα deep-link payload και το Blackboard εισάγει ένα ενσωματωμένο μπλοκ στο σώμα του εγγράφου στη θέση του δρομέα.
5. Αποθηκεύστε το έγγραφο. Οι φοιτητές βλέπουν το νήμα ενσωματωμένο καθώς το κάνετε scroll.

Original Course View:

1. Επεξεργαστείτε οποιοδήποτε στοιχείο με σώμα πλούσιου κειμένου.
2. Στη γραμμή εργαλείων του Content Editor, κάντε κλικ στο εικονίδιο προσθήκης Add Content και επιλέξτε Content Market (επισημασμένο ως Add Content from External Tool σε παλαιότερα Q4 2024 CUs).
3. Επιλέξτε FastComments. Ο επεξεργαστής εισάγει ένα προσωρινό μπλοκ που αναφέρεται στην deep-linked resource.
4. Υποβάλετε το στοιχείο.

Κάθε deep-link embed παράγει το δικό του νήμα FastComments, οπότε ένα Item με δύο ενσωματωμένα μπλοκ FastComments έχει δύο ανεξάρτητες ροές σχολίων.

Visibility, Release Conditions, and Group Restrictions

Τα αντικείμενα περιεχομένου FastComments συμπεριφέρονται όπως οποιοδήποτε άλλο αντικείμενο περιεχομένου του Blackboard όσον αφορά τους κανόνες ελέγχου πρόσβασης που εφαρμόζονται πάνω τους.

• Ultra: κάντε κλικ στον επιλογέα ορατότητας στη γραμμή (Visible to students, Hidden from students, Conditional availability). Η Conditional availability υποστηρίζει παράθυρα ημερομηνιών/ωρών, κανόνες απόδοσης σε σχέση με αντικείμενα gradebook και κανόνες μελών σε σχέση με ομάδες μαθήματος.
• Original: ανοίξτε το context menu του στοιχείου και επιλέξτε Adaptive Release ή Adaptive Release: Advanced για να φράξετε το εργαλείο με βάση ημερομηνία, συμμετοχή, βαθμό ή κατάσταση αναθεώρησης. Χρησιμοποιήστε το Set Group Availability στο στοιχείο για να περιορίσετε σε συγκεκριμένες ομάδες μαθήματος.

Το FastComments σέβεται ό,τι αποφασίζει η πύλη του Blackboard. Εάν το Blackboard κρύψει το στοιχείο από έναν φοιτητή, το LTI launch δεν εκτελείται ποτέ για εκείνον τον φοιτητή και δεν εμφανίζεται στην προβολή moderator.

Gradebook Behavior

Το FastComments δεν αναφέρει βαθμούς πίσω μέσω LTI Advantage Assignment and Grade Services. Δεν δημιουργείται αυτόματα στήλη βαθμολογίου για τα αντικείμενα περιεχομένου FastComments.

Εάν ο tenant του Blackboard σας είναι ρυθμισμένος να δημιουργεί αυτόματα μια στήλη gradebook για κάθε νέο αντικείμενο περιεχομένου ανεξάρτητα από τα μεταδεδομένα βαθμολόγησης, μια κενή στήλη εμφανίζεται ούτως ή άλλως. Για να την αποκρύψετε:

• Ultra: ανοίξτε το Gradebook, κάντε κλικ στην κεφαλίδα της στήλης, επιλέξτε Edit και απενεργοποιήστε το Show to students καθώς και το Include in calculations. Ή χρησιμοποιήστε Delete εάν το ίδρυμά σας επιτρέπει τη διαγραφή στηλών για αντικείμενα χωρίς βαθμό.
• Original: ανοίξτε το Grade Center, κάντε κλικ στο βέλος της στήλης, επιλέξτε Hide from Users (on/off) και προαιρετικά Hide from Instructor View κάτω από το Column Organization.

What Students See

Όταν ένας φοιτητής ανοίγει το αντικείμενο FastComments ή κάνει scroll σε ένα ενσωματωμένο μπλοκ:

1. Το Blackboard εκκινεί το μήνυμα LTI 1.3 προς το FastComments. Ο φοιτητής συνδέεται μέσω SSO χρησιμοποιώντας την ταυτότητα Blackboard (όνομα, email, avatar, ρόλος) χωρίς να βλέπει φόρμα εισόδου.
2. Το νήμα σχολίων αποδίδεται στο iframe. Το threading, οι απαντήσεις, οι αναφορές και οι αντιδράσεις είναι διαθέσιμα ανάλογα με τις ρυθμίσεις του comment widget που έχουν διαμορφωθεί στο FastComments.
3. Τα σχόλιά τους αποδίδονται στον λογαριασμό Blackboard τους. Εάν ο φοιτητής επεξεργαστεί το όνομα ή τη φωτογραφία του στο Blackboard αργότερα, η επόμενη εκκίνηση ενημερώνει το προφίλ του FastComments.

Αντιστοίχιση ρόλων από Blackboard σε FastComments:

• System Administrator και Course Builder αντιστοιχίζονται σε FastComments admin.
• Instructor και Teaching Assistant αντιστοιχίζονται σε FastComments moderator.
• Student, Guest, και Observer αντιστοιχίζονται σε FastComments commenter.

Οι moderators βλέπουν χειριστήρια moderation (pin, hide, ban, delete) ενσωματωμένα σε κάθε σχόλιο στο νήμα.

Thread Scoping

Το FastComments περιορίζει κάθε νήμα με βάση (Blackboard host, course ID, resource link ID). Δύο αντικείμενα FastComments στο ίδιο μάθημα δημιουργούν δύο νήματα. Το ίδιο αντικείμενο αντιγραμμένο σε δύο κελύφη μαθήματος (για παράδειγμα, μέσω course copy) δημιουργεί δύο νήματα, επειδή το Blackboard εκδίδει ένα νέο resource link ID κατά την αντιγραφή. Για να διατηρήσετε ένα κοινό νήμα σε αντιγραφές μαθήματος, χρησιμοποιήστε Deep Linking με ένα ρητό thread URN που έχει ρυθμιστεί στο FastComments πριν από την έναρξη της αντιγραφής.

Blackboard-Specific Gotchas

FastComments tile missing from the Build Content menu (Original) or Content Market (Ultra). Ο διαχειριστής ενέκρινε το εργαλείο αλλά άφησε μια πολιτική ιδρύματος που αποκλείει την αντίστοιχη τοποθέτηση. Μεταβείτε στο Administrator Panel > Integrations > LTI Tool Providers, επεξεργαστείτε την εγγραφή FastComments και επιβεβαιώστε ότι οι τοποθετήσεις Course Content Tool (Original) και Course Content Tool - allow students / Deep Linking content tool (Ultra) είναι ενεργοποιημένες. Αποθηκεύστε και ανανεώστε τη σελίδα του μαθήματος.

"Tool not configured for this context" or "Tool is not deployed" error on launch. Το εύρος ανάπτυξης που καταχωρήθηκε κατά τη διάρκεια της δυναμικής εγγραφής δεν ταιριάζει με το πλαίσιο ιδρύματος στο οποίο ανήκει το μάθημα. Στην καταχώριση παρόχου εργαλείων του Blackboard, επαληθεύστε ότι το Deployment ID ταιριάζει με αυτό που εμφανίζει το FastComments στη σελίδα LTI 1.3 Configuration για αυτόν τον tenant. Εάν διαφέρουν, διαγράψτε την τοποθέτηση και επανεκτελέστε τη δυναμική εγγραφή από ένα νέο registration URL (βρείτε το εδώ).

Iframe height looks fixed or content gets cut off. Κάποιοι tenants του Blackboard αποστέλλουν μια αυστηρή Content Security Policy που μπλοκάρει το προεπιλεγμένο LTI iframe-resize postMessage. Το FastComments εκπέμπει τόσο το Canvas-style lti.frameResize μήνυμα όσο και το IMS spec-form org.imsglobal.lti.frameResize μήνυμα για μέγιστη συμβατότητα, αλλά μια tenant-level τροποποίηση CSP μπλοκάρει τον listener στον parent. Ζητήστε από τον διαχειριστή σας να επιβεβαιώσει ότι το *.fastcomments.com είναι στη λίστα επιτρεπτών εργαλείων LTI και ότι κανένα προσαρμοσμένο CSP header δεν αποκόπτει τα postMessage γεγονότα. Η αλλαγή μεγέθους θα λειτουργήσει τότε χωρίς περαιτέρω ρύθμιση.

Course copy duplicates threads. Η αντιγραφή μαθημάτων στο Blackboard εκδίδει νέα resource link IDs για τοποθετήσεις LTI, οπότε τα αντιγραμμένα μαθήματα ξεκινούν με κενά νήματα. Αυτό είναι αναμενόμενο. Εάν χρειάζεστε το αντιγραμμένο μάθημα να κληρονομήσει το αρχικό νήμα, ρυθμίστε Deep Linking με ένα ρητό thread URN πριν από την αντιγραφή, ή επικοινωνήστε με την υποστήριξη του FastComments για μαζική ανακατεύθυνση των thread IDs.

Student sees a generic Blackboard error on launch. Η αιτία είναι ένα ελλείπον ή παλαιωμένο claim email. Επιβεβαιώστε ότι η πολιτική ιδρύματος για το FastComments έχει ενεργοποιημένα τα Role, Name, και Email Address κάτω από User Fields to Send. Αποθηκεύστε και ξεκινήστε ξανά σε μια νέα συνεδρία browser.

"Το token εγγραφής δεν βρέθηκε, έληξε ή έχει ήδη χρησιμοποιηθεί"

Το token στη διεύθυνση εγγραφής σας (λάβετε το εδώ) είναι έγκυρο για 30 λεπτά και μπορεί να χρησιμοποιηθεί μόνο μία φορά. Αν το LMS σας χρειάστηκε περισσότερο από αυτόν τον χρόνο, ή αν η εγγραφή επαναλήφθηκε μετά από επιτυχία, το token θα απορριφθεί. Δημιουργήστε ένα νέο URL στη σελίδα ρυθμίσεων FastComments LTI 1.3 Configuration και ξεκινήστε ξανά.

"Platform rejected registration"

Το LMS σας αρνήθηκε τη χειραψία εγγραφής. Οι πιο συνηθισμένες αιτίες:

• Tool already registered with the same client name. Ορισμένες πλατφόρμες (ιδιαίτερα η D2L) απορρίπτουν μια δεύτερη εγγραφή του "FastComments" έως ότου διαγραφεί η προηγούμενη. Αφαιρέστε το παλιό εργαλείο στο LMS σας και δοκιμάστε ξανά.
• Wrong field in the LMS. Βεβαιωθείτε ότι επικολλήσατε το URL στο πεδίο registration / tool initiation registration endpoint, όχι στο πεδίο launch URL ή login URL.
• The LMS doesn't actually support Dynamic Registration. Παλαιότερες εκδόσεις του Moodle και του Blackboard διαφημίζουν LTI 1.3 αλλά επιτρέπουν μόνο χειροκίνητη ρύθμιση. Ελέγξτε τα έγγραφα της πλατφόρμας σας.

"Failed to fetch platform configuration"

Το FastComments δεν μπόρεσε να διαβάσει το έγγραφο openid-configuration του LMS σας. Αυτό είναι σπάνιο και συνήθως σημαίνει ότι το LMS παρείχε ένα κακώς μορφοποιημένο ή μη προσβάσιμο discovery URL. Επικοινωνήστε με την υποστήριξη του LMS σας.

Εκκίνηση εμφανίζει "Configuration not found"

Είτε η διαμόρφωση στο FastComments διαγράφηκε, είτε η εκκίνηση προήλθε από ένα ζευγάρι iss/client_id που δεν αναγνωρίζουμε. Αν τη διαγράψατε και επανεγγραφήκατε, ζητήστε από το LMS σας να αφαιρέσει και να επαναπροσθέσει το εργαλείο FastComments ώστε να λάβει το νέο client_id.

Εκκίνηση εμφανίζει "Deployment not registered"

Ξεκινήσατε το FastComments από μια ανάπτυξη Brightspace/Moodle/Blackboard διαφορετική από αυτή στην οποία ξεκίνησε αρχικά. Το FastComments "καρφώνει" το deployment_id στην πρώτη εκκίνηση ως έλεγχο ασφαλείας. Για να προσθέσετε μια νέα ανάπτυξη κάτω από τον ίδιο client, επικοινωνήστε με την υποστήριξη — θα προσθέσουμε το deployment ID στη διαμόρφωση.

Εκκίνηση εμφανίζει "Unsupported message_type"

Το LMS απέστειλε ένα μήνυμα LTI που το FastComments δεν χειρίζεται (π.χ. LtiSubmissionReviewRequest). Το FastComments υποστηρίζει μόνο τις τυπικές ροές resource-link launch και deep-linking. Επικοινωνήστε μαζί μας αν χρειάζεστε να προστεθεί ένας συγκεκριμένος τύπος μηνύματος.

Το iframe δεν αλλάζει μέγεθος

Τα περισσότερα LMS αλλάζουν αυτόματα το μέγεθος των LTI iframes. Αν το δικό σας δεν το κάνει, ελέγξτε ότι οι ρυθμίσεις εκκίνησης του LMS επιτρέπουν στο εργαλείο να στέλνει postMessage συμβάντα στο γονικό πλαίσιο. Το FastComments εκπέμπει τόσο μηνύματα αλλαγής μεγέθους σε Canvas-style (lti.frameResize) όσο και σύμφωνα με το IMS-spec (org.imsglobal.lti.frameResize).