Add Comments to Your LMS via LTI 1.3

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

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

• D2L Brightspace (οποιαδήποτε έκδοση με LTI Advantage)
• Moodle 4.0+ (External Tool plugin, LTI Advantage)
• Blackboard Learn (SaaS and 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 δεν είναι ενεργοποιημένο για αυτόν τον λογαριασμό" - επικοινωνήστε με την υποστήριξη για να το ενεργοποιήσουν στο πλάνο σας.

Επιλογή Πλατφόρμας (Προαιρετικό)

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

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Άλλη πλατφόρμα LTI 1.3

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

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

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

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

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

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

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

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

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

Open the Registration Screen

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

Paste the URL

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

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

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

Approve the Tool

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

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

Add a Deployment

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

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

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

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

Το Moodle 4.0+ υποστηρίζει την Δυναμική Εγγραφή LTI 1.3 μέσω του plugin Εξωτερικού Εργαλείου.

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

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

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

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

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

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

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

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

1. Κάντε κλικ στο εικονίδιο ρυθμίσεων στο πλακίδιο FastComments.
2. Στο Tool configuration usage, επιλέξτε Show in activity chooser and as a preconfigured tool.
3. Αποθηκεύστε.

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

Το Blackboard Learn SaaS και το Ultra υποστηρίζουν τη Δυναμική Εγγραφή LTI 1.3.

Άνοιγμα της οθόνης Παρόχου Εργαλείου

1. Συνδεθείτε στο Blackboard ως διαχειριστής συστήματος.
2. Μεταβείτε στο Πίνακας Διαχειριστή > Ενσωματώσεις > Παροχείς Εργαλείων LTI.
3. Κάντε κλικ στο Εγγραφή εργαλείου LTI 1.3 / LTI Advantage.

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

Επικολλήστε το URL εγγραφής του FastComments (λάβετε το εδώ) στο πεδίο Client ID / Registration URL (η ονομασία των πεδίων στο Blackboard διαφέρει ανά έκδοση). Υποβάλετε.

Το Blackboard πραγματοποιεί την ανταλλαγή εγγραφής (handshake) με το FastComments και σας εμφανίζει μια οθόνη επιβεβαίωσης.

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

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

1. Βρείτε την καταχώριση FastComments στη λίστα παρόχων εργαλείων.
2. Ανοίξτε το μενού και επιλέξτε Επεξεργασία.
3. Ορίστε την Κατάσταση Εργαλείου σε Εγκεκριμένο.
4. Κάτω από τις Πολιτικές Ιδρύματος, ελέγξτε ποια δεδομένα χρήστη αποστέλλονται (όνομα, email, ρόλος). Αποθηκεύστε.

Το εργαλείο είναι πλέον διαθέσιμο στους διδάσκοντες όταν προσθέτουν περιεχόμενο στα μαθήματα.

Sakai

Το Sakai υποστηρίζει το LTI 1.3 Dynamic Registration σε εκδόσεις με LTI Advantage. Από τον Χώρο Διαχείρισης:

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

Το εργαλείο εμφανίζεται τότε κάτω από Εξωτερικά Εργαλεία και μπορεί να προστεθεί σε ιστότοπους από τους διαχειριστές τους.

Schoology

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

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

• URL Σύνδεσης OIDC: https://fastcomments.com/lti/v1p3/login
• URL Συνδέσμου Προορισμού: https://fastcomments.com/lti/v1p3/launch
• URL Συνόλου Δημόσιων Κλειδιών (JWKS): https://fastcomments.com/lti/v1p3/jwks
• URL Ανακατεύθυνσης: https://fastcomments.com/lti/v1p3/launch

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

Άλλες Πλατφόρμες LTI 1.3

Οποιοδήποτε LMS ακολουθεί το πρότυπο IMS LTI 1.3 Advantage θα πρέπει να λειτουργεί με το ίδιο URL εγγραφής (πατήστε εδώ για να το λάβετε). Αναζητήστε μια ρύθμιση με ετικέτα "Δυναμική Εγγραφή", "URL Εγγραφής Εργαλείου", "endpoint εγγραφής έναρξης εργαλείου" ή παρόμοιο.

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

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

FastComments ενσωματωμένο ως θέμα ενότητας στο Brightspace

Το Brightspace παρέχει δύο εμπειρίες δημιουργίας περιεχομένου: Classic Content και η New Content Experience (επίσης ονομάζεται Lessons). Και οι δύο εκθέτουν το FastComments, αλλά οι διαδρομές μενού διαφέρουν. Κάθε ενότητα παρακάτω καλύπτει και τις δύο όπου αποκλίνουν.

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

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

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

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

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

Classic Content:

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

New Content Experience (Lessons):

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

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

Ενσωμάτωση του FastComments Inline σε ένα HTML Θέμα

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

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

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

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

Θέμα Μονάδας vs Inline Quicklink

Επιλέξτε την προσέγγιση θέμα μονάδας (module topic) όταν:

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

Επιλέξτε την προσέγγιση ενσωμάτωση inline όταν:

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

Ορατότητα, Προσχέδιο (Draft) και Συνθήκες Απελευθέρωσης (Release Conditions)

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

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

Τα θέματα σε Draft είναι αόρατα στους φοιτητές. Οι διδάσκοντες και οι βοηθοί (TAs) εξακολουθούν να τα βλέπουν με ένα σήμα "Draft".

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

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

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

Τι Βλέπουν οι Φοιτητές στην Πρώτη Εκκίνηση

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

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

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

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

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

Ύψος Iframe και Αλλαγή Μεγέθους (Resize)

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

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

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

Σημεία Που Αξίζει Να Προσέξετε στο Brightspace

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

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

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

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

Η ενσωμάτωση εμφανίζει οθόνη σύνδεσης αντί για αυτόματο SSO. Το HTML θέμα εισήχθη ως απλό <iframe> που δείχνει στο FastComments αντί μέσω Insert Stuff > LTI Advantage. Τα απλά iframe παρακάμπτουν το 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. Μετακινήστε τον δείκτη ή πατήστε στο σημείο όπου θέλετε να εμφανίζεται το νήμα σχολίων στη δομή και κάντε κλικ στο μωβ κουμπί + (Προσθήκη περιεχομένου).
3. Επιλέξτε Content Market. Το πλαίσιο Content Market απαριθμεί κάθε εγκεκριμένο εργαλείο LTI και κάθε τοποθέτηση Building Block για το ίδρυμά σας.
4. Βρείτε την πλακίδα FastComments και κάντε κλικ πάνω της. Το Blackboard δημιουργεί ένα στοιχείο περιεχομένου στη θέση όπου ανοίξατε το μενού +.
5. Το στοιχείο τοποθετείται στη δομή ως καταχώριση "Visible to students" εξ ορισμού για τους εκπαιδευτές που έχουν την επιλογή Hide from students απενεργοποιημένη ως προσωπική προεπιλογή. Εάν η προεπιλογή σας είναι Hidden, το στοιχείο δημιουργείται κρυφό και ενεργοποιείτε τον επιλογέα ορατότητας στη σειρά του στοιχείου όταν είστε έτοιμοι.
6. Για να μετονομάσετε το στοιχείο, κάντε κλικ στον τίτλο στη δομή και πληκτρολογήστε μια νέα ετικέτα. Ο τίτλος που βλέπουν οι φοιτητές στη δομή είναι ανεξάρτητος από τον αναγνωριστικό νήματος του FastComments, οπότε η μετονομασία είναι ασφαλής οποιαδήποτε στιγμή.

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

Original Course View

Η Original Course View υποστηρίζεται ακόμη στο Learn SaaS και παραμένει η κύρια εμπειρία για self-hosted 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: επιλογέας διαθεσιμότητας Ναι/Όχι.
   • Track Number of Views: ενεργοποιήστε αν θέλετε τα στατιστικά προβολών ανά στοιχείο του Blackboard. Το FastComments τρέχει τα δικά του αναλυτικά ανεξάρτητα.
   • Date and Time Restrictions: προαιρετικά παράθυρα Display After / Display Until.
6. Υποβάλετε. Το εργαλείο εμφανίζεται ως κλικαριστό στοιχείο στην περιοχή περιεχομένου.

Ενσωμάτωση Μέσα σε Στοιχείο ή Έγγραφο

Σε και τις δύο προβολές μαθήματος, οι εκπαιδευτές ενσωματώνουν το FastComments inline μέσα στο σώμα ενός 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 επιστρέφει ένα payload deep-link και το Blackboard εισάγει ένα ενσωματωμένο μπλοκ στο σώμα του εγγράφου στη θέση του δρομέα.
5. Αποθηκεύστε το έγγραφο. Οι φοιτητές βλέπουν το νήμα να αποδίδεται inline καθώς το συναντούν κύλιση.

Original Course View:

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

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

Ορατότητα, Συνθήκες Απελευθέρωσης και Περιορισμοί Ομάδων

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

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

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

Συμπεριφορά στο Gradebook

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

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

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

Τι Βλέπουν οι Φοιτητές

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

1. Το Blackboard εκκινεί το μήνυμα LTI 1.3 προς το FastComments. Ο φοιτητής συνδέεται μέσω SSO χρησιμοποιώντας την ταυτότητα του Blackboard (όνομα, email, avatar, ρόλος) χωρίς να βλέπει φόρμα σύνδεσης.
2. Το νήμα σχολίων αποδίδεται στο iframe. Η νηματοποίηση, οι απαντήσεις, οι αναφορές και οι αντιδράσεις είναι διαθέσιμες ανάλογα με τις ρυθμίσεις του 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 βλέπουν στοιχεία ελέγχου μετριασμού (pin, hide, ban, delete) ενσωματωμένα σε κάθε σχόλιο στο νήμα.

Σκοπός Νήματος (Thread Scoping)

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

Συγκεκριμένα Προβλήματα Blackboard

Η πλακίδα FastComments λείπει από το μενού Build Content (Original) ή το 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" ή "Tool is not deployed" κατά την εκκίνηση. Το πεδίο ανάπτυξης (deployment scope) που καταχωρήθηκε κατά τη δυναμική καταχώριση δεν ταιριάζει με το πλαίσιο ιδρύματος στο οποίο ανήκει το μάθημα. Στην καταχώριση παρόχου εργαλείου του Blackboard, επαληθεύστε ότι το Deployment ID ταιριάζει με αυτό που εμφανίζει το FastComments στη σελίδα LTI 1.3 Configuration για αυτόν τον tenant. Αν διαφέρουν, διαγράψτε την τοποθέτηση και επανεκτελέστε τη δυναμική καταχώριση από ένα νέο URL καταχώρισης (λάβετε το εδώ).

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

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

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

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

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

"Η πλατφόρμα απέρριψε την εγγραφή"

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

• 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 αλλά επιτρέπουν μόνο χειροκίνητη διαμόρφωση. Ελέγξτε την τεκμηρίωση της πλατφόρμας σας.

"Αποτυχία ανάκτησης της διαμόρφωσης της πλατφόρμας"

Το 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 στη διαμόρφωση.

Το άνοιγμα εμφανίζει "Μη υποστηριζόμενο message_type"

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

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

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