FastComments.com

Add Comments to Your LMS via LTI 1.3

FastComments се интегрише са било којим LMS-ом који је у складу са LTI 1.3 — D2L Brightspace, Moodle, Blackboard Learn, Sakai, Schoology и други — преко IMS LTI Dynamic Registration стандарда. Један URL, налепљен на екран за регистрацију вашег LMS‑а, повезује целу интеграцију: SSO, контекст курса, мапирање улога и постављање садржаја. Нема додатка који треба да инсталирате на ваш сервер. (Canvas LMS има свој посебан водич јер је његов ток регистрације другачији.)

Када је регистрован, FastComments се појављује као алат за учење унутар ваших курсева. Студенти виде коментаре у нитима и колаборативни чет поред садржаја курса, и аутоматски су пријављени својим LMS налогом.

Цијене Internal Link

Интеграција FastComments LTI 1.3 је укључена у Flex и Pro планове без додатних трошкова. Ради са било којим LMS-ом који подржава IMS LTI 1.3 Advantage spec, укључујући Dynamic Registration.

Додајте у садржај курса (Moodle) Internal Link

Ово упутство обухвата додавање FastComments у Moodle 4.x курс након што је администратор сајта регистровао алат и подесио да се приказује у изборнику активности. Ако FastComments још није регистрован, погледајте најпре упутство за регистрацију у Moodle‑у.

Отворите курс у режиму уређивања

  1. Пријавите се у Moodle као наставник са правом уређивања (или виши ниво) за тај курс.
  2. Отворите курс.
  3. Укључите Режим уређивања помоћу прекидача у горњем десном углу заглавља курса.

Moodle 4.x је заменио наслеђени падајући мени „Add an activity or resource“ који је користио 3.x са дијалогом за избор активности преко целог екрана. Moodle 4.5 задржава исти изборник, али додаје ред фаворита/означених ставки на врху, па једном означавање FastComments чини бржим приступ у каснијим секцијама.

Додајте FastComments активност

  1. Скролујте до секције курса (топик или недеља) у којој припада дискусија.
  2. Кликните Add an activity or resource на дну те секције.
  3. У дијалогу за избор изаберите FastComments. Ако га не видите, прескочите на одељак о проблемима (gotchas) испод.

Отвори се формулар за подешавања активности. Поља која су важна:

  • Activity name (обавезно). Приказује се на страници курса и у књизи оцена. Пример: Week 3 Discussion.
  • Activity description. Опционални уводни текст који се рендерује изнад нити коментара.
  • Show description on course page. Означите ако желите да опис буде видљив без клика у активност.
  • Preconfigured tool. Подесите на FastComments (аутоматски изабрано када је покренуто из изборника). Не мењајте.
  • Launch container. Подесите на New window. Погледајте одељак о проблемима зашто „Same window“ може да поквари рад у неким Moodle окружењима.
  • Tool URL, Public key, Shared secret, Custom parameters. Оставите празно. Dynamic Registration је ово подесио на нивоу сајта.

Скролујте до дна и кликните Save and return to course (или Save and display да одмах отворите активност).

Активност се појављује као ред у секцији са иконцом FastComments. Студенти кликну на ред да отворе нит коментара.

Уграђивање FastComments унутар едитора

За нит унутар Page, Book chapter, Lesson или било ког другог ресурса који користи Atto или TinyMCE едитор:

  1. Отворите ресурс у режиму уређивања.
  2. Поставите курсор тамо где треба да се појави нит.
  3. У траци алата едитора кликните на дугме LTI / External tool. У Atto‑у је означено као „Insert LTI Advantage content“. У TinyMCE (подразумевано у Moodle 4.3+) налази се у менију More као External tools.
  4. Из листе алата изаберите FastComments.
  5. FastComments отвара алат за дубинско повезивање (deep‑linking). Потврдите наслов нити и кликните Embed.
  6. Едитор убацује LTI плейсхолдер блок. Сачувајте ресурс.

Свака уграђена инстанца представља засебну нит кључирану на deep‑link content item ID, тако да Page са три FastComments уграђивања има три независне нити.

Ограничите приступ и подешавања група

Стандардна подешавања активности у Moodle‑у важе за FastComments активности:

  • Common module settings > Group mode. Подешавање на Separate groups или Visible groups само по себи не раздваја FastComments у појединачне нити по групама. Moodle‑ов режим група само филтрира књигу оцена и листу чланова. Да бисте покренули засебну нит по групи, додајте по једну FastComments активност за сваку групу и користите Restrict access да опсежно ограничите сваку.
  • Restrict access > Add restriction. Подржава стандардне Moodle услове: Date, Grade, Group, Grouping, User profile, и угнежђене скупине ограничења. Користите Group да закључате FastComments активност за једну групу.
  • Activity completion. Подесите на Students must view this activity to complete it ако желите праћење завршетка. FastComments тренутно не шаље назад у Moodle догађај о завршетку осим лансирања.

Мапирање улога

FastComments чита LTI roles claim који Moodle шаље при сваком лансирању и мапира их на следећи начин:

  • Moodle Manager или Site administrator -> FastComments администратор
  • Moodle Editing teacher или Non-editing teacher -> FastComments модератор
  • Moodle Student -> FastComments коментатор
  • Moodle Guest -> само за читање

