Добавяне на коментари във вашия LMS чрез 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, LTI Advantage)
• Blackboard Learn (SaaS и Ultra)
• Sakai (версии с поддръжка на LTI Advantage)
• Schoology (Enterprise, Dynamic Registration, когато е налично)

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

Canvas LMS използва различен процес на настройка (JSON за конфигурация per-developer-key вместо Dynamic Registration). Вижте специалното ръководство за инсталиране на Canvas LMS.

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

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

Ако вашият акаунт все още няма достъп до LTI, ще видите "LTI not enabled for this account" - свържете се с поддръжката, за да го активират във вашия план.

Изберете платформа (по избор)

Под Генериране на динамичен URL за регистрация, използвайте падащото меню Платформа, за да кажете на FastComments кой LMS свързвате:

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

Можете също така да го оставите на Автоматично разпознаване. Платформата се прочита от вашия LMS's openid-configuration по време на регистрацията; падащото меню само задава етикета за показване за получената конфигурация.

Генериране на URL

Кликнете Генерирай URL. FastComments създава еднократен токен за регистрация и ви показва URL, което изглежда така:

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

Копирайте го. Този URL:

• Е за еднократна употреба - след като вашият LMS го извика успешно, токенът се изразходва.
• Изтича след 30 минути, ако не бъде използван.
• Трябва да се пази в тайна - всеки с този URL може да регистрира инструмент срещу вашия tenant през тези 30 минути.

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

След като регистрацията завърши успешно, новата конфигурация ще се появи в таблицата Съществуващи конфигурации на същата страница, с нейната Платформа, Issuer, Client ID и Статус. Можете да изтривате конфигурации от тази таблица, ако някога трябва да отмените регистрацията.

D2L Brightspace предлага Динамична регистрация чрез администраторския интерфейс LTI Advantage. Необходим е администраторски достъп.

Отворете екрана за регистрация

