Add Comments to Your LMS via LTI 1.3

1. Zaloguj się do FastComments i przejdź do your LTI 1.3 Configuration page.
2. (Opcjonalnie) Wybierz platformę, z której się łączysz, z rozwijanego menu Platform — ustawia ona etykietę wyświetlaną, ale Auto-detect działa dobrze.
3. Kliknij Generate URL. Pojawi się jednorazowy Registration URL (ważny przez 30 minut, do jednorazowego użycia).
4. W swoim LMS otwórz ekran LTI 1.3 Dynamic Registration i wklej adres URL do pola Tool initiation registration endpoint (lub ekwiwalentnego). Zatwierdź.
5. Twój LMS wywoła FastComments, wymieni klucze i utworzy integrację. Okienko zamknie się samo po zakończeniu.
6. Po powrocie do FastComments nowa konfiguracja pojawi się w tabeli Existing Configurations. Narzędzie jest teraz dostępne w kursach twojego LMS.

FastComments LTI 1.3 został przetestowany w:

• D2L Brightspace (dowolna wersja z LTI Advantage)
• Moodle 4.0+ (wtyczka External Tool, LTI Advantage)
• Blackboard Learn (SaaS i Ultra)
• Sakai (wersje z obsługą LTI Advantage)
• Schoology (Enterprise, Dynamic Registration jeśli dostępne)

Każdy inny LMS, który implementuje specyfikację IMS LTI 1.3 Advantage z Dynamic Registration, powinien również działać - wybierz Other LTI 1.3 platform z rozwijanego menu platform podczas generowania Twojego URL rejestracji (uzyskaj go tutaj).

Canvas LMS używa innego procesu konfiguracji (per-developer-key configuration JSON zamiast Dynamic Registration). Zobacz dedykowany przewodnik instalacji Canvas LMS.

Przejdź do konfiguracji LTI 1.3

Zaloguj się do FastComments i przejdź do swojej strony konfiguracji LTI 1.3.

If your account doesn't yet have LTI access, you'll see "LTI not enabled for this account" - contact support to enable it on your plan.

Wybierz platformę (opcjonalnie)

W sekcji Generate a Dynamic Registration URL użyj rozwijanego menu Platform, aby poinformować FastComments, z którym LMS się łączysz:

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

Możesz też zostawić ustawienie Automatyczne wykrywanie. Platforma jest odczytywana z openid-configuration Twojego LMS podczas rejestracji; rozwijane menu tylko ustawia etykietę wyświetlaną dla powstałej konfiguracji.

Wygeneruj URL

Kliknij Generate URL. FastComments tworzy jednorazowy token rejestracyjny i pokazuje URL wyglądający tak:

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

Skopiuj go. Ten URL:

• Jest jednorazowy - po tym, jak Twój LMS wywoła go pomyślnie, token zostaje użyty.
• Wygasa po 30 minutach, jeśli nie zostanie użyty.
• Powinien być przechowywany w tajemnicy - każdy, kto ma ten URL, może zarejestrować narzędzie względem Twojego tenanta w ciągu tych 30 minut.

Istniejące konfiguracje

Po pomyślnej rejestracji nowa konfiguracja pojawi się w tabeli Existing Configurations na tej samej stronie, z informacjami o Platform, Issuer, Client ID i Status. Możesz usuwać konfiguracje z tej tabeli, jeśli kiedykolwiek będziesz potrzebować wyrejestrować usługę.

D2L Brightspace udostępnia Dynamic Registration za pośrednictwem interfejsu administracyjnego LTI Advantage. Wymagany jest dostęp administratora.

Otwórz ekran rejestracji

