Add Comments to Canvas LMS via LTI 1.3
FastComments integruje się z Canvas LMS przez standard LTI 1.3. To dodaje komentowanie na żywo i wspólny czat bezpośrednio do Twoich kursów w Canvas - bez wtyczki do zainstalowania na Twoim serwerze.
Komentarze pojawiają się automatycznie pod zadaniami, a instruktorzy mogą osadzać FastComments na Pages, Quizzes i Announcements za pomocą Rich Content Editor. SSO jest obsługiwane automatycznie przez uruchomienie LTI - studenci komentują przy użyciu swoich kont Canvas bez oddzielnego logowania. Integracja obsługuje wątki komentarzy, czat współpracujący w czasie rzeczywistym z podświetlaniem tekstu oraz automatyczne mapowanie ról.
Cennik 
Integracja FastComments LTI 1.3 jest uwzględniona w planach Flex i Pro bez dodatkowych opłat.
Szybki start
- Przejdź do Twojej konfiguracji LTI FastComments.
- Wprowadź Configuration Name oraz Platform URL (np.
https://yourschool.instructure.com). Wybierz, które Placements włączyć (Assignment View i/lub Editor Button — oba są domyślnie włączone). Kliknij Create Configuration. Kreator przechodzi do Kroku 2 i pokazuje Twój Configuration URL. - W Canvas przejdź do Admin > Developer Keys > + Developer Key > LTI Key. Ustaw Method na "Enter URL" i wklej Configuration URL. Zapisz klucz, następnie ustaw jego State na ON i kliknij Allow, kiedy pojawi się monit.
- Skopiuj numer Client ID z tabeli Developer Keys w Canvas. W FastComments wklej go w pole Client ID i kliknij Save & Continue.
- Przejrzyj podsumowanie konfiguracji i kliknij Enable Integration, aby uruchomić integrację.
- Zainstaluj External App w Canvas (Admin > Settings > Apps > + App > By Client ID). Komentarze będą automatycznie pojawiać się pod zadaniami, a instruktorzy mogą osadzić FastComments na Stronach, w Quizach i Ogłoszeniach za pomocą przycisku na pasku narzędzi Rich Content Editor.
Konfiguracja panelu FastComments
Przejdź do konfiguracji LTI
Przejdź do swojej konfiguracji LTI FastComments.
Strona konfiguracji korzysta z kreatora krok po kroku, który przeprowadzi Cię przez każdy etap. Zaczynasz od Krok 1: Utwórz.
Utwórz nową konfigurację LTI
Wypełnij następujące pola:
- Configuration Name - opcjonalna etykieta identyfikująca tę konfigurację (przydatne, jeśli podłączysz wiele instancji Canvas).
- Platform URL - adres URL Twojej instancji Canvas (np.
https://yourschool.instructure.com). To pole jest wymagane.
Wybierz miejsca umieszczenia
Poniżej pola Platform URL możesz wybrać, gdzie FastComments będzie widoczny w kursach Canvas. Oba miejsca są domyślnie włączone:
- Assignment View - komentarze pojawiają się automatycznie poniżej zadań.
- Rich Content Editor Button - instruktorzy mogą osadzać FastComments na Stronach, w Quizach i Ogłoszeniach, używając przycisku na pasku narzędzi Edytora Rich Content.
Możesz włączyć jedno lub oba. Przynajmniej jedno musi być włączone.
Kliknij Create Configuration.
Skopiuj URL konfiguracji
Po utworzeniu konfiguracji kreator przejdzie do Krok 2: Połącz. Na górze strony wyraźnie wyświetlany jest Configuration URL z przyciskiem Copy.
Skopiuj ten URL. Będziesz go potrzebować w następnym kroku do utworzenia Klucza deweloperskiego w Canvas.
Strona pokazuje także ponumerowane instrukcje, co zrobić w Canvas, oraz pola do wprowadzenia Client ID i opcjonalnie Deployment ID, gdy już je będziesz mieć.
Klucz deweloperski Canvas
Open Developer Keys in Canvas
Zaloguj się do Canvas jako administrator. Przejdź do Admin (na lewym pasku bocznym) > wybierz swoje konto > Developer Keys.
Create an LTI Developer Key
Kliknij + Developer Key i wybierz LTI Key.
W formularzu konfiguracji:
- W polu Redirect URIs (lewa strona) wklej Launch URL ze strony konfiguracji FastComments.
- Po prawej ustaw Method na Enter URL.
- Wklej Configuration URL, który skopiowałeś z FastComments, do pola JSON URL.
- Canvas automatycznie załaduje konfigurację LTI.
- Nadaj kluczowi nazwę (np. "FastComments").
- Kliknij Save.
Enable the Developer Key
Po zapisaniu nowy klucz pojawi się w tabeli Developer Keys z jego State ustawionym na OFF. Kliknij przełącznik, aby ustawić go na ON. Canvas może poprosić o potwierdzenie — kliknij Allow, aby włączyć klucz.
Copy the Client ID
W tabeli Developer Keys w kolumnie Details widoczny jest numeryczny Client ID (np. 17000000000042). Skopiuj tę liczbę — będziesz jej potrzebować w następnym kroku.
Dokończ połączenie
Wprowadź Client ID w FastComments
Wróć do Twojej konfiguracji LTI FastComments. Kreator powinien być na Step 2: Connect.
Wklej Client ID, które skopiowałeś z Canvas, do pola Client ID. Opcjonalnie wpisz Deployment ID, jeśli Twój LMS je udostępnia.
Kliknij Save & Continue.
Włącz integrację
Kreator przechodzi do Step 3: Go Live. Wyświetlane jest podsumowanie konfiguracji (nazwa, platform URL, Client ID, and deployment ID).
Przejrzyj szczegóły, a następnie kliknij Enable Integration, aby aktywować połączenie LTI.
Po włączeniu kreator pokaże Management View, w którym możesz edytować konfigurację, przeglądać wszystkie LTI URLs lub dodać dodatkowe wdrożenia.
Zainstaluj External App w Canvas
W Canvas przejdź do Admin > wybierz swoje konto > Settings > zakładka Apps.
Kliknij + App i skonfiguruj:
- Ustaw Configuration Type na By Client ID.
- Wklej Client ID z tabeli Developer Keys.
- Kliknij Submit.
- Potwierdź instalację, gdy zostaniesz o to poproszony.
FastComments jest teraz zainstalowany na poziomie konta i dostępny dla wszystkich kursów.
Dodaj do kursu
Jak komentarze pojawiają się w Twoich kursach
Po włączeniu integracji LTI i zainstalowaniu Aplikacji Zewnętrznej, FastComments działa automatycznie w oparciu o umiejscowienia, które skonfigurowałeś:
Assignment View
Jeśli umiejscowienie Assignment View jest włączone, komentarze pojawiają się automatycznie poniżej każdego zadania w kursie. Studenci i instruktorzy widzą sekcję komentarzy z wątkami podczas przeglądania zadania — nie jest potrzebna dodatkowa konfiguracja dla każdego zadania.
Każde zadanie ma własny, oddzielny wątek komentarzy.
Rich Content Editor Button
Jeśli umiejscowienie Editor Button jest włączone, instruktorzy mogą osadzić FastComments w dowolnej treści korzystającej z Rich Content Editor:
- Edytuj Page, Quiz, lub Announcement.
- W pasku narzędzi Edytora treści bogatej kliknij przycisk FastComments.
- FastComments jest automatycznie osadzany w treści.
- Zapisz stronę.
Gdy studenci przeglądają stronę, osadzony widżet FastComments ładuje się z wątkiem komentarzy unikalnym dla tej strony.
Automatic SSO
W obu umiejscowieniach studenci są automatycznie logowani za pomocą konta Canvas. Nazwy, adresy e-mail i awatary są synchronizowane podczas uruchomienia LTI — nie jest wymagane osobne logowanie.
Style komentowania
FastComments dodaje wątkowe komentarze do Twoich kursów w Canvas. Na stronie pojawia się standardowy widżet FastComments. Użytkownicy mogą zamieszczać wątkowe komentarze, odpowiadać, głosować i korzystać ze wszystkich standardowych funkcji.
Komentarze są przypisane do każdej strony kursu lub linku do zasobu, dzięki czemu dyskusje pozostają uporządkowane według strony, zadania lub modułu.
Mapowanie ról
Role w Canvas są automatycznie mapowane na role FastComments podczas uruchomienia LTI. Nie jest wymagana ręczna konfiguracja.
Mapowanie ról
| Canvas Role | FastComments Role | Permissions |
|---|---|---|
| Administrator | Admin | Pełny dostęp do konta, zarządzanie wszystkimi komentarzami i ustawieniami |
| Instructor | Moderator | Edytowanie i usuwanie komentarzy, przypinanie wątków, zarządzanie dyskusjami |
| Learner | Commenter | Publikowanie komentarzy, odpowiadanie, głosowanie oraz używanie wzmianek |
Jak to działa
Kiedy użytkownik uruchamia FastComments z Canvas, protokół LTI 1.3 zawiera jego rolę w Canvas. FastComments odczytuje tę rolę i automatycznie przypisuje odpowiednie uprawnienia.
Jeśli użytkownik ma wiele ról (np. użytkownik, który pełni rolę Instructor i jednocześnie rolę Admin), używana jest rola o najwyższych uprawnieniach.
Dostosowywanie
FastComments został zaprojektowany tak, aby można go było dostosować do Twojej witryny.
Jeśli chcesz dodać niestandardowe style lub zmodyfikować konfigurację, Zapoznaj się z naszą dokumentacją dotyczącą personalizacji, aby dowiedzieć się, jak.
Błędy domeny
Możesz otrzymać błąd autoryzacji, taki jak poniżej:
Dzieje się tak, ponieważ FastComments nie wie, że powinno zezwolić na użycie twojego konta na tej domenie.
W takim przypadku naprawa jest prosta. Wystarczy dodać domenę instancji Canvas do konta FastComments.
Kliknij tutaj, aby dodać swoją witrynę do konta.
Dodaj domenę Canvas (np. yourschool.instructure.com) i komentarze powinny się wczytywać prawidłowo.