Add Comments to Canvas LMS via LTI 1.3
FastComments се интегрира с Canvas LMS чрез стандарта LTI 1.3. Това добавя възможност за коментиране в реално време и съвместен чат директно във вашите Canvas курсове - без плъгин за инсталиране на вашия сървър.
Коментарите се появяват автоматично под заданията, а преподавателите могат да вграждат FastComments в Страници, Тестове и Обявления чрез Редактора за богато съдържание. SSO се обработва автоматично чрез стартирането на LTI - студентите коментират с акаунтите си в Canvas без отделно влизане. Интеграцията поддържа коментари в нишки, чат за съвместна работа в реално време с маркиране на текст и автоматично съпоставяне на роли.
Ценообразуване 
Интеграцията FastComments LTI 1.3 е включена в плановете Flex и Pro без допълнителни разходи.
Бърз старт
- Отидете на вашата FastComments LTI конфигурация.
- Въведете Configuration Name и вашия Platform URL (e.g.
https://yourschool.instructure.com). Изберете кои Placements да активирате (Assignment View and/or Editor Button — both are on by default). Кликнете Create Configuration. Съветникът преминава към Стъпка 2 и показва вашия Configuration URL. - В Canvas отидете на Admin > Developer Keys > + Developer Key > LTI Key. Задайте Method на "Enter URL" и поставете Configuration URL. Запазете ключа, след което задайте State на ON и кликнете Allow, когато бъдете подканени.
- Копирайте номера на Client ID от таблицата Developer Keys в Canvas. Върнете се във FastComments, поставете го в полето Client ID и кликнете Save & Continue.
- Прегледайте обобщението на конфигурацията и кликнете Enable Integration, за да активирате интеграцията.
- Инсталирайте външното приложение в Canvas (Admin > Settings > Apps > + App > By Client ID). Коментарите ще се появяват автоматично под заданията, а преподавателите могат да вграждат FastComments в Pages, Quizzes и Announcements чрез бутона в лентата с инструменти на Rich Content Editor.
Настройка на таблото на FastComments
Navigate to LTI Config
Отидете до вашата FastComments LTI конфигурация.
Страницата за настройка използва съветник, който ви води през всяка стъпка. Ще започнете от Стъпка 1: Създаване.
Create a New LTI Configuration
Попълнете следните полета:
- Configuration Name - опционален етикет за идентифициране на тази конфигурация (полезно, ако свържете няколко инстанции на Canvas).
- Platform URL - URL адресът на вашата инстанция Canvas (напр.
https://yourschool.instructure.com). Това поле е задължително.
Choose Placements
Под Platform URL можете да изберете къде FastComments да се появява в курсовете ви в Canvas. И двете разположения са активирани по подразбиране:
- Изглед на заданието - коментарите се показват автоматично под заданията.
- Бутон в редактора за богато съдържание - инструкторите могат да вграждат FastComments в Страници, Тестове и Обявления чрез бутона в лентата с инструменти на редактора за богато съдържание.
Можете да активирате едното или и двете. Поне едно разположение трябва да бъде активно.
Щракнете върху Създаване на конфигурация.
Copy the Configuration URL
След създаването на конфигурацията, съветникът преминава към Стъпка 2: Свързване. В горната част на страницата се показва видим URL на конфигурацията с бутон Копиране.
Копирайте този URL. Ще ви е необходим в следващата стъпка, за да създадете Developer Key в Canvas.
Страницата също показва номерирани инструкции какво да направите в Canvas, както и полета за въвеждане на Client ID и опционалния Deployment ID, след като ги получите.
Ключ за разработчик на Canvas
Open Developer Keys in Canvas
Log in to Canvas as an administrator. Go to Admin (in the left sidebar) > select your account > Developer Keys.
Create an LTI Developer Key
Click + Developer Key and select LTI Key.
In the configuration form:
- In the Redirect URIs field (left side), paste the Launch URL from the FastComments setup page.
- On the right, set Method to Enter URL.
- Paste the Configuration URL you copied from FastComments into the JSON URL field.
- Canvas will load the LTI configuration automatically.
- Give the key a name (e.g. "FastComments").
- Click Save.
Enable the Developer Key
After saving, the new key will appear in the Developer Keys table with its State set to OFF. Click the toggle to set it to ON. Canvas may prompt you to confirm — click Allow to enable the key.
Copy the Client ID
The Developer Keys table shows a numeric Client ID in the Details column (e.g. 17000000000042). Copy this number - you will need it in the next step.
Завършване на връзката
Въведете Client ID в FastComments
Върнете се към вашата FastComments LTI конфигурация. Съветникът трябва да е на Стъпка 2: Свързване.
Поставете Client ID, който сте копирали от Canvas, в полето Client ID. По желание въведете Deployment ID, ако вашият LMS предоставя такъв.
Щракнете върху Запази и продължи.
Активиране на интеграцията
Съветникът преминава към Стъпка 3: Пускане в продукция. Показва се резюме на вашата конфигурация (име, URL на платформата, Client ID и Deployment ID).
Прегледайте подробностите, след това щракнете върху Активирай интеграцията, за да активирате LTI връзката.
След активиране, съветникът показва Management View, където можете да редактирате конфигурацията си, да видите всички LTI URL адреси или да добавите допълнителни разгръщания.
Инсталирайте външното приложение в Canvas
В Canvas отидете на Администратор > изберете вашия акаунт > Настройки > раздел Приложения.
Щракнете върху + Приложение и конфигурирайте:
- Задайте Тип на конфигурацията на По Client ID.
- Поставете Client ID от таблицата Developer Keys.
- Щракнете върху Изпрати.
- Потвърдете инсталацията, когато бъдете подканени.
FastComments вече е инсталиран на ниво акаунт и е достъпен за всички курсове.
Добавяне към курс
Как се показват коментарите във вашите курсове
След като LTI интеграцията е активирана и Външното приложение е инсталирано, FastComments работи автоматично въз основа на конфигурираните от вас места за показване:
Изглед на задание
Ако е активирана поставката Изглед на задание, коментарите се появяват автоматично под всяко задание в курса. Студентите и преподавателите виждат нишкова секция за коментари, когато преглеждат задание — не е необходима допълнителна настройка за всяко задание.
Всяко задание получава собствена отделна нишка с коментари.
Бутон на редактора за богато съдържание
Ако е активирана поставката Бутон на редактора, преподавателите могат да вграждат FastComments във всяко съдържание, което използва Редактора за богато съдържание:
- Редактирайте Страница, Тест или Съобщение.
- В лентата с инструменти на Редактора за богато съдържание, щракнете върху бутона FastComments.
- FastComments се вгражда автоматично в съдържанието.
- Запазете страницата.
Когато студентите преглеждат страницата, вграденият компонент на FastComments се зарежда с нишка за коментари, уникална за тази страница.
Автоматично единно влизане (SSO)
В и двете поставки студентите автоматично влизат чрез своя Canvas акаунт. Имена, имейли и аватари се синхронизират чрез LTI стартирането — не е необходим отделен вход.
Стилове на коментиране
FastComments добавя коментари в нишки към вашите курсове в Canvas. Стандартният уиджет на FastComments се появява на страницата. Потребителите могат да публикуват коментари в нишки, да отговарят, да гласуват и да използват всички стандартни функции.
Коментарите са прикрепени към всяка страница на курса или към връзка към ресурс, така че дискусиите остават организирани по страница, задание или модул.
Съпоставяне на роли
Ролите в Canvas се съпоставят автоматично с ролите в FastComments по време на стартиране чрез LTI. Не е необходима ръчна конфигурация.
Съпоставяне на роли
| Роля в Canvas | Роля в FastComments | Разрешения |
|---|---|---|
| Администратор | Admin | Пълен достъп до акаунта, управление на всички коментари и настройки |
| Преподавател | Moderator | Редактиране и изтриване на коментари, закрепване на нишки, управление на дискусии |
| Ученик | Commenter | Публикуване на коментари, отговаряне, гласуване и използване на споменавания |
Как работи
Когато потребител стартира FastComments от Canvas, протоколът LTI 1.3 включва неговата роля в Canvas. FastComments прочита тази роля и автоматично присвоява подходящите разрешения.
Ако потребителят има няколко роли (например Преподавател, който също е Администратор), се използва ролята с най-високи привилегии.
Персонализиране
FastComments е създаден така, че да може да бъде персонализиран, за да отговаря на вашия сайт.
Ако искате да добавите собствен стил или да промените конфигурацията, Разгледайте документацията ни за персонализиране, за да научите как.
Грешки с домейна
Може да получите грешка при упълномощаване, като следната:
Това се случва, защото FastComments не знае, че трябва да разреши използването на вашия акаунт на този домейн.
В този случай решението е просто. Трябва само да добавите домейна на вашата Canvas инстанция към акаунта си във FastComments.
Отидете тук, за да добавите сайта си към акаунта си.
Добавете домейна на Canvas (e.g. yourschool.instructure.com) и коментарите ще се зареждат правилно.