1. Влезте в инстанцията на Brightspace като администратор.
2. Отидете в Административни инструменти > Управление на разширяемостта > LTI Advantage.
3. Кликнете Регистриране на инструмент. (Директният URL е https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Поставете URL адреса

Ще видите регистрационна форма. Ключовото поле е Крайна точка за регистрация на иницииране на инструмента (в някои версии на Brightspace е означено като "URL за регистрация на иницииране на инструмента").

Поставете FastComments регистрационния URL (вземете го тук) в това поле. Оставете останалите полета празни - те се попълват автоматично от FastComments по време на регистрационния обмен.

Кликнете Регистрирай.

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

Brightspace отваря изскачащ прозорец, който комуникира с FastComments, разменя ключове и показва екран за потвърждение. Изскачащият прозорец се затваря автоматично, когато регистрацията приключи.

Новият инструмент се появява в списъка ви с инструменти за LTI Advantage. По подразбиране Brightspace маркира новите инструменти като деактивирано - превключете тумблера на активирано, за да могат вашите курсове да го използват.

Добавяне на внедряване

В Brightspace, LTI инструментите се нуждаят от внедряване, преди да могат да бъдат използвани в курсове:

1. Отворете току-що регистрирания FastComments инструмент.
2. Кликнете Преглед на внедряванията > Ново внедряване.
3. Дайте име на внедряването (напр. "FastComments - Всички курсове"), изберете организационните единици, в които трябва да бъде налично, и запазете.

След първото стартиране чрез това внедряване, FastComments фиксира deployment_id в своя запис за конфигурация - последващите стартирания от друго внедряване под същия клиент ще бъдат отхвърлени, освен ако не регистрирате отново.

Използвате Moodle? Ние също публикуваме специален плъгин за Moodle за FastComments с по-тясна интеграция от LTI 1.3 (hooks за синхронизиране на оценки, по-подробно отчитане на активности, вграден интерфейс за настройки в Moodle). Вижте Ръководство за инсталиране на плъгин за Moodle. По-долу описаният поток LTI 1.3 е подходящ, ако искате една регистрация, която покрива и други LMS, или ако администраторът на Moodle няма да инсталира плъгини на трети страни.

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

Отворете екрана за управление на инструмента

1. Влезте в Moodle като администратор на сайта.
2. Отидете в Администриране на сайта > Плъгини > Модули за активност > External tool > Управление на инструменти.

Поставете URL адреса

Ще видите карта, озаглавена URL на инструмента. Поставете URL адреса за регистрация на FastComments (вземете го тук) в текстовото поле и щракнете върху Add LTI Advantage.

Moodle отваря екран за регистрация, показващ идентичността на инструмента и разрешенията, които иска. Прегледайте и щракнете върху Activate (или Register, в зависимост от версията на Moodle).

Изскачащият прозорец се затваря, когато регистрацията приключи; новият инструмент FastComments се появява в списъка Инструменти със статус Активен.

Направете го достъпен

По подразбиране Moodle добавя новите инструменти в списъка "Инструменти на курса", но не ги показва в избора на активност. За да направите FastComments достъпен за целия курс:

1. Щракнете върху иконата на зъбно колело на плочката FastComments.
2. Под Използване на конфигурацията на инструмента, изберете Показване в избора на активност и като предварително конфигуриран инструмент.
3. Запазете.

Преподавателите вече могат да добавят FastComments към всеки курс чрез Добавяне на активност или ресурс > FastComments.

Blackboard Learn SaaS и Ultra поддържат динамичната регистрация на LTI 1.3.

Open the Tool Provider Screen

1. Влезте в Blackboard като системен администратор.
2. Отидете в Administrator Panel > Integrations > LTI Tool Providers.
3. Кликнете върху Register LTI 1.3 / LTI Advantage Tool.

If you only see "Register LTI 1.1 Provider", your Blackboard version doesn't support LTI 1.3 yet - upgrade or contact Blackboard support.

Paste the URL

Поставете регистрационния URL на FastComments (вземете го тук) в полето Client ID / Registration URL (наименованията в Blackboard варират в зависимост от версията). Изпратете.

Blackboard извършва процеса на регистрация със FastComments и ви показва екран за потвърждение.

Approve and Enable

Blackboard маркира новорегистрираните инструменти като Approved but excluded по подразбиране:

1. Намерете записа FastComments в списъка с доставчици на инструменти.
2. Отворете менюто и изберете Edit.
3. Задайте Tool Status на Approved.
4. Под Institution Policies, прегледайте какви потребителски данни се изпращат (име, email, role). Запазете.

Инструментът вече е наличен за преподавателите, когато добавят съдържание към курсовете.

Sakai

Sakai поддържа LTI 1.3 Динамична регистрация в версии с LTI Advantage. От Работната зона за администрация:

1. Влезте като администратор на Sakai и отворете Работната зона за администрация.
2. Изберете Външни инструменти > Инсталиране на LTI 1.3 инструмент.
3. Поставете регистрационния URL на FastComments (получете го тук) и изпратете.
4. Одобрете инструмента, когато ръкостискането приключи.

След това инструментът се появява под Външни инструменти и може да бъде добавен към сайтовете от техните администратори.

Schoology

Инстанциите на Schoology Enterprise поддържат LTI 1.3, но наличността на Динамичната регистрация варира според внедряването. Свържете се с мениджъра на вашия акаунт в Schoology.

Ако Динамичната регистрация не е налична във вашата инстанция на Schoology, ще трябва да конфигурирате интеграцията ръчно, като използвате тези крайни точки:

• OIDC URL за вход: https://fastcomments.com/lti/v1p3/login
• URL на целевата връзка: https://fastcomments.com/lti/v1p3/launch
• URL на публичния набор от ключове (JWKS): https://fastcomments.com/lti/v1p3/jwks
• URL адреси за пренасочване: 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 (получете го тук). Потърсете настройка с етикет "Динамична регистрация", "URL за регистрация на инструмент", "Крайна точка за иницииране на регистрация на инструмент" или подобна.

Ако вашата платформа поддържа само ръчна конфигурация на LTI 1.3, използвайте четирите крайни точки, изброени в раздела за Schoology по-горе, и се свържете с поддръжката, за да завършите конфигурацията.

Тази страница описва добавянето на FastComments към Brightspace курс след като администраторът е регистрирал инструментa и е създал разполагане (deployment). Ако инструментът още не е регистриран, вижте първо ръководството за регистрация на D2L.

FastComments вграден като тема на единица в Brightspace

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

Намерете инструмента FastComments

Инструментът FastComments се показва на две места в редактора на съдържание на курса:

1. Избирачът на дейности, достъпен от бутона Add Existing на модул/единица (в по-стари версии на Brightspace е етикетиран Add Existing Activities). FastComments се появява директно в избирача в текущите версии на Brightspace; в по-старите версии е вложен в подменю External Learning Tools. И в двата случая пътят добавя FastComments като самостоятелна тема.
2. Диалогът Insert Stuff в HTML редактора, под LTI Advantage. Това вгражда FastComments в HTML тема чрез LTI deep linking потока.

Ако FastComments не се появява в нито един от избирачите, значи разполагането не е разрешено за организационната единица, която държи курса. Помолете вашия Brightspace администратор да отвори Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments, да отвори разполагането и да добави организационната единица на курса (или родителска единица) под Org Units.

Добавяне на FastComments като тема в модул

Classic Content:

1. Отворете курса и кликнете Content в навигационната лента.
2. Изберете модула, който трябва да съдържа дискусията (или създайте такъв чрез Add a module).
3. Кликнете Add Existing (по-стар Brightspace: Add Existing Activities > External Learning Tools).
4. В избирача кликнете FastComments. Brightspace създава тема в модула и ви връща към изгледа на съдържанието.
5. Кликнете новата тема. Преименувайте я на нещо описателно като FastComments Discussion чрез вграденото редактиране на заглавие.

New Content Experience (Lessons):

1. Отворете курса и кликнете Content.
2. Отворете единицата и урока, които трябва да съдържат дискусията.
3. Кликнете Add > Existing Activity и изберете FastComments (по-стар Brightspace: вложен под External Learning Tools).
4. Дейността се добавя към урока.
5. Кликнете заглавието на дейността, за да го преименувате.

Първия път, когато някой потребител (инструктор или студент) отвори темата, FastComments инициализира нишката за този resource link. Нишката е свързана с resource link ID, така че преименуване или преместване на темата не променя коя нишка се зарежда.

Вграждане на FastComments в HTML тема (inline)

Използвайте този поток, когато искате коментарите да се показват под текст, видео или друго съдържание в същата страница на темата, вместо като отделна тема.

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

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

Една HTML тема може да съдържа множество deep-linked вграждания на FastComments. Всяко вграждане получава собствена нишка, защото всеки deep link генерира различен resource link ID.

Тема в модул срещу вграден кратък линк (Inline Quicklink)

Изберете подхода с модула/темата когато:

• Дискусията е основната дейност за тази стъпка в модула.
• Искате темата да се появява в съдържанието на Brightspace, в проследяването на завършеност и в Class Progress.

Изберете подхода с вграденото когато:

• Коментарите трябва да стоят под друго съдържание на същата страница.
• Не искате отделен артикул, проследим за завършеност, в съдържанието.

Видимост, Чернова и Условия за пускане

Нова FastComments тема е видима за студенти по подразбиране. За да я скриете, докато я настройвате:

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

Черновите (Draft) теми са невидими за студентите. Инструкторите и асистентите все още ги виждат с етикет "Draft".

За да ограничите темата до конкретна група или секция:

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

Условията за пускане се комбинират с вътрешното картографиране на роли от FastComments. Студентите, които не могат да видят темата, не получават LTI стартиране.

Какво виждат студентите при първото стартиране

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

1. Brightspace извършва LTI 1.3 стартирането (launch) във фонов режим.
2. FastComments получава името на студента, email, URL на аватара и ролята в LMS и ги използва за автоматично влизане. Няма подкана за вход в FastComments.
3. Нишката с коментари за този resource link се визуализира в Brightspace iframe.

Картографиране на роли при стартиране:

• Brightspace Administrator става FastComments администратор (admin) за нишката (пълен достъп до модерация, изтриване, бан и конфигурация).
• Brightspace Instructor става FastComments модератор (moderator) (pin, hide, delete, ban).
• Всички останали роли (Learner, TeachingAssistant и т.н.) стават стандартни коментатори.

Коментарите са приписани на Brightspace акаунта на студента. Ако студентът промени името или аватара си в Brightspace, следващото LTI стартиране синхронизира промяната.

Ограничете публичния достъп (Препоръчано)

По подразбиране, данните за коментарите на FastComments са публично четими. Всеки, който може да познае URL на нишка или API крайна точка, може да види коментарите, дори извън Brightspace. За дискусии в курсове почти сигурно искате да ограничите преглеждането само до записаните студенти.

Отворете вашата страница за персонализиране на widget и създайте правило с активирана опция Require SSO To View Comments, след което задайте нивото на сигурност на Secure SSO, така че нишките да могат да се зареждат само чрез подписаното LTI стартиране.

Вижте Protecting Comment Threads With Single-Sign-On за пълното ръководство, включително как да ограничите правилото до един домейн или страница.

Височина на iframe и преоразмеряване

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

Ако iframe остава с фиксирана малка височина:

• Потвърдете, че курсът се зарежда през HTTPS. postMessage слушателят на Brightspace отхвърля рамки със смесено съдържание.
• Потвърдете, че нито едно разширение на браузъра не блокира postMessage канала.
• За вграждания в HTML тема, заобикалящият HTML не трябва да опакова iframe в контейнер с фиксирана височина. Премахнете всеки inline style="height: ..." от родителския елемент.

Специфични проблеми в Brightspace

Инструментът не се показва в избирача Add Existing. Разполагането не е разрешено за организационната единица на този курс. Администратор трябва да добави организационната единица (или родителска) в списъка Org Units на разполагането. Само регистрацията на инструмента не е достатъчна; разполагането определя кои курсове виждат инструмента.

deployment_id mismatch on launch. FastComments фиксира първия deployment_id, който види, за регистрацията. Ако администраторът изтрие оригиналното разполагане и създаде ново, стартирането от новото разполагане се отхвърля с грешка за несъответствие на разполагането. Решението е да регистрирате отново FastComments (генерирайте нов URL за регистрация (get it here) и изпълнете Dynamic Registration отново); старата записана конфигурация се заменя.

Инструментът стартира, но показва "Invalid LTI launch". Курсът е в различна структура на tenant/организация от тази, която покрива разполагането, или разполагането е било деактивирано след регистрацията. Проверете отново Admin Tools > Manage Extensibility > LTI Advantage > FastComments > плъзгача Enabled и списъка с организационни единици на разполагането.

Имена и роли липсват във FastComments. Brightspace изпраща LTI стартирания с Names and Role Provisioning Services (NRPS) claims. Ако курсът е бил ъпгрейднат от по-стар LTI 1.1 връзка, стартирането може да липсва name и email claims. Добавете отново FastComments темата чрез Add Existing (не мигрирайте старата връзка), така че стартирането да използва LTI 1.3.

Вграждането показва екран за вход вместо авто-SSO. HTML темата е вмъкната като обикновен