Add Comments to Your LMS via LTI 1.3

1. Войдите в FastComments и перейдите на вашу страницу конфигурации LTI 1.3.
2. (Необязательно) Выберите платформу, с которой вы подключаетесь, в выпадающем списке Платформа — это задаёт отображаемую метку, но Автоопределение работает нормально.
3. Нажмите Сгенерировать URL. Появится одноразовый Регистрационный URL (действителен 30 минут, одноразовый).
4. В вашей LMS откройте экран динамической регистрации LTI 1.3 и вставьте URL в поле Конечная точка регистрации инициации инструмента (или эквивалентное). Отправьте.
5. Ваша LMS обращается к FastComments, обменивается ключами и создаёт интеграцию. Всплывающее окно закрывается автоматически после завершения.
6. Вернувшись в FastComments, новая конфигурация появится в таблице Существующие конфигурации. Инструмент теперь доступен в курсах вашей LMS.

FastComments LTI 1.3 был протестирован на:

• D2L Brightspace (любая версия с LTI Advantage)
• Moodle 4.0+ (External Tool plugin, LTI Advantage)
• Blackboard Learn (SaaS and Ultra)
• Sakai (версии с поддержкой LTI Advantage)
• Schoology (Enterprise, Dynamic Registration где доступно)

Любая другая LMS, реализующая спецификацию IMS LTI 1.3 Advantage с поддержкой Dynamic Registration, также должна работать — выберите Other LTI 1.3 platform в выпадающем списке платформ при генерации вашего URL регистрации (получить её здесь).

Canvas LMS использует другой процесс настройки (per-developer-key configuration JSON вместо Dynamic Registration). См. специальное руководство по установке Canvas LMS.

Перейдите к конфигурации LTI 1.3

Войдите в FastComments и перейдите на вашу страницу конфигурации LTI 1.3.

Если в вашем аккаунте ещё нет доступа LTI, вы увидите "LTI not enabled for this account" - свяжитесь со службой поддержки, чтобы включить его в вашем тарифном плане.

Выберите платформу (необязательно)

В разделе Генерация динамического URL регистрации, используйте выпадающий список Platform, чтобы указать FastComments, к какому LMS вы подключаетесь:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Другая платформа LTI 1.3

Вы также можете оставить его в положении Автоопределение. Платформа считывается из openid-configuration вашего LMS во время регистрации; выпадающий список только задаёт метку отображения для полученной конфигурации.

Сгенерируйте URL

Нажмите Сгенерировать URL. FastComments создаёт одноразовый регистрационный токен и показывает вам URL, похожий на:

https://fastcomments.com/lti/v1p3/register/<long-token>

Скопируйте его. Этот URL:

• Является одноразовым - после того, как ваш LMS успешно вызовет его, токен будет использован.
• Истекает через 30 минут, если не будет использован.
• Должен храниться в секрете - любой, у кого есть URL, может зарегистрировать инструмент в вашем тенанте в течение этих 30 минут.

Существующие конфигурации

После успешного завершения регистрации новая конфигурация появится в таблице Existing Configurations на той же странице, с её Platform, Issuer, Client ID и Status. Вы можете удалить конфигурации из этой таблицы, если вам когда-либо потребуется отменить регистрацию.

D2L Brightspace предоставляет динамическую регистрацию через административный интерфейс LTI Advantage. Вам потребуется доступ администратора.

Откройте экран регистрации