Администратори могу да бришу било који коментар, блокирају кориснике и мењају подешавања нити. Модератори могу да бришу и одобравају коментаре унутар нити у коју су лансирани. Прилагођене Moodle улоге наслеђују мапирање архетипа од ког су клониране.

Шта студенти виде

Студенти кликну на FastComments активност (или скролују до уграђеног блока унутар Page или Book). Moodle шаље њихов идентитет у FastComments преко LTI лансирања:

  • Нема екрана за пријаву. FastComments их пријављује користећи Moodle налог.
  • Њихово име за приказ, имејл и аватар долазе из Moodle‑а.
  • Нит је опсежна на (Moodle site, course, resource link ID), тако да иста активност дуплицирана у други курс добија нову нит.
  • Одговори у нити, гласање и нотификације раде исто као у самосталној FastComments нити.

Проблеми у Moodle‑у

FastComments недостаје у изборнику активности. Администратор сајта је регистровао алат али није подесио Tool configuration usage на Show in activity chooser and as a preconfigured tool. Поправите ово у Site administration > Plugins > Activity modules > External tool > Manage tools > иконом зупчаника на FastComments плочици.

Лансирање не успева или приказује празан фрејм када је подешено на "Same window". Moodle‑ове session колачиће користе SameSite=Lax подразумевано, и неки прегледачи их уклањају при cross‑site POST који LTI 1.3 користи да се врати из FastComments. Подесите Launch container на New window на активностима. Ово је строги захтев за уграђени FastComments унутар Page или Book, јер пут лансирања уграђен преко едитора увек отвора нови прозор.

The iss claim is the Moodle site URL, not a tenant ID. FastComments користи Moodle сајт URL (вредност wwwroot у конфигурацији) као LTI issuer. Ако ваша Moodle инстанца пресели домен или промените wwwroot, постојеће FastComments нити остају везане за стари issuer и неће се поклапати са новим лансирањима. Поново региструјте алат за нови URL и по потреби мигрирајте нити преко FastComments администрације.

Activity backup and restore. Прављење бацкуп‑а курса и враћање у нови курс креира нове resource link ID‑еве, тако да обновљене FastComments активности почињу са празним нитима. Оригинални курс задржава оригиналне нити. Ово је очекивано понашање, а не грешка.

Moodle 4.5 TinyMCE default. Moodle 4.5 долази са TinyMCE као подразумеваним едитором за нове инсталације. Дугме за External tool налази се у менију More (...) уместо у главној траци алата. Старији сајтови који су надограђени са 4.1 задржавају Atto осим ако администратор није променио подразумевано.

Додајте у садржај курса (Sakai или Schoology) Internal Link

Once FastComments is registered with the platform, instructors add it to course content using the platform's standard external tool flows. This page covers Sakai 23.x and Schoology Enterprise.

Sakai

1. Add FastComments to a site

Одржаваоц сајта омогућава алат по сајту:

  1. Отворите сајт и у левој навигацији кликните Site Info.
  2. Кликните Manage Tools.
  3. Скелерајте до листе External Tools и укључите FastComments.
  4. Кликните Continue, прегледајте листу алата, затим кликните Finish.

FastComments се сада појављује као ставка у левом навигационом менију сајта.

2. Reorder the left-nav entry

Идите на Site Info > Tool Order. Превуците FastComments на жељену позицију и кликните Save. Са ове странице такође можете преименовати ознаку у навигацији и сакрити је од студената.

3. Embed inline in a Lessons page

Да бисте поставили FastComments директно у Lessons страницу уместо као самостални алат у левој навигацији:

  1. Отворите алат Lessons на сајту.
  2. Кликните Add Content > Add External Tool.
  3. Изаберите FastComments са листе.
  4. Ако је FastComments при регистрацији огласио Deep Linking, Sakai отвори селектор садржаја алата тако да можете одабрати или означити нит. Ако Deep Linking није оглашен, Sakai убацује подразумевани launch линк.
  5. Сачувајте ставку у Lessons.

Свака уграђена инстанца добија своју нит, ограничену на тај ресурсни линк.

4. Permission tweaks for student access

Sakai штити покретања екстерних алата преко Realms. Да потврдите да студенти могу покренути FastComments:

  1. Пријавите се као Sakai администратор и отворите Administration Workspace > Realms.
  2. Отворите релевантни realm (на пример, !site.template.course или специфични realm сајта).
  3. Потврдите да улога access има омогућено lti.launch и да су дозволе улоге у групи external.tools додељене.
  4. Сачувајте realm.

За прескупљења на нивоу сајта, одржаваоц може прилагодити видљивост алата по улогама из Site Info > Tool Order сакривањем или приказивањем FastComments по улози.

5. What students see

Студенти кликну ставку FastComments у левом навигационом менију (или скролују до уграђеног блока у Lessons) и долазе директно у приказ нитованих коментара. SSO је аутоматски: Sakai шаље идентитет корисника у LTI launch и FastComments их пријављује под њиховим Sakai налогом.

