Добавление комментариев в Canvas LMS через LTI 1.3
FastComments интегрируется с Canvas LMS через стандарт LTI 1.3. Это добавляет возможности комментариев в реальном времени и совместного чата прямо в ваши курсы Canvas - no plugin to install on your server.
Комментарии появляются автоматически под заданиями, а преподаватели могут встраивать FastComments в Pages, Quizzes и Announcements через Rich Content Editor. SSO обрабатывается автоматически через LTI launch - студенты комментируют с помощью своих Canvas accounts без отдельного входа. Интеграция поддерживает ветвящиеся комментарии, совместный чат в реальном времени с подсветкой текста и автоматическое сопоставление ролей.
Ценообразование 
Интеграция FastComments LTI 1.3 включена в планы Flex и Pro без дополнительной оплаты.
Быстрый старт
- Перейдите к настройке LTI FastComments.
- Введите Configuration Name и ваш Platform URL (например,
https://yourschool.instructure.com). Выберите, какие Placements включить (Assignment View и/или Editor Button — оба включены по умолчанию). Нажмите Create Configuration. Мастер перейдёт к Шагу 2 и покажет ваш Configuration URL. - В Canvas перейдите в Admin > Developer Keys > + Developer Key > LTI Key. Установите Method в "Ввести URL" и вставьте Configuration URL. Сохраните ключ, затем установите его State в ВКЛ и нажмите Разрешить, когда появится запрос.
- Скопируйте номер Client ID из таблицы Developer Keys в Canvas. Вернувшись в FastComments, вставьте его в поле Client ID и нажмите Save & Continue.
- Просмотрите сводку конфигурации и нажмите Enable Integration, чтобы включить интеграцию.
- Установите External App в Canvas (Admin > Settings > Apps > + App > By Client ID). Комментарии автоматически появятся под заданиями, а преподаватели смогут встраивать FastComments в Pages, Quizzes и Announcements через кнопку на панели инструментов Rich Content Editor.
Настройка панели FastComments
Перейдите к конфигурации LTI
Откройте вашу конфигурацию LTI в FastComments.
Страница настройки использует пошаговый мастер, который проведёт вас через каждый этап. Вы начнёте с Шага 1: Создание.
Создайте новую конфигурацию LTI
Заполните следующие поля:
- Название конфигурации — необязательная метка для идентификации этой конфигурации (полезно, если вы подключаете несколько экземпляров Canvas).
- URL платформы — URL вашего экземпляра Canvas (например,
https://yourschool.instructure.com). Это обязательное поле.
Выберите размещения
Под URL платформы вы можете выбрать, где FastComments будет отображаться в ваших курсах Canvas. Оба размещения включены по умолчанию:
- Просмотр задания — комментарии автоматически появляются под заданиями.
- Кнопка в редакторе Rich Content Editor — преподаватели могут встраивать FastComments в страницы, тесты и объявления с помощью кнопки на панели инструментов в редакторе Rich Content Editor.
Вы можете включить одно или оба. Должно быть включено хотя бы одно размещение.
Нажмите Create Configuration.
Скопируйте URL конфигурации
После создания конфигурации мастер перейдёт к Шагу 2: Подключение. В верхней части страницы будет отображён заметный URL конфигурации с кнопкой Copy.
Скопируйте этот URL. Он понадобится вам на следующем шаге для создания ключа разработчика в Canvas.
На странице также приведены пронумерованные инструкции о том, что нужно сделать в Canvas, а также поля для ввода Client ID и необязательного Deployment ID, когда они у вас появятся.
Ключ разработчика Canvas
Откройте раздел «Ключи разработчика» в Canvas
Войдите в Canvas под учетной записью администратора. Перейдите в Admin (в левой боковой панели) > выберите свою учетную запись > Developer Keys.
Создайте LTI-ключ разработчика
Нажмите + Ключ разработчика и выберите LTI-ключ.
В форме конфигурации:
- В поле URI перенаправления (слева) вставьте Launch URL со страницы настройки FastComments.
- Справа установите Метод в значение Ввести URL.
- Вставьте URL конфигурации, который вы скопировали из FastComments, в поле JSON URL.
- Canvas автоматически загрузит конфигурацию LTI.
- Дайте ключу имя (например, "FastComments").
- Нажмите Сохранить.
Включите ключ разработчика
После сохранения новый ключ появится в таблице Developer Keys со значением Состояние = OFF. Переключите тумблер, чтобы установить ON. Canvas может запросить подтверждение — нажмите Разрешить, чтобы включить ключ.
Скопируйте Client ID
В таблице Developer Keys в столбце Details отображается числовой Client ID (например, 17000000000042). Скопируйте это число — оно понадобится вам на следующем шаге.
Завершить подключение
Введите Client ID в FastComments
Вернитесь на страницу конфигурации LTI в FastComments. Мастер должен быть на Шаге 2: Подключение.
Вставьте Client ID, скопированный из Canvas, в поле Client ID. При необходимости введите Deployment ID, если ваша LMS его предоставляет.
Нажмите Save & Continue.
Включите интеграцию
Мастер перейдёт к Шагу 3: Запуск. Будет показана сводка вашей конфигурации (название, URL платформы, Client ID и Deployment ID).
Проверьте данные, затем нажмите Enable Integration, чтобы активировать LTI-подключение.
После включения мастер покажет Management View, где вы сможете изменить конфигурацию, просмотреть все LTI URL или добавить дополнительные развёртывания.
Установите внешнее приложение в Canvas
В Canvas перейдите в Admin > выберите ваш аккаунт > Settings > вкладка Apps.
Нажмите + App и настройте:
- Установите Configuration Type на By Client ID.
- Вставьте Client ID из таблицы Developer Keys.
- Нажмите Submit.
- Подтвердите установку при появлении запроса.
FastComments теперь установлен на уровне аккаунта и доступен для всех курсов.
Добавить в курс
Как комментарии отображаются в ваших курсах
После включения интеграции LTI и установки внешнего приложения FastComments работает автоматически на основе настроенных вами размещений:
Просмотр задания
Если размещение Assignment View включено, комментарии автоматически появляются под каждым заданием в курсе. Студенты и преподаватели видят ветвящийся раздел комментариев при просмотре задания — дополнительная настройка для каждого задания не требуется.
Каждое задание получает собственный отдельный тред комментариев.
Кнопка в редакторе форматированного контента
Если размещение Editor Button включено, преподаватели могут встраивать FastComments в любой контент, использующий редактор форматированного контента (Rich Content Editor):
- Отредактируйте Страницу, Тест или Объявление.
- На панели инструментов редактора форматированного контента нажмите кнопку FastComments.
- FastComments автоматически встраивается в контент.
- Сохраните страницу.
Когда студенты просматривают страницу, встроенный виджет FastComments загружается с тредом комментариев, уникальным для этой страницы.
Автоматический SSO
В обоих размещениях студенты автоматически входят через свою учётную запись Canvas. Имена, адреса электронной почты и аватары синхронизируются через LTI-запуск, отдельный вход не требуется.
Ограничение публичного доступа (рекомендуется)
По умолчанию данные комментариев FastComments доступны для публичного чтения. Любой, кто угадает URL треда или API-эндпоинт, может просмотреть его комментарии даже вне Canvas. Для обсуждений в курсах вы почти наверняка захотите ограничить просмотр только зачисленными студентами.
Откройте свою страницу настройки виджета и создайте правило с включённой опцией Require SSO To View Comments, затем установите уровень безопасности на Secure SSO, чтобы треды можно было загружать только через подписанный LTI-запуск.
Полное руководство см. в разделе Защита тредов комментариев с помощью Single-Sign-On, включая то, как ограничить действие правила одним доменом или страницей.
Стили комментирования
FastComments добавляет древовидные комментарии в ваши курсы Canvas. Стандартный виджет FastComments отображается на странице. Пользователи могут публиковать древовидные комментарии, отвечать, голосовать и пользоваться всеми стандартными функциями.
Комментарии прикрепляются к каждой странице курса или ссылке на ресурс, поэтому обсуждения остаются организованными по странице, заданию или модулю.
Сопоставление ролей
Роли Canvas автоматически сопоставляются с ролями FastComments во время запуска LTI. Ручная настройка не требуется.
Сопоставление ролей
| Роль Canvas | Роль FastComments | Разрешения |
|---|---|---|
| Administrator | Admin | Full account access, manage all comments and settings |
| Instructor | Moderator | Edit and delete comments, pin threads, manage discussions |
| Learner | Commenter | Post comments, reply, vote, and use mentions |
Как это работает
Когда пользователь запускает FastComments из Canvas, протокол LTI 1.3 передаёт его роль Canvas. FastComments считывает эту роль и автоматически назначает соответствующие разрешения.
Если у пользователя несколько ролей (например, an Instructor who is also an Admin), используется роль с наивысшими привилегиями.
Кастомизация
FastComments разработан таким образом, чтобы его можно было настроить в соответствии с вашим сайтом.
Если вы хотите добавить собственные стили или изменить конфигурацию, Ознакомьтесь с нашей документацией по настройке и конфигурации, чтобы узнать, как.
Ошибки домена
Вы можете получить ошибку авторизации, похожую на следующую:
Это происходит потому, что FastComments не знает, что использование вашего аккаунта на этом домене должно быть разрешено.
В этом случае решение простое. Вам нужно лишь добавить домен вашей инстанции Canvas в ваш аккаунт FastComments.
Перейдите сюда, чтобы добавить сайт в ваш аккаунт.
Добавьте домен вашей инстанции Canvas (например, yourschool.instructure.com) и комментарии должны загружаться корректно.
Добавить опросы в ваш курс Canvas
Как только FastComments будет добавлен в ваш курс Canvas, вы также сможете проводить живые опросы прямо в комментариях. Включите Enable Polls в настройках настройки виджета, и кнопка опроса появится на панели инструментов комментариев. Опросы поддерживают от 2 до 10 вариантов, результаты обновляются в реальном времени для всех на странице, и вы выбираете, кто может создавать опросы и требуется ли вход в систему для голосования. Больше ничего устанавливать в Canvas не нужно.
Попробуйте демо живых опросов или прочитайте Документацию по опросам, чтобы настроить их.