Dodaj komentarze do Canvas LMS za pomocą 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 na podstawie umiejscowień, które skonfigurowałeś:
Widok zadania
Jeśli umiejscowienie Widok zadania jest włączone, komentarze pojawiają się automatycznie poniżej każdego zadania w kursie. Studenci i instruktorzy widzą sekcję z wątkami komentarzy podczas przeglądania zadania — nie jest potrzebna dodatkowa konfiguracja dla każdego zadania.
Każde zadanie otrzymuje swój własny, oddzielny wątek komentarzy.
Przycisk Edytora treści sformatowanej
Jeśli umiejscowienie Przycisk Edytora jest włączone, instruktorzy mogą osadzać FastComments w dowolnej treści korzystającej z Edytora treści sformatowanej:
- Edytuj Stronę, Quiz lub Ogłoszenie.
- W pasku narzędzi Edytora treści sformatowanej kliknij przycisk FastComments.
- FastComments jest automatycznie osadzany w treści.
- Zapisz stronę.
Gdy studenci przeglądają stronę, osadzony widget FastComments ładuje się z wątkiem komentarzy unikatowym dla tej strony.
Automatyczne logowanie SSO
W obu umiejscowieniach studenci są automatycznie logowani za pomocą swojego konta Canvas. Imiona i nazwiska, adresy e-mail oraz awatary są synchronizowane przez uruchomienie LTI, nie jest potrzebne osobne logowanie.
Zablokuj publiczny dostęp (zalecane)
Domyślnie dane komentarzy FastComments są publicznie czytelne. Każdy, kto zgadnie URL wątku lub punkt końcowy API, może zobaczyć jego komentarze, nawet poza Canvas. Dla dyskusji kursowych prawie na pewno chcesz ograniczyć ich widoczność tylko do zapisanych studentów.
Otwórz swoją stronę dostosowywania widgetu i utwórz regułę z włączoną opcją Wymagaj SSO do wyświetlania komentarzy, a następnie ustaw poziom zabezpieczeń na Bezpieczne SSO, aby wątki mogły być ładowane tylko przez podpisane uruchomienie LTI.
Zobacz Ochrona wątków komentarzy za pomocą logowania jednokrotnego (SSO) po pełny przewodnik, w tym jak ograniczyć regułę do pojedynczej domeny lub strony.
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.