Мапирање улога:

  • Sakai Instructor -> FastComments модератор
  • Sakai Admin (admin у Administration Workspace) -> FastComments администратор
  • Sakai Student / access -> FastComments коментатор

6. Sakai gotchas

  • Tool not visible in Manage Tools. Ако се FastComments не појављује у листи External Tools, Sakai администратор треба да отвори регистар алата (Administration Workspace > External Tools > FastComments) и подеси Stealthed на false. Stealthed алати су скривени из пер-сајт Manage Tools избора.
  • Launches breaking in shared-session browsers. Sakai-јев portal CSRF token је везан за сесију прегледача. Ако је студент пријављен на два Sakai сајта у различитим картицама или има застарелу сесију, launch враћа 403. Решење: затворите друге Sakai картице, одјавите се, поново се пријавите и покрените launch. Администратори могу и повећати sakai.csrf.token.cache.ttl ако се ово дешава кластер-широко.
  • Frame embedding. Потврдите да је lti.frameheight у sakai.properties довољно велик (600 или више) како нит коментара не би била одсечена унутар Lessons странице.

Schoology

Schoology Enterprise има два сценарија инсталације. Потврдите који се односи пре додавања алата у курс.

1. Two installation scenarios

  • (a) Enterprise-level install. Schoology System Administrator је инсталирао FastComments на нивоу организације и доделио га свим курсевима или одређеним шаблонима курсева. Предавачи прескачу инсталацију и иду директно на „Add Materials“.
  • (b) Instructor self-install. Предавач инсталира алат у један курс преко Course Options > External Tools > Install LTI Apps. Самоинсталација захтева да System Administrator претходно одобри FastComments апликацију на нивоу организације.

2. Add FastComments as a course material

Унутар курса:

  1. Отворите курс и идите на Materials.
  2. Кликните Add Materials > Add File/Link/External Tool.
  3. Одаберите External Tool.
  4. Изаберите FastComments са листе регистрованих алата.
  5. Поставите Name (ово је оно што студенти виде у листи материјала) и опционални Description.
  6. Оставите Enable Grading (grade passback) OFF. FastComments не шаље оцене назад у Schoology, па укључивање grade passback ствара празну колону у дневнику оцена.
  7. Кликните Submit.

Материјал се сада појављује у листи материјала курса и отвара нит FastComments када се кликне.

3. Inline embedding via the Rich Text editor

Ако је System Administrator омогућио Deep Linking placement за FastComments током регистрације, предавачи могу уградити нит коментара у било које Rich Text поље (упутства за задатак, тела страница, подстицаји за дискусију):

  1. Отворите Rich Text едитор на циљној страници.
  2. Кликните икону External Tool (пликета) у алатној траци.
  3. Изаберите FastComments.
  4. Конфигуришите уградњу у deep-linking дијалогу и кликните Insert.
  5. Сачувајте страницу.

Ако дугме External Tool не појављује у Rich Text едитору, Deep Linking је онемогућен за овај алат на овом тенанту. Погледајте напомене у наставку.

4. Visibility and section assignments

Schoology ограничава доступност алата по секцијама у оквиру Course Options:

  1. Из курса, кликните Course Options > External Tools.
  2. За сваку инсталирану LTI апликацију, контролишете да ли је доступна свим секцијама у курсу или само одређеним секцијама.
  3. Да бисте ограничили FastComments само на одређене секције, поништите ознаке оних секција које не би требало да виде алат.
  4. Приступ по секцијама такође контролише које секције виде ставку Add Materials > External Tool за FastComments.

5. What students see

Студенти кликну материјал FastComments (или скролују до уграђеног садржаја) и долазе у нитовану дискусију. SSO је аутоматски путем Schoology LTI launch под њиховим Schoology налогом.

Мапирање улога:

  • Schoology Administrator -> FastComments администратор
  • Schoology Instructor -> FastComments модератор
  • Schoology Student -> FastComments коментатор

6. Schoology gotchas

  • Enterprise-only. Лични и бесплатни Schoology налози не могу инсталирати LTI 1.3 алате. Ако је ваш тенант на бесплатном нивоу, опција External Tools недостаје у Course Options. Надоградите на Schoology Enterprise да бисте користили FastComments.
  • Deep Linking disabled by tenant default. Неки Schoology тенанти ограничавају Deep Linking placement на нивоу организације. Када је то случај, предавачи виде само ток Add Materials > External Tool, а не дугме External Tool у Rich Text едитору. Да би омогућили inline уградњу, System Administrator иде на System Settings > Integration > LTI 1.3 > FastComments и омогућава Content Item / Deep Linking placement, затим сачува.
  • Per-section assignment override. Ако је FastComments додељен на нивоу организације, али предавач не може да га види у Add Materials, секција курса је искључена у организационом додељивању. Замолите System Administrator-а да дода секцију у FastComments апликацију.
  • Material name vs. thread identity. Преименовање материјала у Schoology-у не помера нит коментара. Нитови су кључирани на LTI resource link ID, па преименовање задржава исту нит; брисање и поновно креирање материјала ствара нову, празну нит.