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 (например
https://yourschool.instructure.com). Выберите, какие Placements включить (Assignment View и/или Editor Button — по умолчанию оба включены). Нажмите 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
Go to ваша конфигурация FastComments LTI.
Страница настройки использует пошаговый мастер, который проведёт вас через каждый этап. Вы начнёте с Step 1: Create.
Create a New LTI Configuration
Заполните следующие поля:
- Configuration Name - необязательная метка для идентификации этой конфигурации (полезно, если вы подключаете несколько экземпляров Canvas).
- Platform URL - URL вашего экземпляра Canvas (например
https://yourschool.instructure.com). Это поле обязательно.
Choose Placements
Ниже поля Platform URL вы можете выбрать, где FastComments будет отображаться в ваших курсах Canvas. Оба варианта размещения включены по умолчанию:
- Assignment View - комментарии появляются автоматически под заданиями.
- Rich Content Editor Button - преподаватели могут встраивать FastComments в страницы, тесты и объявления, используя кнопку на панели инструментов в Редакторе богатого содержания.
Вы можете включить один или оба варианта. Должен быть включен хотя бы один вариант размещения.
Click Create Configuration.
Copy the Configuration URL
После создания конфигурации мастер переходит к Step 2: Connect. В верхней части страницы отображается заметный Configuration URL с кнопкой Copy.
Скопируйте этот URL. Он вам понадобится на следующем шаге для создания Developer Key в Canvas.
На странице также показаны пронумерованные инструкции о том, что делать в Canvas, а также поля для ввода Client ID и необязательного Deployment ID, когда они у вас появятся.
Ключ разработчика Canvas
Open Developer Keys in Canvas
Войдите в Canvas под учетной записью администратора. Перейдите в Admin (в левой боковой панели) > выберите свой аккаунт > Developer Keys.
Create an LTI Developer Key
Нажмите + Developer Key и выберите LTI Key.
В форме конфигурации:
- В поле Redirect URIs (слева) вставьте Launch URL со страницы настройки FastComments.
- Справа установите Method в Enter URL.
- Вставьте Configuration URL, который вы скопировали из FastComments, в поле JSON URL.
- Canvas автоматически загрузит конфигурацию LTI.
- Дайте ключу имя (например "FastComments").
- Нажмите Save.
Enable the Developer Key
После сохранения новый ключ появится в таблице Developer Keys со статусом State, установленным в OFF. Нажмите переключатель, чтобы установить его в ON. Canvas может запросить подтверждение — нажмите Allow, чтобы включить ключ.
Copy the Client ID
В таблице Developer Keys в колонке Details отображается числовой Client ID (например 17000000000042). Скопируйте это число — оно понадобится вам на следующем шаге.
Завершение подключения
Введите Client ID в FastComments
Вернитесь на вашу конфигурацию FastComments LTI. Мастер должен быть на Шаг 2: Подключение.
Вставьте Client ID, который вы скопировали из Canvas, в поле Client ID. По желанию укажите Deployment ID, если ваша LMS предоставляет его.
Нажмите Сохранить и продолжить.
Активируйте интеграцию
Мастер переходит к Шаг 3: Запуск. Отображается сводка вашей конфигурации (имя, URL платформы, Client ID и Deployment ID).
Проверьте данные, затем нажмите Включить интеграцию, чтобы активировать LTI-подключение.
После включения мастер покажет Панель управления, где вы можете редактировать конфигурацию, просматривать все LTI URL или добавлять дополнительные деплойменты.
Установите внешнее приложение в Canvas
В Canvas перейдите в Админ > выберите ваш аккаунт > Настройки > вкладка Приложения.
Нажмите + App и настройте:
- Установите Configuration Type на By Client ID.
- Вставьте Client ID из таблицы Developer Keys.
- Нажмите Отправить.
- Подтвердите установку, когда появится запрос.
FastComments теперь установлен на уровне аккаунта и доступен во всех курсах.
Добавить в курс
Как комментарии отображаются в ваших курсах
После включения интеграции LTI и установки Внешнего приложения FastComments автоматически работает согласно размещениям, которые вы настроили:
Просмотр задания
Если размещение Просмотр задания включено, комментарии автоматически появляются под каждым заданием в курсе. Студенты и преподаватели видят ветвящуюся секцию комментариев при просмотре задания — дополнительная настройка для каждого задания не требуется.
У каждого задания своя отдельная ветка комментариев.
Кнопка редактора богатого контента
Если размещение Кнопка редактора включено, преподаватели могут встроить FastComments в любое содержимое, которое использует Редактор богатого контента:
- Отредактируйте Страницу, Тест или Объявление.
- На панели инструментов Редактора богатого контента нажмите кнопку FastComments.
- FastComments автоматически встраивается в содержимое.
- Сохраните страницу.
Когда студенты просматривают страницу, встроенный виджет FastComments загружается с веткой комментариев, уникальной для этой страницы.
Автоматический SSO
В обоих размещениях студенты автоматически входят через свою учётную запись Canvas. Имена, адреса электронной почты и аватары синхронизируются через запуск LTI — отдельный вход не требуется.
Стили комментирования
FastComments добавляет древовидные комментарии в ваши курсы Canvas. Стандартный виджет FastComments появляется на странице. Пользователи могут размещать древовидные комментарии, отвечать, голосовать и использовать все стандартные функции.
Комментарии привязываются к каждой странице курса или ссылке на ресурс, поэтому обсуждения остаются упорядоченными по странице, заданию или модулю.
Сопоставление ролей
Роли Canvas автоматически сопоставляются с ролями FastComments во время запуска LTI. Ручная настройка не требуется.
Сопоставление ролей
| Роль Canvas | Роль FastComments | Разрешения |
|---|---|---|
| Administrator | Admin | Полный доступ к аккаунту, управление всеми комментариями и настройками |
| Instructor | Moderator | Редактирование и удаление комментариев, закрепление веток, управление обсуждениями |
| Learner | Commenter | Публикация комментариев, ответы, голосование и использование упоминаний |
Как это работает
Когда пользователь запускает FastComments из Canvas, протокол LTI 1.3 передаёт его роль Canvas. FastComments считывает эту роль и автоматически назначает соответствующие права.
Если у пользователя несколько ролей (например, Instructor, который также является Admin), используется роль с наивысшими привилегиями.
Персонализация
FastComments разработан так, чтобы его можно было настроить под ваш сайт.
Если вы хотите добавить собственные стили или изменить конфигурацию, Ознакомьтесь с нашей документацией по настройке и конфигурации, чтобы узнать, как.
Ошибки домена
Вы можете получить ошибку авторизации, похожую на следующую:
Это происходит потому, что FastComments не знает, что ваш аккаунт должен быть разрешён для использования на этом домене.
В этом случае решение простое. Вам нужно добавить домен вашего экземпляра Canvas в аккаунт FastComments.
Перейдите сюда, чтобы добавить сайт в ваш аккаунт.
Добавьте домен вашего Canvas (e.g. yourschool.instructure.com) и комментарии должны загружаться корректно.