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 спецификацију, укључујући 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. Ако га не видите, прескочите до одељка о проблемима у наставку.

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

  • 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 inline уз уређивач

За нит унутар 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 placeholder блок. Сачувајте ресурс.

Свака уграђена инстанца је посебна нит која се кључира на 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-у догађај завршетка осим лансирања.

Mapирање улога

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

  • Moodle Менаџер или Администратор сајта -> FastComments admin
  • Moodle Наставник са правом уређивања или Наставник без права уређивања -> FastComments moderator
  • Moodle Студент -> FastComments commenter
  • Moodle Гост -> само за читање

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

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

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

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

Чести проблеми у Moodle

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

Покретање не успева или приказује празан фрејм када је постављено на "Same window". Moodle-ови сесијски колачићи користе 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 site URL (вредност конфигурације wwwroot) као LTI issuer. Ако ваш Moodle премести на нови домен или промените wwwroot, постојеће FastComments нити остају везане за старог издавача и неће се поклопити са новим покретањима. Поново региструјте алат за нови 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

The site maintainer enables the tool on a per-site basis:

  1. Open the site and click Site Info in the left navigation.
  2. Click Manage Tools.
  3. Scroll to the External Tools list and toggle FastComments on.
  4. Click Continue, review the tool list, then click Finish.

FastComments now appears as a left-nav item in the site.

2. Reorder the left-nav entry

Go to Site Info > Tool Order. Drag FastComments to the desired position and click Save. You can also rename the nav label and hide it from students from this screen.

3. Embed inline in a Lessons page

To place FastComments directly inside a Lessons page rather than as a standalone left-nav tool:

  1. Open the Lessons tool in the site.
  2. Click Add Content > Add External Tool.
  3. Select FastComments from the list.
  4. If FastComments advertised Deep Linking during registration, Sakai opens the tool's content selector so you can pick or label the thread. If Deep Linking wasn't advertised, Sakai inserts a default launch link.
  5. Save the Lessons item.

Each embedded instance gets its own thread, scoped to that resource link.

4. Permission tweaks for student access

Sakai gates external tool launches through Realms. To confirm students can launch FastComments:

  1. Sign in as a Sakai admin and open Administration Workspace > Realms.
  2. Open the relevant realm (for example, !site.template.course or the specific site realm).
  3. Confirm the access role has lti.launch enabled and that the role permissions in the external.tools group are granted.
  4. Save the realm.

For site-level overrides, the maintainer can adjust per-role tool visibility from Site Info > Tool Order by hiding or showing FastComments per role.

5. What students see

Students click the FastComments left-nav item (or scroll to the embedded Lessons block) and land directly in the threaded comment view. SSO is automatic: Sakai sends the user's identity in the LTI launch and FastComments signs them in under their Sakai account.

Role mapping:

  • Sakai Instructor -> FastComments moderator
  • Sakai Admin (admin in Administration Workspace) -> FastComments admin
  • Sakai Student / access -> FastComments commenter

6. Sakai gotchas

  • Tool not visible in Manage Tools. If FastComments doesn't appear in the External Tools list, the Sakai admin needs to open the tool registry (Administration Workspace > External Tools > FastComments) and set Stealthed to false. Stealthed tools are hidden from the per-site Manage Tools picker.
  • Launches breaking in shared-session browsers. Sakai's portal CSRF token is bound to the browser session. If a student is signed in to two Sakai sites in different tabs or has a stale session, the launch returns a 403. Fix: close other Sakai tabs, sign out, sign back in, and relaunch. Admins can also raise sakai.csrf.token.cache.ttl if this happens cluster-wide.
  • Frame embedding. Confirm lti.frameheight in sakai.properties is large enough (600 or higher) so the comment thread isn't clipped inside a Lessons page.

Schoology

Schoology Enterprise has two installation scenarios. Confirm which one applies before adding the tool to a course.

1. Two installation scenarios

  • (a) Enterprise-level install. The Schoology System Administrator installed FastComments at the organization level and assigned it to all courses or to specific course templates. Instructors skip installation and go straight to "Add Materials".
  • (b) Instructor self-install. The instructor installs the tool into a single course from Course Options > External Tools > Install LTI Apps. Self-install requires the System Administrator to have approved the FastComments app at the org level first.

2. Add FastComments as a course material

Inside the course:

  1. Open the course and go to Materials.
  2. Click Add Materials > Add File/Link/External Tool.
  3. Choose External Tool.
  4. Select FastComments from the registered tools list.
  5. Set a Name (this is what students see in the materials list) and an optional Description.
  6. Leave Enable Grading (grade passback) OFF. FastComments does not report grades back to Schoology, so enabling grade passback creates an empty gradebook column.
  7. Click Submit.

The material now appears in the course materials list and opens the FastComments thread when clicked.

3. Inline embedding via the Rich Text editor

If the System Administrator enabled Deep Linking placement for FastComments during registration, instructors can embed the comment thread inside any Rich Text field (assignment instructions, page bodies, discussion prompts):

  1. Open the Rich Text editor on the target page.
  2. Click the External Tool (puzzle piece) icon in the toolbar.
  3. Choose FastComments.
  4. Configure the embed in the deep-linking dialog and click Insert.
  5. Save the page.

If the External Tool button doesn't appear in the Rich Text editor, Deep Linking is disabled for this tool on this tenant. See the gotchas below.

4. Visibility and section assignments

Schoology scopes tool availability per section through Course Options:

  1. From the course, click Course Options > External Tools.
  2. For each installed LTI app, you control whether it's available to all sections in the course or to specific sections.
  3. To restrict FastComments to certain sections, uncheck the sections that should not see the tool.
  4. Section-level access also gates which sections see the Add Materials > External Tool entry for FastComments.

5. What students see

Students click the FastComments material (or scroll to the inline embed) and land in the threaded discussion. SSO is automatic via the Schoology LTI launch under their Schoology account.

Role mapping:

  • Schoology Administrator -> FastComments admin
  • Schoology Instructor -> FastComments moderator
  • Schoology Student -> FastComments commenter

6. Schoology gotchas

  • Enterprise-only. Personal and free Schoology accounts cannot install LTI 1.3 tools. If your tenant is on the free tier, the External Tools option is absent from Course Options. Upgrade to Schoology Enterprise to use FastComments.
  • Deep Linking disabled by tenant default. Some Schoology tenants restrict Deep Linking placement at the org level. When this is the case, instructors see only the Add Materials > External Tool flow and not the External Tool button in the Rich Text editor. To enable inline embedding, the System Administrator goes to System Settings > Integration > LTI 1.3 > FastComments and enables the Content Item / Deep Linking placement, then saves.
  • Per-section assignment override. If FastComments is assigned at the enterprise level but the instructor cannot see it in Add Materials, the course's section is excluded in the org-level assignment. Ask the System Administrator to add the section to the FastComments app assignment.
  • Material name vs. thread identity. Renaming the material in Schoology does not move the comment thread. Threads are keyed on the LTI resource link ID, so a rename keeps the same thread; deleting and recreating the material creates a new, empty thread.