Add Comments to Canvas LMS via 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
Перейдите на вашу конфигурацию 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 на страницах, в викторинах и объявлениях с помощью кнопки на панели инструментов Rich Content Editor.
Вы можете включить один или оба варианта. Должен быть включён хотя бы один вариант размещения.
Нажмите Create Configuration.
Copy the Configuration URL
После создания конфигурации мастер перейдёт к Step 2: Connect. Вверху страницы отображается заметный Configuration 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
Вернитесь к your FastComments LTI Config. Мастер должен быть на Step 2: Connect.
Вставьте Client ID, который вы скопировали из Canvas, в поле Client ID. При желании введите Deployment ID, если ваша LMS предоставляет его.
Нажмите Save & Continue.
Enable the Integration
Мастер перейдёт к Step 3: Go Live. Отображается сводка вашей конфигурации (name, platform URL, Client ID, and deployment ID).
Просмотрите данные, затем нажмите Enable Integration, чтобы активировать LTI-подключение.
После включения мастер покажет Management View, где вы можете отредактировать конфигурацию, просмотреть все LTI URLs, или добавить дополнительные deployments.
Install the External App in Canvas
В Canvas перейдите в Admin > выберите вашу учетную запись > Settings > вкладка Apps.
Нажмите + App и настройте:
- Установите Configuration Type в By Client ID.
- Вставьте Client ID из таблицы Developer Keys.
- Нажмите Submit.
- Подтвердите установку, когда появится запрос.
FastComments теперь установлена на уровне аккаунта и доступна во всех курсах.
Добавить в курс
Как комментарии отображаются в ваших курсах
После включения интеграции LTI и установки External App, FastComments работает автоматически на основе тех размещений, которые вы настроили:
Assignment View
Если включено размещение Assignment View, комментарии автоматически появляются под каждым заданием в курсе. Студенты и преподаватели видят древовидный раздел комментариев при просмотре задания — для каждого задания не требуется дополнительная настройка.
Каждое задание получает собственную отдельную ветку комментариев.
Rich Content Editor Button
Если включено размещение Editor Button, преподаватели могут встроить FastComments в любой контент, который использует Rich Content Editor:
- Редактируйте Page, Quiz, или Announcement.
- В панели инструментов Rich Content Editor нажмите кнопку FastComments.
- FastComments автоматически встраивается в содержимое.
- Сохраните страницу.
Когда студенты просматривают страницу, встроенный виджет FastComments загружается с веткой комментариев, уникальной для этой страницы.
Automatic SSO
В обоих размещениях студенты автоматически входят через свою учетную запись Canvas. Имена, адреса электронной почты и аватары синхронизируются через запуск LTI — отдельный вход не требуется.
Стили комментирования
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) и комментарии должны загружаться корректно.