1. Zaloguj się do swojej instancji Brightspace jako administrator.
2. Przejdź do Admin Tools > Manage Extensibility > LTI Advantage.
3. Kliknij Register Tool. (The direct URL is https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Wklej URL

Zobaczysz formularz rejestracji. Kluczowe pole to punkt końcowy rejestracji inicjacji narzędzia (w niektórych wersjach Brightspace oznaczane jako "URL rejestracji inicjacji narzędzia").

Wklej adres rejestracyjny FastComments (pobierz go tutaj) do tego pola. Pozostaw pozostałe pola puste - są automatycznie wypełniane przez FastComments podczas wymiany rejestracyjnej.

Kliknij Register.

Zatwierdź narzędzie

Brightspace otworzy wyskakujące okno, które komunikuje się z FastComments, wymieni klucze i pokaże ekran potwierdzenia. Wyskakujące okno zamknie się automatycznie po zakończeniu rejestracji.

Nowe narzędzie pojawi się na liście narzędzi LTI Advantage. Domyślnie Brightspace oznacza nowe narzędzia jako wyłączone - przestaw przełącznik na włączone, aby Twoje kursy mogły z niego korzystać.

Dodaj wdrożenie

W Brightspace narzędzia LTI wymagają wdrożenia, zanim będą mogły być używane w kursach:

1. Otwórz nowo zarejestrowane narzędzie FastComments.
2. Kliknij View Deployments > New Deployment.
3. Nadaj wdrożeniu nazwę (np. "FastComments - All Courses"), wybierz jednostki organizacyjne, w których ma być dostępne, i zapisz.

Po pierwszym uruchomieniu poprzez to wdrożenie FastComments przypisze deployment_id do swojego rekordu konfiguracyjnego - kolejne uruchomienia z innego wdrożenia dla tego samego klienta zostaną odrzucone, chyba że ponownie zarejestrujesz.

Używasz Moodle? Publikujemy także dedykowaną wtyczkę Moodle dla FastComments z głębszą integracją niż LTI 1.3 (hooki synchronizacji ocen, rozbudowane raportowanie aktywności, natywne UI ustawień Moodle). Zobacz poradnik instalacji wtyczki Moodle. Schemat LTI 1.3 poniżej jest właściwy, jeśli chcesz pojedynczej rejestracji obejmującej też inne LMS-y, albo jeśli administrator Moodle nie zainstaluje wtyczek firm trzecich.

Moodle 4.0+ obsługuje dynamiczną rejestrację LTI 1.3 poprzez wtyczkę Narzędzie zewnętrzne.

Otwórz ekran zarządzania narzędziem

1. Zaloguj się do Moodle jako administrator witryny.
2. Przejdź do Administracja witryną > Wtyczki > Moduły aktywności > Narzędzie zewnętrzne > Zarządzaj narzędziami.

Wklej adres URL

Zobaczysz kartę oznaczoną Adres URL narzędzia. Wklej adres rejestracyjny FastComments (uzyskaj go tutaj) do pola tekstowego i kliknij Dodaj LTI Advantage.

Moodle otworzy ekran rejestracji pokazujący tożsamość narzędzia i żądane uprawnienia. Sprawdź i kliknij Aktywuj (lub Zarejestruj, w zależności od wersji Moodle).

Okno dialogowe zamknie się po zakończeniu rejestracji; nowe narzędzie FastComments pojawi się na liście Narzędzia ze statusem Aktywny.

Udostępnij

Domyślnie Moodle dodaje nowe narzędzia do listy „Narzędzia kursu”, ale nie pokazuje ich w wyborze aktywności. Aby udostępnić FastComments w całym kursie:

1. Kliknij ikonę zębatki na kafelku FastComments.
2. W sekcji Użycie konfiguracji narzędzia wybierz Pokaż w wyborze aktywności i jako wstępnie skonfigurowane narzędzie.
3. Zapisz.

Prowadzący mogą teraz dodać FastComments do dowolnego kursu poprzez Dodaj aktywność lub zasób > FastComments.

Blackboard Learn SaaS i Ultra obsługują Dynamiczną rejestrację LTI 1.3.

Otwórz ekran dostawcy narzędzia

1. Zaloguj się do Blackboard jako administrator systemu.
2. Przejdź do Panel administratora > Integracje > Dostawcy narzędzi LTI.
3. Kliknij Zarejestruj narzędzie LTI 1.3 / LTI Advantage.

Jeśli widzisz tylko 'Zarejestruj dostawcę LTI 1.1', Twoja wersja Blackboard nie obsługuje jeszcze LTI 1.3 — zaktualizuj ją lub skontaktuj się z pomocą techniczną Blackboard.

Wklej adres URL

Wklej adres rejestracyjny FastComments (pobierz go tutaj) w pole ID klienta / Adres URL rejestracji (etykietowanie w Blackboard różni się w zależności od wersji). Zatwierdź.

Blackboard przeprowadzi procedurę rejestracji z FastComments i wyświetli ekran potwierdzenia.

Zatwierdź i włącz

Blackboard domyślnie oznacza nowo zarejestrowane narzędzia jako Zatwierdzone, ale wykluczone:

1. Znajdź wpis FastComments na liście dostawców narzędzi.
2. Otwórz menu i wybierz Edytuj.
3. Ustaw Status narzędzia na Zatwierdzone.
4. W sekcji Zasady instytucji sprawdź, jakie dane użytkownika są przesyłane (imię i nazwisko, adres e-mail, rola). Zapisz.

Narzędzie jest teraz dostępne dla prowadzących, gdy dodają treści do kursów.

Sakai

Sakai obsługuje Dynamiczną Rejestrację LTI 1.3 w wydaniach z LTI Advantage. Z poziomu Obszaru administracyjnego:

1. Zaloguj się jako administrator Sakai i otwórz Obszar administracyjny.
2. Wybierz Narzędzia zewnętrzne > Zainstaluj narzędzie LTI 1.3.
3. Wklej adres rejestracyjny FastComments (uzyskaj go tutaj) i wyślij.
4. Zatwierdź narzędzie po zakończeniu procedury nawiązywania połączenia (handshake).

Narzędzie pojawi się następnie w Narzędziach zewnętrznych i może być dodane do witryn przez ich opiekunów.

Schoology

Instancje Schoology Enterprise obsługują LTI 1.3, ale dostępność rejestracji dynamicznej różni się w zależności od wdrożenia. Skonsultuj się ze swoim opiekunem konta Schoology.

Jeśli rejestracja dynamiczna nie jest dostępna na Twojej instancji Schoology, będziesz musiał skonfigurować integrację ręcznie, używając następujących punktów końcowych:

• 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

Po otrzymaniu od Schoology identyfikatora klienta (Client ID) i identyfikatora wdrożenia (Deployment ID), skontaktuj się z pomocą techniczną FastComments, aby zarejestrować konfigurację na swojej instancji.

Inne platformy LTI 1.3

Każdy LMS, który przestrzega specyfikacji IMS LTI 1.3 Advantage, powinien działać z tym samym adresem rejestracyjnym (uzyskaj go tutaj). Szukaj ustawienia oznaczonego jako "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" lub podobnego.

Jeśli Twoja platforma obsługuje jedynie ręczną konfigurację LTI 1.3, użyj czterech punktów końcowych wymienionych w sekcji Schoology powyżej i skontaktuj się z pomocą techniczną, aby dokończyć konfigurację.

Ta strona opisuje dodanie FastComments do kursu Brightspace po tym, jak administrator zarejestrował narzędzie i utworzył deployment. Jeśli narzędzie nie jest jeszcze zarejestrowane, najpierw zobacz przewodnik rejestracji D2L.

FastComments osadzony jako temat jednostki w Brightspace

Brightspace dostarcza dwa doświadczenia tworzenia zawartości: Classic Content oraz New Content Experience (zwane też Lessons). Oba udostępniają FastComments, ale ścieżki w menu różnią się. Każda z poniższych sekcji opisuje oba warianty tam, gdzie się rozchodzą.

Locate the FastComments Tool

Narzędzie FastComments pojawia się w dwóch miejscach w edytorze treści kursu:

1. W wyborze aktywności, dostępnym z przycisku modułu/jednostki Add Existing (w starszych wersjach Brightspace oznaczone jako Add Existing Activities). FastComments pojawia się bezpośrednio w pickerze w aktualnych buildach Brightspace; w starszych wersjach jest zagnieżdżone w podmenu External Learning Tools. Każda ścieżka dodaje FastComments jako samodzielny temat.
2. W dialogu Insert Stuff wewnątrz edytora HTML, w sekcji LTI Advantage. To osadza FastComments inline w temacie HTML za pomocą przepływu głębokiego linkowania LTI.

Jeśli FastComments nie pojawia się w żadnym z pickerów, deployment nie jest włączony dla jednostki organizacyjnej (org unit), w której znajduje się kurs. Poproś administratora Brightspace, aby otworzył Admin Tools > Manage Extensibility > LTI Advantage > narzędzie FastComments > View Deployments, otworzył deployment i dodał jednostkę organizacyjną kursu (lub jednostkę nadrzędną) w sekcji Org Units.

Add FastComments as a Topic in a Module

Classic Content:

1. Otwórz kurs i kliknij Content na pasku nawigacyjnym.
2. Wybierz moduł, który ma zawierać dyskusję (lub utwórz go przez Add a module).
3. Kliknij Add Existing (starszy Brightspace: Add Existing Activities > External Learning Tools).
4. W pickerze kliknij FastComments. Brightspace utworzy temat w module i powróci do widoku zawartości.
5. Kliknij nowy temat. Zmień jego nazwę na coś opisowego, np. FastComments Discussion, używając edytora tytułu inline.

New Content Experience (Lessons):

1. Otwórz kurs i kliknij Content.
2. Otwórz jednostkę i lekcję, która ma zawierać dyskusję.
3. Kliknij Add > Existing Activity i wybierz FastComments (starszy Brightspace: zagnieżdżone pod External Learning Tools).
4. Aktywność zostanie dodana do lekcji.
5. Kliknij tytuł aktywności, aby go zmienić.

Za pierwszym razem, gdy którykolwiek użytkownik (instruktor lub student) otworzy temat, FastComments inicjalizuje wątek dla tego resource link. Wątek jest powiązany z resource link ID, więc zmiana nazwy lub przeniesienie tematu nie zmienia wątku, który jest ładowany.

Embed FastComments Inline in an HTML Topic

Użyj tego przepływu, gdy chcesz, aby komentarze pojawiały się poniżej lektury, wideo lub innej zawartości wewnątrz tej samej strony tematu, zamiast jako osobny temat.

1. Otwórz lub utwórz temat HTML w module/lekcji.
2. Kliknij Edit HTML, aby otworzyć edytor HTML Brightspace.
3. Umieść kursor w miejscu, gdzie powinien się pojawić wątek komentarzy.
4. Kliknij przycisk Insert Stuff (ikona puzzla na pasku narzędzi edytora).
5. W dialogu Insert Stuff przewiń do LTI Advantage i kliknij FastComments.
6. FastComments otworzy picker deep linking. Potwierdź umiejscowienie (domyślne opcje działają dla dyskusji związanych z zawartością); kliknij Insert lub Continue.
7. Brightspace powróci do edytora HTML z blokiem zastępczym reprezentującym LTI launch. Kliknij Save and Close w temacie.

Gdy temat się załaduje, Brightspace zastąpi blok zastępczy iframe, który automatycznie uruchomi FastComments przez LTI. Studenci zobaczą wątek dyskusji inline.

Pojedynczy temat HTML może zawierać wiele głębokich linków FastComments. Każde osadzenie otrzymuje własny wątek, ponieważ każdy deep link generuje odrębny resource link ID.

Module Topic vs Inline Quicklink

Wybierz podejście module topic, gdy:

• Dyskusja jest główną aktywnością na tym etapie modułu.
• Chcesz, aby temat pojawiał się w spisie treści Brightspace, śledzeniu ukończeń i Class Progress.

Wybierz podejście inline embed, gdy:

• Komentarze powinny znajdować się poniżej innej zawartości na tej samej stronie.
• Nie chcesz oddzielnego elementu śledzonego pod kątem ukończeń w spisie treści.

Visibility, Draft, and Release Conditions

Nowy temat FastComments jest domyślnie widoczny dla studentów. Aby go ukryć podczas konfiguracji:

1. W edytorze zawartości kliknij tytuł tematu (Classic) lub menu trzech kropek przy aktywności (New Content Experience).
2. Ustaw status na Draft (Classic) lub wyłącz przełącznik Visibility (New Content Experience).

Tematy w stanie Draft są niewidoczne dla studentów. Instruktorzy i asystenci nauczyciela (TAs) nadal widzą je z odznaką "Draft".

Aby ograniczyć dostęp do tematu do konkretnej grupy lub sekcji:

1. Otwórz temat.
2. Kliknij menu tytułu tematu > Edit Properties In-place (Classic) lub Edit > Restrictions (New Content Experience).
3. W sekcji Release Conditions kliknij Create.
4. Wybierz Group enrollment lub Section enrollment, wybierz grupę/sekcję i zapisz.

Warunki wydania łączą się z własnym mapowaniem ról FastComments. Studenci, którzy nie widzą tematu, nie otrzymują LTI launch.

What Students See on First Launch

Gdy student kliknie temat (lub załaduje temat HTML z osadzeniem):

1. Brightspace wykonuje w tle LTI 1.3 launch.
2. FastComments otrzymuje imię i nazwisko studenta, e-mail, URL avatara oraz rolę w LMS i automatycznie go loguje. Nie ma monitów logowania FastComments.
3. Wątek komentarzy dla tego resource link renderuje się wewnątrz iframe Brightspace.

Mapowanie ról przy launchu:

• Brightspace Administrator becomes a FastComments admin for the thread (full moderation, delete, ban, and configuration access).
• Brightspace Instructor becomes a FastComments moderator (pin, hide, delete, ban).
• All other roles (Learner, TeachingAssistant, etc.) become standard commenters.

Komentarze są przypisywane do konta studenta w Brightspace. Jeśli student edytuje swoje imię lub avatar w Brightspace, następny LTI launch zsynchronizuje zmianę.

Iframe Height and Resize

FastComments emituje postMessage org.imsglobal.lti.frameResize przy każdym renderze wątku oraz przy zmianach zawartości (nowy komentarz, rozwinięcie odpowiedzi). Brightspace nasłuchuje tej wiadomości i dostosowuje wysokość iframe, aby wątek nie był przycięty i nie pokazywał wewnętrznego paska przewijania.

Jeśli iframe pozostaje o stałej, zbyt małej wysokości:

• Potwierdź, że kurs jest ładowany przez HTTPS. Nasłuchiwacz postMessage Brightspace odrzuca ramki mieszanej zawartości.
• Potwierdź, że żadna rozszerzenie przeglądarki nie blokuje kanału postMessage.
• Dla osadzeń inline w temacie HTML, otaczający HTML nie może owijać iframe w kontener o stałej wysokości. Usuń wszelkie inline style="height: ..." z elementu nadrzędnego.

Brightspace-Specific Gotchas

Tool not showing in the Add Existing picker. Deployment nie jest włączony dla jednostki org unit tego kursu. Administrator musi dodać jednostkę org unit (lub jednostkę nadrzędną) do listy Org Units deploymentu. Sama rejestracja narzędzia nie wystarczy; deployment określa, które kursy widzą narzędzie.

deployment_id mismatch on launch. FastComments przypina pierwszy deployment_id, który zobaczył, do rekordu TOFU. Jeśli administrator usunie pierwotny deployment i utworzy nowy, uruchomienia z nowego deploymentu będą odrzucane z błędem niedopasowania deploymentu. Naprawą jest ponowna rejestracja FastComments (wygenerowanie nowego URL rejestracji (get it here) i ponowne uruchomienie Dynamic Registration); stary rekord konfiguracji zostanie zastąpiony.

Tool launches but shows "Invalid LTI launch". Kurs znajduje się w innej strukturze tenant/org niż ta, którą obejmuje deployment, lub deployment został wyłączony po rejestracji. Ponownie sprawdź Admin Tools > Manage Extensibility > LTI Advantage > FastComments > przełącznik Enabled oraz listę org unit deploymentu.

Names and roles missing inside FastComments. Brightspace wysyła launch z roszczeniami Names and Role Provisioning Services (NRPS). Jeśli kurs został zaktualizowany ze starszego linku LTI 1.1, launch może nie zawierać roszczeń name i email. Dodaj ponownie temat FastComments przez Add Existing (nie migruj starego linku), aby launch używał LTI 1.3.

Embed shows a login screen instead of auto-SSO. Temat HTML został wstawiony jako zwykły <iframe> wskazujący na FastComments zamiast przez Insert Stuff > LTI Advantage. Zwykłe iframe pomijają LTI launch i kierują użytkowników na publiczną stronę FastComments. Usuń iframe i wstaw ponownie przez przepływ Insert Stuff.

Po tym, jak administrator zarejestruje FastComments jako narzędzie LTI 1.3 Advantage i zatwierdzi polityki instytucji, instruktorzy dodają je do kursów poprzez standardowe punkty umieszczania w Blackboard. Dokładne kroki różnią się między Widokiem kursu Ultra a Widokiem kursu Original, dlatego poniżej omówiono obie opcje.

Widok kursu Ultra

Widok kursu Ultra jest domyślny w Blackboard Learn SaaS od 2026 roku.

1. Otwórz kurs i przejdź do strony Zawartość kursu.
2. Najedź kursorem lub stuknij miejsce w konspekcie, gdzie chcesz umieścić wątek komentarzy, i kliknij fioletowy przycisk + (Dodaj treść).
3. Wybierz Content Market. Panel Content Market wyświetla wszystkie zatwierdzone narzędzia LTI i umiejscowienia Building Block dla Twojej instytucji.
4. Znajdź kafelek FastComments i kliknij go. Blackboard utworzy element zawartości w miejscu, gdzie otworzyłeś menu +.
5. Element pojawia się w konspekcie jako wpis „Widoczne dla studentów” domyślnie dla instruktorów, którzy mają ustawione jako osobisty domyślny stan Ukryj przed studentami wyłączony. Jeśli Twój domyślny stan to Ukryte, element zostanie utworzony jako ukryty i włączyć przełącznik widoczności na wierszu elementu, gdy będziesz gotowy.
6. Aby zmienić nazwę elementu, kliknij tytuł w konspekcie i wpisz nową etykietę. Tytuł widoczny dla studentów w konspekcie jest niezależny od identyfikatora wątku FastComments, więc zmiana nazwy jest bezpieczna w dowolnym momencie.

Jeśli nie widzisz Content Market jako opcji, Twoja instytucja ukryła to umiejscowienie. Możesz też otworzyć ten sam wybór przez Więcej narzędzi w tym samym menu + pod grupą Narzędzia LTI.

Widok kursu Original

Widok kursu Original jest wciąż obsługiwany w Learn SaaS i pozostaje głównym doświadczeniem dla samodzielnie hostowanych witryn Learn 9.1 na linii wydań CU z Q4 2024.

1. Otwórz kurs i wejdź do Obszaru zawartości (na przykład domyślnego obszaru Informacje lub Zawartość w menu kursu).
2. Włącz Tryb edycji za pomocą przełącznika w prawym górnym rogu strony.
3. Kliknij Build Content na pasku akcji.
4. W podmenu Learning Tools kliknij FastComments. Podmenu Learning Tools jest wypełniane z umiejscowień narzędzia LTI 1.3 po tym, jak administrator zarejestruje narzędzie. Jeśli go nie widzisz, zobacz sekcję „uwagi” poniżej.
5. W formularzu Create FastComments ustaw:
   • Name: etykieta widoczna dla studentów w obszarze zawartości.
   • Description: opcjonalny tekst wyświetlany nad osadzonym wątkiem.
   • Permit Users to View this Content: przełącznik dostępności Tak/Nie.
   • Track Number of Views: włącz, jeśli chcesz statystyki wyświetleń dla pozycji w Blackboard. FastComments prowadzi własną analitykę niezależnie.
   • Date and Time Restrictions: opcjonalne okna Display After / Display Until.
6. Wyślij. Narzędzie pojawi się jako element klikalny w obszarze zawartości.

Osadzanie wewnątrz elementu lub dokumentu

W obu widokach kursu instruktorzy osadzają FastComments inline w treści elementu, dokumentu lub dowolnego pola bogatego tekstu za pomocą przycisku LTI Advantage w Edytorze treści.

Widok kursu Ultra:

1. Utwórz lub edytuj Dokument.
2. Kliknij Add content wewnątrz treści dokumentu w miejscu, gdzie chcesz, aby pojawił się wątek.
3. W pasku narzędzi edytora otwórz menu Wstaw zawartość i kliknij Content Market (punkt wejścia LTI Advantage / Deep Linking).
4. Wybierz FastComments. FastComments zwróci ładunek deep-link, a Blackboard wstawi osadzony blok w treści dokumentu w pozycji kursora.
5. Zapisz dokument. Studenci zobaczą wątek wyrenderowany inline, gdy przewiną do niego.

Widok kursu Original:

1. Edytuj dowolny element z treścią typu rich-text.
2. W pasku narzędzi Content Editor kliknij ikonę plus Add Content i wybierz Content Market (oznaczone jako Add Content from External Tool w starszych CU z Q4 2024).
3. Wybierz FastComments. Edytor wstawi blok zastępczy odnoszący się do zasobu deep-link.
4. Wyślij element.

Każde osadzenie deep-link tworzy własny wątek FastComments, więc element z dwoma osadzonymi blokami FastComments ma dwa niezależne strumienie komentarzy.

Widoczność, warunki udostępniania i ograniczenia grupowe

Elementy zawartości FastComments zachowują się jak każdy inny element zawartości w Blackboard pod względem zasad kontroli dostępu na nich nakładanych.

• Ultra: kliknij selektor widoczności na wierszu (Widoczne dla studentów, Ukryte przed studentami, Dostęp warunkowy). Dostęp warunkowy obsługuje okna dat/godzin, reguły wydajności względem elementów w księdze ocen oraz reguły członkostwa względem grup kursu.
• Original: otwórz menu kontekstowe elementu i wybierz Adaptive Release lub Adaptive Release: Advanced, aby ograniczyć narzędzie według daty, członkostwa, oceny lub statusu przeglądu. Użyj Set Group Availability na elemencie, aby ograniczyć dostęp do konkretnych grup kursu.

FastComments respektuje decyzję bramki Blackboard. Jeśli Blackboard ukryje element przed studentem, uruchomienie LTI nigdy nie nastąpi dla tego studenta i nie pojawi się on w widoku moderatora.

Zachowanie w Księdze ocen

FastComments nie przesyła ocen z powrotem przez LTI Advantage Assignment and Grade Services. Dla elementów zawartości FastComments nie tworzy się automatycznie kolumna ocen.

Jeśli Twoja instancja Blackboard jest skonfigurowana tak, że automatycznie tworzy kolumnę w księdze ocen dla każdego nowego elementu zawartości niezależnie od metadanych oceny, pojawi się pusta kolumna. Aby ją ukryć:

• Ultra: otwórz Gradebook, kliknij nagłówek kolumny, wybierz Edit i wyłącz Show to students oraz Include in calculations. Albo użyj Delete, jeśli Twoja instytucja zezwala na usuwanie kolumn dla pozycji nieocenianych.
• Original: otwórz Grade Center, kliknij trójkąt przy kolumnie, wybierz Hide from Users (on/off), a opcjonalnie Hide from Instructor View w Column Organization.

Co widzą studenci

Gdy student otworzy element FastComments lub przewinie do osadzonego bloku:

1. Blackboard uruchamia komunikat LTI 1.3 do FastComments. Student zostaje zalogowany przez SSO przy użyciu swojej tożsamości Blackboard (imię, e-mail, avatar, rola) bez wyświetlania formularza logowania.
2. Wątek komentarzy renderuje się w iframe. Wątkowanie, odpowiedzi, wzmianki i reakcje są dostępne w zależności od ustawień widżetu komentarzy skonfigurowanych w FastComments.
3. Ich komentarze są przypisywane do konta Blackboard. Jeśli student później zmieni imię lub zdjęcie w Blackboard, przy następnym uruchomieniu profil FastComments zostanie zaktualizowany.

Mapowanie ról z Blackboard do FastComments:

• System Administrator i Course Builder mapują się na FastComments admin.
• Instructor i Teaching Assistant mapują się na FastComments moderator.
• Student, Guest i Observer mapują się na FastComments commenter.

Moderatorzy widzą kontrolki moderacji (przypnij, ukryj, zablokuj, usuń) bezpośrednio na każdym komentarzu w wątku.

Zakres wątku

FastComments określa zakres każdego wątku przez (host Blackboard, ID kursu, ID linku zasobu). Dwa elementy FastComments w tym samym kursie tworzą dwa wątki. Ten sam element skopiowany do dwóch szablonów kursu (na przykład przez kopiowanie kursu) tworzy dwa wątki, ponieważ Blackboard wydaje nowy resource link ID podczas kopiowania. Aby zachować współdzielony wątek po kopiowaniu kursu, użyj Deep Linking z jawnie określonym URN wątku skonfigurowanym w FastComments przed uruchomieniem kopiowania.

Specyficzne uwagi dotyczące Blackboard

Brak kafelka FastComments w menu Build Content (Original) lub w Content Market (Ultra). Administrator zatwierdził narzędzie, ale pozostawił politykę instytucji blokującą odpowiednie umiejscowienie. Przejdź do Administrator Panel > Integrations > LTI Tool Providers, edytuj wpis FastComments i potwierdź, że zarówno umiejscowienie Course Content Tool (Original), jak i Course Content Tool - allow students / Deep Linking content tool (Ultra) są włączone. Zapisz i odśwież stronę kursu.

Błąd „Tool not configured for this context” lub „Tool is not deployed” podczas uruchamiania. Zakres wdrożenia zarejestrowany podczas rejestracji dynamicznej nie odpowiada kontekstowi instytucji, do którego należy kurs. W wpisie dostawcy narzędzia w Blackboard sprawdź, czy Deployment ID odpowiada temu, który FastComments pokazuje na swojej stronie Konfiguracji LTI 1.3 dla tego tenant. Jeśli się różnią, usuń umiejscowienie i ponownie uruchom rejestrację dynamiczną z nowego adresu rejestracji (uzyskaj go tutaj).

Wysokość iframe wydaje się stała lub zawartość jest obcinana. Niektóre instancje Blackboard mają rygorystyczną Content Security Policy, która blokuje domyślny postMessage do zmiany rozmiaru iframe LTI. FastComments emituje zarówno komunikat w stylu Canvas lti.frameResize, jak i komunikat zgodny ze specyfikacją IMS org.imsglobal.lti.frameResize, aby zmaksymalizować kompatybilność, ale nakładka CSP na poziomie tenant może blokować listener w rodzicu. Poproś administratora, aby potwierdził, że *.fastcomments.com jest na liście dozwolonych narzędzi LTI i że żaden niestandardowy nagłówek CSP nie usuwa zdarzeń postMessage. Po tym zmiana rozmiaru powinna działać bez dalszej konfiguracji.

Kopiowanie kursu powoduje duplikowanie wątków. Przy kopiowaniu kursu Blackboard wydaje nowe resource link ID dla umiejscowień LTI, więc skopiowane kursy zaczynają z pustymi wątkami. To zachowanie jest oczekiwane. Jeśli chcesz, aby skopiowany kurs odziedziczył oryginalny wątek, skonfiguruj Deep Linking z jawnie określonym URN wątku przed kopiowaniem lub skontaktuj się z pomocą techniczną FastComments, aby masowo przypisać ID wątków.

Student widzi ogólny błąd Blackboard przy uruchomieniu. Przyczyną jest brakujący lub przestarzały claim email. Potwierdź, że polityka instytucji dla FastComments ma włączone Role, Name oraz Email Address w sekcji User Fields to Send. Zapisz ustawienia, a następnie uruchom ponownie w świeżej sesji przeglądarki.

"Token rejestracyjny nie znaleziony, wygasł lub został już użyty"

Token w Twoim URL rejestracyjnym (uzyskaj go tutaj) jest ważny przez 30 minut i może być użyty tylko raz. Jeśli Twój LMS potrzebował więcej czasu niż to, lub jeśli rejestracja została ponowiona po pomyślnym zakończeniu, token zostanie odrzucony. Wygeneruj nowy URL na stronie konfiguracji FastComments LTI 1.3 i zacznij od początku.

"Platform rejected registration"

Twój LMS odrzucił procedurę rejestracji. Najczęstsze przyczyny:

• Tool already registered with the same client name. Niektóre platformy (w szczególności D2L) odrzucają drugą rejestrację "FastComments" dopóki poprzednia nie zostanie usunięta. Usuń stare narzędzie w swoim LMS, a następnie spróbuj ponownie.
• Wrong field in the LMS. Upewnij się, że wkleiłeś URL do pola registration / tool initiation registration endpoint, a nie do pola launch URL lub login URL.
• The LMS doesn't actually support Dynamic Registration. Starsze wersje Moodle i Blackboard reklamują LTI 1.3, ale pozwalają tylko na ręczną konfigurację. Sprawdź dokumentację swojej platformy.

"Failed to fetch platform configuration"

FastComments nie mogło odczytać dokumentu openid-configuration Twojego LMS. To rzadkie i zazwyczaj oznacza, że LMS podał niepoprawny lub nieosiągalny discovery URL. Skontaktuj się ze wsparciem swojego LMS.

Launch shows "Configuration not found"

Albo konfiguracja w FastComments została usunięta, albo uruchomienie pochodziło z pary iss/client_id, której nie rozpoznajemy. Jeśli usunąłeś i ponownie zarejestrowałeś, poinstruuj swój LMS, aby usunął i ponownie dodał narzędzie FastComments, aby otrzymało nowe client_id.

Launch shows "Deployment not registered"

Uruchomiłeś FastComments z wdrożenia Brightspace/Moodle/Blackboard innego niż to, w którym zostało uruchomione po raz pierwszy. FastComments przypisuje deployment_id przy pierwszym uruchomieniu jako kontrolę bezpieczeństwa. Aby dodać nowe wdrożenie pod tym samym klientem, skontaktuj się z pomocą techniczną — dodamy identyfikator wdrożenia do konfiguracji.

Launch shows "Unsupported message_type"

LMS wysłał komunikat LTI, którego FastComments nie obsługuje (np. LtiSubmissionReviewRequest). FastComments obsługuje tylko standardowy resource-link launch oraz przepływy deep-linking. Skontaktuj się z nami, jeśli potrzebujesz dodania konkretnego typu komunikatu.

Iframe doesn't resize

Większość LMS automatycznie dopasowuje rozmiar iframe'ów LTI. Jeśli Twój tego nie robi, sprawdź, czy ustawienia uruchamiania LMS pozwalają narzędziu wysyłać zdarzenia postMessage do ramki nadrzędnej. FastComments wysyła zarówno komunikaty zmiany rozmiaru w stylu Canvas (lti.frameResize), jak i zgodne ze specyfikacją IMS (org.imsglobal.lti.frameResize).