1. Войдите в ваш экземпляр Brightspace под учётной записью администратора.
2. Перейдите в Admin Tools > Manage Extensibility > LTI Advantage.
3. Нажмите Register Tool. (Прямая ссылка: https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Вставьте URL

Вы увидите форму регистрации. Ключевым полем является Tool initiation registration endpoint (в некоторых версиях Brightspace это поле называется "Tool Initiation Registration URL").

Вставьте URL регистрации FastComments (получите его здесь) в это поле. Оставьте остальные поля пустыми — они будут автоматически заполнены FastComments во время обмена регистрационными данными.

Нажмите Зарегистрировать.

Одобрите инструмент

Brightspace откроет всплывающее окно, которое свяжется с FastComments, обменяется ключами и отобразит экран подтверждения. Всплывающее окно закроется автоматически после завершения регистрации.

Новый инструмент появится в списке инструментов LTI Advantage. По умолчанию Brightspace помечает новые инструменты как отключённые — переведите переключатель в положение включено, чтобы ваши курсы могли им пользоваться.

Добавьте развертывание

В Brightspace LTI-инструменту требуется deployment перед его использованием в курсах:

1. Откройте только что зарегистрированный инструмент FastComments.
2. Нажмите View Deployments > New Deployment.
3. Дайте развертыванию имя (например, "FastComments - Все курсы"), выберите организационные единицы, в которых оно должно быть доступно, и сохраните.

После первого запуска через это развертывание FastComments зафиксирует deployment_id в своей записи конфигурации — последующие запуски из другого развертывания под тем же клиентом будут отклонены, если вы не зарегистрируете снова.

Используете Moodle? Мы также публикуем специальный плагин Moodle для FastComments с более тесной интеграцией, чем LTI 1.3 (хуки синхронизации оценок, более глубокая отчетность по активностям, родной интерфейс настроек Moodle). См. Руководство по установке плагина Moodle. Показанный ниже поток LTI 1.3 подходит, если вы хотите одну регистрацию, которая также охватывает другие LMS, или если ваш администратор Moodle не будет устанавливать сторонние плагины.

Moodle 4.0+ поддерживает динамическую регистрацию LTI 1.3 через плагин External Tool.

Откройте экран управления инструментами

1. Войдите в Moodle как администратор сайта.
2. Перейдите в Site administration > Plugins > Activity modules > External tool > Manage tools.

Вставьте URL

Вы увидите карточку с надписью Tool URL. Вставьте URL регистрации FastComments (получить её здесь) в текстовое поле и нажмите Add LTI Advantage.

Moodle откроет экран регистрации, показывающий идентификацию инструмента и запрашиваемые разрешения. Проверьте их и нажмите Activate (или Register, в зависимости от версии Moodle).

Всплывающее окно закроется после завершения регистрации; новый инструмент FastComments появится в списке Tools со статусом Active.

Сделать его доступным

По умолчанию Moodle добавляет новые инструменты в список "Course tools", но не показывает их в выборе активности. Чтобы сделать FastComments доступным на уровне курса:

1. Нажмите значок шестерёнки на плитке FastComments.
2. В разделе Tool configuration usage выберите Show in activity chooser and as a preconfigured tool.
3. Сохраните.

Преподаватели теперь могут добавлять FastComments в любой курс через Add an activity or resource > FastComments.

Blackboard Learn SaaS и Ultra поддерживают динамическую регистрацию LTI 1.3.

Откройте экран поставщика инструментов

1. Войдите в Blackboard как системный администратор.
2. Перейдите в Administrator Panel > Integrations > LTI Tool Providers.
3. Нажмите Register LTI 1.3 / LTI Advantage Tool.

Если вы видите только "Register LTI 1.1 Provider", ваша версия Blackboard ещё не поддерживает LTI 1.3 — обновите систему или обратитесь в службу поддержки Blackboard.

Вставьте URL

Вставьте URL регистрации FastComments (получить её здесь) в поле Client ID / Registration URL (названия полей в Blackboard различаются в зависимости от версии). Нажмите Submit.

Blackboard выполняет обмен регистрационными данными с FastComments и показывает экран подтверждения.

Одобрите и включите

Blackboard помечает вновь зарегистрированные инструменты как Approved but excluded по умолчанию:

1. Найдите запись FastComments в списке поставщиков инструментов.
2. Откройте меню и выберите Edit.
3. Установите для Tool Status значение Approved.
4. В разделе Institution Policies проверьте, какие данные пользователя отправляются (имя, электронная почта, роль). Сохраните.

Инструмент теперь доступен преподавателям при добавлении ими контента в курсы.

Sakai

Sakai поддерживает динамическую регистрацию LTI 1.3 в релизах с LTI Advantage. Из Administration Workspace:

1. Войдите как администратор Sakai и откройте Administration Workspace.
2. Выберите External Tools > Install LTI 1.3 Tool.
3. Вставьте URL регистрации FastComments (получить его здесь) и отправьте.
4. Одобрите инструмент после завершения рукопожатия.

Инструмент затем появляется в разделе External Tools и может быть добавлен администраторами сайтов.

Schoology

Инстансы Schoology Enterprise поддерживают LTI 1.3, но доступность Dynamic Registration варьируется в зависимости от развертывания. Свяжитесь с вашим менеджером аккаунта Schoology.

Если Dynamic Registration недоступна в вашем экземпляре Schoology, вам нужно будет настроить интеграцию вручную, используя эти конечные точки:

• OIDC Login URL: https://fastcomments.com/lti/v1p3/login
• Target Link URL: https://fastcomments.com/lti/v1p3/launch
• Public Keyset URL (JWKS): https://fastcomments.com/lti/v1p3/jwks
• Redirect URLs: https://fastcomments.com/lti/v1p3/launch

После того как Schoology предоставит вам Client ID и Deployment ID, свяжитесь со службой поддержки FastComments, чтобы зарегистрировать конфигурацию на вашем tenant.

Other LTI 1.3 Platforms

Любая LMS, соответствующая спецификации IMS LTI 1.3 Advantage, должна работать с тем же URL регистрации (получить его здесь). Ищите настройку с пометкой "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint" или похожую.

Если ваша платформа поддерживает только ручную настройку LTI 1.3, используйте четыре конечные точки, перечисленные в разделе Schoology выше, и свяжитесь со службой поддержки для завершения настройки.

Эта страница описывает добавление FastComments в курс Brightspace после того, как администратор зарегистрировал инструмент и создал deployment. Если инструмент ещё не зарегистрирован, сначала смотрите руководство по регистрации D2L.

FastComments embedded as a unit topic in Brightspace

Brightspace поставляется с двумя способами создания контента: Classic Content и New Content Experience (также называемая Lessons). Оба поддерживают FastComments, но пути в меню различаются. Каждая секция ниже охватывает оба варианта там, где они расходятся.

Locate the FastComments Tool

Инструмент FastComments появляется в двух местах внутри редактора содержимого курса:

1. В activity picker, доступном через кнопку Add Existing модуля/юнита (в старых версиях Brightspace помечена как Add Existing Activities). В текущих сборках FastComments отображается непосредственно в picker; в старых версиях он находится в подменю External Learning Tools. Любой из путей добавляет FastComments как отдельную тему.
2. В диалоге Insert Stuff внутри HTML-редактора, в разделе LTI Advantage. Это встраивает FastComments внутри HTML-темы через LTI deep linking flow.

Если FastComments не появляется ни в одном picker, deployment не включён для org unit, в котором находится курс. Попросите администратора Brightspace открыть Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments, открыть deployment и добавить org unit курса (или родительский org unit) в раздел Org Units.

Add FastComments as a Topic in a Module

Classic Content:

1. Откройте курс и нажмите Content в навигационной панели.
2. Выберите модуль, который должен содержать обсуждение (или создайте его через Add a module).
3. Нажмите Add Existing (в старых версиях Brightspace: Add Existing Activities > External Learning Tools).
4. В picker нажмите FastComments. Brightspace создаст тему в модуле и вернёт вас в просмотр содержимого.
5. Нажмите новую тему. Переименуйте её в что-то описательное, например FastComments Discussion с помощью inline title editor.

New Content Experience (Lessons):

1. Откройте курс и нажмите Content.
2. Откройте unit и lesson, которые должны содержать обсуждение.
3. Нажмите Add > Existing Activity и выберите FastComments (в старых версиях Brightspace: вложено в External Learning Tools).
4. Активность будет добавлена в lesson.
5. Нажмите название активности, чтобы переименовать её.

Впервые, когда любой пользователь (инструктор или студент) откроет тему, FastComments инициализирует thread для этой resource link. Thread привязан к resource link ID, поэтому переименование или перемещение темы не меняет загружаемый thread.

Embed FastComments Inline in an HTML Topic

Используйте этот поток, когда вы хотите, чтобы комментарии отображались под текстом, видео или другим содержимым внутри той же страницы темы, а не как отдельная тема.

1. Откройте или создайте HTML-тему в модуле/lesson.
2. Нажмите Edit HTML, чтобы открыть HTML-редактор Brightspace.
3. Поместите курсор в то место, где должен появиться поток комментариев.
4. Нажмите кнопку Insert Stuff (иконка паззла в панели редактора).
5. В диалоге Insert Stuff пролистайте до LTI Advantage и нажмите FastComments.
6. FastComments откроет deep linking picker. Подтвердите размещение (опции по умолчанию подходят для обсуждений контента); нажмите Insert или Continue.
7. Brightspace вернётся в HTML-редактор с плейсхолдер-блоком, представляющим LTI launch. Нажмите Save and Close в теме.

Когда тема загружается, Brightspace заменяет плейсхолдер на iframe, который автоматически запускает FastComments через LTI. Студенты увидят поток обсуждения встроенным на странице.

Одна HTML-тема может содержать несколько deep-linked FastComments embed'ов. Каждый embed получает свой собственный thread, потому что каждая deep link создаёт уникальный resource link ID.

Module Topic vs Inline Quicklink

Выбирайте подход с module topic, когда:

• Обсуждение является основной активностью на этом шаге модуля.
• Вы хотите, чтобы тема отображалась в оглавлении Brightspace, в отслеживании выполнения и в Class Progress.

Выбирайте подход с inline embed, когда:

• Комментарии должны располагаться под другим контентом на той же странице.
• Вы не хотите отдельный элемент, отслеживаемый для выполнения, в оглавлении.

Visibility, Draft, and Release Conditions

Новая тема FastComments по умолчанию видна студентам. Чтобы скрыть её пока вы настраиваете:

1. В редакторе контента нажмите название темы (Classic) или меню с тремя точками на активности (New Content Experience).
2. Установите статус Draft (Classic) или выключите Visibility (New Content Experience).

Draft-темы невидимы студентам. Инструкторы и TA по-прежнему видят их с бейджем "Draft".

Чтобы ограничить тему для определённой группы или секции:

1. Откройте тему.
2. Нажмите меню названия темы > Edit Properties In-place (Classic) или Edit > Restrictions (New Content Experience).
3. В разделе Release Conditions нажмите Create.
4. Выберите Group enrollment или Section enrollment, выберите группу/секцию и сохраните.

Условия выпуска работают вместе с собственной системой сопоставления ролей FastComments. Студенты, которые не видят тему, не получают LTI launch.

What Students See on First Launch

Когда студент нажимает тему (или загружает HTML-тему с embed):

1. Brightspace выполняет LTI 1.3 launch в фоне.
2. FastComments получает имя студента, email, URL аватара и роль LMS и автоматически авторизует их. Запроса на вход в FastComments не будет.
3. Поток комментариев для этого resource link отображается внутри Brightspace iframe.

Сопоставление ролей при запуске:

• Brightspace Administrator становится в FastComments администратором (admin) для thread (полный доступ к модерации, удалению, бану и настройкам).
• Brightspace Instructor становится в FastComments модератором (moderator) (pin, hide, delete, ban).
• Все остальные роли (Learner, TeachingAssistant, и т. д.) становятся стандартными комментаторами.

Комментарии приписываются к учётной записи студента в Brightspace. Если студент изменит своё имя или аватар в Brightspace, при следующем LTI launch изменения синхронизируются.

Iframe Height and Resize

FastComments отправляет postMessage org.imsglobal.lti.frameResize при каждом рендере thread и при изменениях контента (новый комментарий, разворачивание ответов). Brightspace слушает это сообщение и регулирует высоту iframe, чтобы поток не обрезался и внутри не появлялась полоса прокрутки.

Если iframe остаётся фиксированной маленькой высоты:

• Убедитесь, что курс загружается по HTTPS. Слушатель postMessage Brightspace отклоняет фреймы с mixed-content.
• Убедитесь, что никакое расширение браузера не блокирует канал postMessage.
• Для inline embed в HTML-теме окружающая HTML-разметка не должна оборачивать iframe в контейнер с фиксированной высотой. Уберите любой inline style="height: ..." у родительского элемента.

Brightspace-Specific Gotchas

Tool not showing in the Add Existing picker. Deployment не включён для org unit этого курса. Администратору нужно добавить org unit (или родительский) в список Org Units деплоя. Регистрация инструмента сама по себе недостаточна; scope deployment определяет, в каких курсах инструмент видим.

deployment_id mismatch on launch. FastComments использует TOFU и фиксирует первый deployment_id, который он увидел при регистрации. Если администратор удаляет исходный deployment и создаёт новый, запуски из нового deployment отклоняются с ошибкой несовпадения deployment. Решение — перерегистрировать FastComments (сгенерировать новый registration URL (get it here) и снова выполнить Dynamic Registration); старая запись конфигурации будет заменена.

Tool launches but shows "Invalid LTI launch". Курс находится в другой структуре tenant/org, чем покрывает deployment, или deployment был отключён после регистрации. Проверьте Admin Tools > Manage Extensibility > LTI Advantage > FastComments > переключатель Enabled и список org unit в deployment.

Names and roles missing inside FastComments. Brightspace отправляет LTI-запуски с Names and Role Provisioning Services (NRPS) claims. Если курс был обновлён из старой LTI 1.1 ссылки, в launch отсутствуют name и email claims. Пере-добавьте тему FastComments через Add Existing (не мигрируйте старую ссылку), чтобы запуск использовал LTI 1.3.

Embed shows a login screen instead of auto-SSO. HTML-тема была вставлена как обычный <iframe>, указывающий на FastComments, а не через Insert Stuff > LTI Advantage. Обычные iframe пропускают LTI launch и попадают пользователей на публичную страницу FastComments. Удалите iframe и вставьте заново через поток Insert Stuff.

После того как администратор зарегистрировал FastComments как LTI 1.3 Advantage инструмент и утвердил политики учреждения, преподаватели добавляют его в курсы через стандартные точки размещения Blackboard. Конкретные шаги различаются для Ultra Course View и Original Course View, поэтому ниже приведены инструкции для обоих.

Ultra Course View

Ultra Course View является настройкой по умолчанию в Blackboard Learn SaaS с 2026 года.

1. Откройте курс и перейдите на страницу Course Content.
2. Наведите указатель или коснитесь места в оглавлении, куда вы хотите вставить поток комментариев, и нажмите фиолетовую кнопку + (Add content).
3. Выберите Content Market. Панель Content Market перечисляет все утверждённые инструменты LTI и размещения Building Block для вашего учреждения.
4. Найдите плитку FastComments и нажмите её. Blackboard создаст элемент контента в позиции, где вы открыли меню +.
5. По умолчанию элемент появляется в оглавлении как запись «Visible to students» для преподавателей, у которых личная настройка Hide from students отключена. Если у вас по умолчанию стоит Hidden, элемент будет создан скрытым, и вы включите переключатель видимости в строке элемента, когда будете готовы.
6. Чтобы переименовать элемент, нажмите заголовок в оглавлении и введите новую метку. Заголовок, который видят студенты в оглавлении, независим от идентификатора потока FastComments, поэтому переименование безопасно в любой момент.

Если вы не видите Content Market в списке, в вашем учреждении размещение скрыто. Тот же выборщик доступен через More tools в том же меню + в группе LTI Tools.

Original Course View

Original Course View по‑прежнему поддерживается в Learn SaaS и остаётся основным опытом для самохостинговых сайтов Learn 9.1 на ветке релизов Q4 2024 CU.

1. Откройте курс и войдите в Content Area (например, в стандартную область Information или Content в меню курса).
2. Включите Edit Mode с помощью переключателя в правом верхнем углу страницы.
3. Нажмите Build Content в панели действий.
4. В подменю Learning Tools нажмите FastComments. Подменю Learning Tools заполняется размещениями инструментов LTI 1.3 после того, как администратор зарегистрирует инструмент. Если вы не видите его, см. раздел с возможными проблемами ниже.
5. На форме Create FastComments задайте:
   • Name: метка, которую видят студенты в области контента.
   • Description: необязательный текст, отображаемый над встроенным потоком.
   • Permit Users to View this Content: переключатель доступности Да/Нет.
   • Track Number of Views: включите, если хотите видеть статистику просмотров по элементу в Blackboard. FastComments ведёт собственную аналитику независимо.
   • Date and Time Restrictions: необязательные окна Display After / Display Until.
6. Отправьте форму. Инструмент появится как кликабельный элемент в области контента.

Embedding Inside an Item or Document

В обоих представлениях курса преподаватели встраивают FastComments прямо в тело Item, Document или любое поле с расширенным текстом через кнопку LTI Advantage в Content Editor.

Ultra Course View:

1. Создайте или отредактируйте Document.
2. Нажмите Add content в теле документа в том месте, где вы хотите разместить поток.
3. В панели инструментов редактора откройте меню Insert content и нажмите Content Market (точка входа LTI Advantage / Deep Linking).
4. Выберите FastComments. FastComments возвращает deep-link полезную нагрузку, и Blackboard вставляет встроенный блок в тело документа в позиции курсора.
5. Сохраните документ. Студенты увидят поток встроенным по мере прокрутки страницы.

Original Course View:

1. Отредактируйте любой элемент с телом в формате rich-text.
2. В панели инструментов Content Editor нажмите значок плюса Add Content и выберите Content Market (в старых Q4 2024 CU помечается как Add Content from External Tool).
3. Выберите FastComments. Редактор вставит заполнительный блок, ссылающийся на ресурс, добавленный через deep link.
4. Отправьте элемент.

Каждое deep-link встраивание создаёт собственный поток FastComments, поэтому элемент с двумя встроенными блоками FastComments содержит два независимых потока комментариев.

Visibility, Release Conditions, and Group Restrictions

Элементы контента FastComments ведут себя как любые другие элементы контента Blackboard в отношении правил контроля доступа, применяемых к ним.

• Ultra: нажмите селектор видимости в строке ( Visible to students, Hidden from students, Conditional availability ). Conditional availability поддерживает окна даты/времени, правила производительности относительно элементов gradebook и правила участников относительно групп курса.
• Original: откройте контекстное меню элемента и выберите Adaptive Release или Adaptive Release: Advanced, чтобы ограничить доступ по дате, членству, оценке или статусу проверки. Используйте Set Group Availability для ограничения доступа к конкретным группам курса.

FastComments уважает решение Blackboard о доступе. Если Blackboard скрывает элемент от студента, LTI‑запуск для этого студента не выполняется, и он не появляется в представлении модератора.

Gradebook Behavior

FastComments не отправляет оценки обратно через LTI Advantage Assignment and Grade Services. Для элементов контента FastComments не создаётся автоматический столбец с оценками.

Если в вашей аренде Blackboard настроено автоматическое создание столбца в журнале оценок для каждого нового элемента контента независимо от метаданных оценки, пустой столбец появится в любом случае. Чтобы скрыть его:

• Ultra: откройте Gradebook, нажмите заголовок столбца, выберите Edit и отключите Show to students и Include in calculations. Или используйте Delete, если в вашем учреждении разрешено удалять столбцы для нефруктируемых элементов.
• Original: откройте Grade Center, нажмите шеврон столбца, выберите Hide from Users (on/off) и при необходимости Hide from Instructor View в разделе Column Organization.

What Students See

Когда студент открывает элемент FastComments или прокручивает до встроенного блока:

1. Blackboard отправляет LTI 1.3 сообщение в FastComments. Студент автоматически входит через SSO с использованием своей учётной записи Blackboard (имя, email, аватар, роль) без показа формы входа.
2. Поток комментариев рендерится в iframe. Нитевание, ответы, упоминания и реакции доступны в зависимости от настроек виджета комментариев в FastComments.
3. Их комментарии атрибутируются их учётной записи Blackboard. Если студент позже отредактирует своё имя или фото в Blackboard, при следующем запуске профиль FastComments обновится.

Сопоставление ролей из Blackboard в FastComments:

• System Administrator и Course Builder сопоставляются с ролью FastComments admin.
• Instructor и Teaching Assistant сопоставляются с ролью FastComments moderator.
• Student, Guest и Observer сопоставляются с ролью FastComments commenter.

Модераторы видят элементы управления модерацией (pin, hide, ban, delete) в каждой записи потока.

Thread Scoping

FastComments ограничивает каждый поток по тройке (Blackboard host, course ID, resource link ID). Два элемента FastComments в одном курсе создают два потока. Тот же элемент, скопированный в две оболочки курсов (например, при копировании курса), создаёт два потока, поскольку Blackboard выдаёт новый resource link ID при копировании. Чтобы сохранить общий поток при копировании курса, используйте Deep Linking с явным URN потока, настроенным в FastComments до выполнения копии.

Blackboard-Specific Gotchas

FastComments tile missing from the Build Content menu (Original) or Content Market (Ultra). Администратор утвердил инструмент, но оставил политику учреждения, блокирующую соответствующее размещение. Перейдите в Administrator Panel > Integrations > LTI Tool Providers, отредактируйте запись FastComments и подтвердите, что размещения Course Content Tool (Original) и Course Content Tool - allow students / Deep Linking content tool (Ultra) включены. Сохраните и обновите страницу курса.

"Tool not configured for this context" or "Tool is not deployed" error on launch. Область развертывания, зарегистрированная во время динамической регистрации, не соответствует контексту учреждения, к которому принадлежит курс. В записи поставщика инструментов Blackboard проверьте, что Deployment ID совпадает с тем, что FastComments показывает на странице LTI 1.3 Configuration для этого арендатора. Если они отличаются, удалите размещение и повторно запустите динамическую регистрацию с нового URL регистрации (получить его здесь).

Iframe height looks fixed or content gets cut off. У некоторых арендаторов Blackboard установлен строгий Content Security Policy, который блокирует стандартное изменение размера iframe через postMessage LTI. FastComments отправляет как сообщение типа Canvas lti.frameResize, так и сообщение в соответствии со спецификацией IMS org.imsglobal.lti.frameResize для максимальной совместимости, но переопределение CSP на уровне арендатора блокирует слушатель в родительском окне. Попросите вашего администратора подтвердить, что *.fastcomments.com включён в allowlist инструментов LTI и что никакой пользовательский заголовок CSP не удаляет события postMessage. После этого изменение размера заработает без дополнительной настройки.

Course copy duplicates threads. При копировании курса Blackboard выдаёт новые resource link ID для размещений LTI, поэтому скопированные курсы начинают с пустых потоков. Это ожидаемое поведение. Если вам нужно, чтобы скопированный курс унаследовал исходный поток, настройте Deep Linking с явным URN потока перед копированием или свяжитесь со службой поддержки FastComments для массового переназначения идентификаторов потоков.

Student sees a generic Blackboard error on launch. Причина — отсутствующее или устаревшее утверждение email. Подтвердите, что в политике учреждения для FastComments включены поля Role, Name, и Email Address в разделе User Fields to Send. Сохраните настройки, затем выполните запуск снова в новой сессии браузера.

"Токен регистрации не найден, истёк или уже использован"

Токен в вашем URL для регистрации (получить его здесь) действителен 30 минут и может быть использован только один раз. Если ваш LMS занял больше времени, или если регистрация была повторена после успешного выполнения, токен будет отклонён. Сгенерируйте новый URL на странице конфигурации FastComments LTI 1.3 и начните заново.

"Platform rejected registration"

Ваш LMS отказал в рукопожатии регистрации. Наиболее частые причины:

• Tool already registered with the same client name. Некоторые платформы (в частности D2L) отклоняют вторую регистрацию "FastComments", пока предыдущая не удалена. Удалите старый инструмент в вашем LMS, затем повторите попытку.
• Wrong field in the LMS. Убедитесь, что вы вставили URL в поле registration / tool initiation registration endpoint, а не в поле launch URL или login URL.
• The LMS doesn't actually support Dynamic Registration. Старые версии Moodle и Blackboard декларируют поддержку LTI 1.3, но позволяют только ручную настройку. Проверьте документацию вашей платформы.

"Failed to fetch platform configuration"

FastComments не смог прочитать документ openid-configuration вашего LMS. Это редкость и обычно означает, что LMS предоставил некорректный или недоступный discovery URL. Свяжитесь со службой поддержки вашего LMS.

Launch shows "Configuration not found"

Либо конфигурация в FastComments была удалена, либо запуск пришёл с пары iss/client_id, которую мы не распознаём. Если вы удалили и заново зарегистрировали, попросите ваш LMS удалить и снова добавить инструмент FastComments, чтобы он получил новый client_id.

Launch shows "Deployment not registered"

Вы запустили FastComments из развертывания Brightspace/Moodle/Blackboard, отличного от того, в котором он был запущен впервые. FastComments фиксирует deployment_id при первом запуске в качестве проверки безопасности. Чтобы добавить новое развертывание под тем же клиентом, свяжитесь со службой поддержки — мы добавим deployment ID в конфигурацию.

Launch shows "Unsupported message_type"

LMS отправила LTI-сообщение, которое FastComments не обрабатывает (например, LtiSubmissionReviewRequest). FastComments поддерживает только стандартный resource-link launch и потоки deep-linking. Обратитесь к нам, если нужно добавить поддержку конкретного типа сообщения.

Iframe doesn't resize

Большинство LMS автоматически подстраивают размер LTI iframe. Если ваш этого не делает, проверьте, позволяют ли настройки запуска LMS инструменту отправлять события postMessage в родительский фрейм. FastComments посылает сообщения изменения размера как в формате Canvas (lti.frameResize), так и в спецификации IMS (org.imsglobal.lti.frameResize).