Додајте коментаре у ваш LMS преко LTI 1.3

1. Пријавите се на FastComments и идите на вашу страницу конфигурације LTI 1.3.
2. (Опционално) Изаберите платформу са које се повезујете у падајућем менију Platform - она поставља ознаку за приказ, али Auto-detect ради добро.
3. Кликните на Generate URL. Појавиће се једнократни Registration URL (важећи 30 минута, за једнократну употребу).
4. У свом LMS-у отворите екран за LTI 1.3 Dynamic Registration и налепите URL у поље Tool initiation registration endpoint (или еквивалентно). Пошаљите.
5. Ваш LMS позива FastComments, размењује кључеве и креира интеграцију. Поп-уп се сам затвара када је процес завршен.
6. У FastComments-у нова конфигурација се појављује у табели Existing Configurations. Алат је сада доступан у курсевима вашег LMS-а.

FastComments LTI 1.3 je testiran na:

• D2L Brightspace (bilo koja verzija sa LTI Advantage)
• Moodle 4.0+ (External Tool plugin, LTI Advantage)
• Blackboard Learn (SaaS i Ultra)
• Sakai (verzije koje podržavaju LTI Advantage)
• Schoology (Enterprise, Dynamic Registration gde je dostupno)

Bilo koji drugi LMS koji implementira IMS LTI 1.3 Advantage specifikaciju sa Dynamic Registration takođe bi trebalo da radi - izaberite Other LTI 1.3 platform iz padajućeg menija platformi prilikom generisanja vašeg URL-a za registraciju (nabavite ga ovde).

Canvas LMS koristi drugačiji tok podešavanja (per-developer-key configuration JSON umesto Dynamic Registration). Pogledajte poseban vodič za instalaciju Canvas LMS-a.

Navigate to LTI 1.3 Configuration

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

Ако ваш налог још нема приступ LTI-ју, видећете "LTI not enabled for this account" - обратите се подршци да га омогуће на вашем плану.

Pick a Platform (Optional)

Под Generate a Dynamic Registration URL, користите падајући мени Platform да кажете FastComments којем LMS-у се повезујете:

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

Такође можете оставити на Auto-detect. Платформа се чита из openid-configuration вашег LMS-а током регистрације; падајући мени само поставља етикету за приказ за добијену конфигурацију.

Generate the URL

Кликните на Generate URL. FastComments креира једнократни registration token и прикаже вам URL који изгледа овако:

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

Копирајте га. Овај URL:

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

Existing Configurations

Када се регистрација успешно заврши, нова конфигурација ће се појавити у табели Existing Configurations на истој страници, са својом Platform, Issuer, Client ID, и Status. Из ове табеле можете избрисати конфигурације ако икада требате да поништите регистрацију.

D2L Brightspace омогућава Dynamic Registration преко LTI Advantage администраторског интерфејса. Биће вам потребан администраторски приступ.

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

1. Пријавите се у вашу Brightspace инстанцу као администратор.
2. Идите на Admin Tools > Manage Extensibility > LTI Advantage.
3. Кликните Register Tool. (The direct URL is https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Залепите URL

Видећете формулар за регистрацију. Кључно поље је Tool initiation registration endpoint (неке верзије Brightspace-а га означавају као "Tool Initiation Registration URL").

Залепите FastComments registration URL (преузмите га овде) у то поље. Оставите остала поља празним - FastComments ће их аутоматски попунити током регистрационог руковања.

Кликните Register.

Одобрите алат

Brightspace отвара поп-ап који комуницира са FastComments, размењује кључеве и приказује потврдни екран. Поп-ап се сам затвара када регистрација буде завршена.

Нови алат се појављује на вашој листи LTI Advantage алата. По подразумевану Brightspace означава нове алате као disabled - померите прекидач у положај enabled како би ваши курсеви могли да га користе.

Додајте deployment

У Brightspace-у, LTI алати захтевају deployment пре него што могу да се користе у курсевима:

1. Отворите недавно регистровани FastComments алат.
2. Кликните View Deployments > New Deployment.
3. Дајте deployment-у име (нпр. "FastComments - All Courses"), изаберите организационе јединице у којима треба да буде доступан и сачувајте.

Након првог покретања преко овог deployment-а, FastComments везује deployment_id за свој запис конфигурације - будућа покретања из другог deployment-а под истим клијентом биће одбијена осим ако се поново не региструјете.

Користите Moodle? Такође објављујемо посебан Moodle плагин за FastComments са непосреднијом интеграцијом него LTI 1.3 (hook-ови за синхронизацију оцена, детаљнији извештаји активности, нативни Moodle интерфејс за подешавања). Погледајте Водич за инсталацију Moodle плагина. Следећи LTI 1.3 ток је прави избор ако желите једну регистрацију која такође покрива друге LMS-ове, или ако ваш Moodle администратор неће инсталирати додатке трећих произвођача.

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

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

1. Пријавите се у Moodle као администратор сајта.
2. Навигирајте до Администрација сајта > Додаци > Модули активности > External tool > Управљање алатима.

Залепите URL

Видећете картицу означену као URL алата. Залепите FastComments URL за регистрацију (добите га овде) у поље за текст и кликните Додај LTI Advantage.

Moodle ће отворити екран за регистрацију који приказује идентитет алата и дозволе које тражи. Прегледајте и кликните Активирај (или Региструј, у зависности од верзије Moodle-а).

Поп-ап се затвара када се регистрација заврши; нови FastComments алат се појављује на листи Алатке са статусом Активан.

Учините га доступним

По подразумевaњу Moodle додаје нове алате у листу „Алатке курса“, али их не приказује у изборнику активности. Да бисте учинили FastComments доступним у целом курсу:

1. Кликните икону зупчаника на FastComments картици.
2. Под Коришћење конфигурације алата, изаберите Прикажи у изборнику активности и као преднастројени алат.
3. Сачувајте.

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

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

Отворите екран пружаоца алата

1. Пријавите се у Blackboard као системски администратор.
2. Идите на Администраторски панел > Интеграције > LTI пружаоци алата.
3. Кликните Региструј LTI 1.3 / LTI Advantage алат.

Ако видите само "Register LTI 1.1 Provider", ваша верзија Blackboard-а још не подржава LTI 1.3 — надоградите или се обратите Blackboard подршци.

Налепите URL

Налепите URL за регистрацију FastComments (добити га овде) у поље Client ID / Registration URL (означавање у Blackboard-у варира по верзији). Пошаљите.

Blackboard изводи руковање регистрацијом са FastComments и приказује екран за потврду.

Одобрите и омогућите

Blackboard подразумевано означава новорегистроване алате као Одобрено али искључено:

1. Пронађите унос FastComments-а у листи пружалаца алата.
2. Отворите мени и одаберите Измени.
3. Поставите Статус алата на Одобрено.
4. Под Политике институције, прегледајте које корисничке податке шаљете (име, имејл, улога). Сачувајте.

Алат је сада доступан предавачима када додају садржај у курсеве.

Sakai

Sakai подржава LTI 1.3 динамичку регистрацију на верзијама са LTI Advantage. Из Административног радног простора:

1. Пријавите се као администратор Sakai-а и отворите Административни радни простор.
2. Изаберите Спољни алати (External Tools) > Инсталирај LTI 1.3 алатку (Install LTI 1.3 Tool).
3. Налепите FastComments URL за регистрацију (добите га овде) и пошаљите.
4. Одобрите алат када руковање заврши.

Алат се затим појављује под Спољни алати (External Tools) и може га додати одржавач сајта.

Schoology

Schoology Enterprise инстанце подржавају LTI 1.3, али доступност динамичке регистрације варира у зависности од распоређивања. Проверите са вашим Schoology менаџером налога.

Ако динамичка регистрација није доступна на вашој 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-ом за регистрацију (добите га овде). Потражите подешавање означено као „Динамичка регистрација“, „URL за регистрацију алата (Tool Registration URL)“, „крајња тачка за иницирање регистрације алата (Tool initiation registration endpoint)“ или слично.

Ако ваша платформа подржава само ручно подешавање LTI 1.3, користите четири крајње тачке наведене у одељку Schoology изнад и контактирајте подршку да бисте финализовали.

Ova stranica opisuje dodavanje FastComments u Brightspace kurs nakon što je administrator registrovao alat i kreirao deployment. Ako alat još nije registrovan, prvo pogledajte D2L vodič za registraciju.

FastComments ugrađen kao tema jedinice u Brightspace

Brightspace nudi dva iskustva za kreiranje sadržaja: Classic Content i New Content Experience (takođe nazvan Lessons). Oba omogućavaju FastComments, ali su putevi u meniju različiti. Svaki odeljak ниже pokriva oba gde se razlikuju.

Pronađite FastComments alat

FastComments alat se pojavljuje na dva mesta u editoru sadržaja kursa:

1. U izboru aktivnosti, dostupan preko dugmeta Add Existing modula/jedinice (u starijim verzijama Brightspace označeno Add Existing Activities). FastComments se u trenutnim buildovima pojavljuje direktno u pickeru; u starijim verzijama je ugnježden pod podmenijem External Learning Tools. Bilo koji put dodaje FastComments kao samostalnu temu.
2. U dijalogu Insert Stuff unutar HTML editora, pod LTI Advantage. Ovo ugrađuje FastComments inline u HTML temu putem LTI deep linking toka.

Ako FastComments nije vidljiv ni u jednom pickeru, deployment nije omogućen za org unit koji drži kurs. Zamolite Brightspace administratora da otvori Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments, otvori deployment i doda org unit kursa (ili roditeljski org unit) pod Org Units.

Dodajte FastComments kao temu u modul

Classic Content:

1. Otvorite kurs i kliknite Content u navigacionom baru.
2. Izaberite modul koji treba da sadrži diskusiju (ili kreirajte jedan preko Add a module).
3. Kliknite Add Existing (stariji Brightspace: Add Existing Activities > External Learning Tools).
4. U pickeru kliknite FastComments. Brightspace kreira temu u modulu i vraća vas na prikaz sadržaja.
5. Kliknite novu temu. Preimenujte je u nešto deskriptivno kao FastComments Discussion koristeći inline uređivač naslova.

New Content Experience (Lessons):

1. Otvorite kurs i kliknite Content.
2. Otvorite jedinicu i lekciju koja treba da sadrži diskusiju.
3. Kliknite Add > Existing Activity i izaberite FastComments (stariji Brightspace: ugnježdeno pod External Learning Tools).
4. Aktivnost je dodata u lekciju.
5. Kliknite naslov aktivnosti da biste je preimenovali.

Prvi put kada bilo koji korisnik (instruktor ili student) otvori temu, FastComments inicijalizuje nit za tu resource link. Nit je vezana za resource link ID, tako da promena imena ili premještanje teme ne menja koja nit se učitava.

Ugradite FastComments inline u HTML temu

Koristite ovaj tok kada želite da se komentari pojave ispod teksta, videa ili drugog sadržaja unutar iste stranice teme umesto kao posebna tema.

1. Otvorite ili kreirajte HTML temu u modulu/lekciji.
2. Kliknite Edit HTML da otvorite Brightspace HTML editor.
3. Postavite kursor tamo gde treba da se pojavi nit komentara.
4. Kliknite dugme Insert Stuff (ikonica slagalice u traci editora).
5. U Insert Stuff dijalogu, skrolujte do LTI Advantage i kliknite FastComments.
6. FastComments otvara deep linking picker. Potvrdite pozicioniranje (podrazumevane opcije rade za diskusije sadržaja); kliknite Insert ili Continue.
7. Brightspace se vraća u HTML editor sa placeholder blokom koji predstavlja LTI launch. Kliknite Save and Close na temi.

Kada se tema učita, Brightspace zamenjuje placeholder iframe-om koji automatski pokreće FastComments putem LTI. Studenti vide nit diskusije inline.

Jedna HTML tema može sadržavati više deep-linked FastComments embedova. Svaki embed dobija sopstvenu nit jer svaki deep link proizvodi različit resource link ID.

Tema modula naspram inline quicklinka

Izaberite pristup tema modula kada:

• Diskusija je primarna aktivnost za taj korak u modulu.
• Želite da tema bude vidljiva u Brightspace sadržaju, praćenju dovršenosti i Class Progress.

Izaberite pristup inline embed kada:

• Komentari treba da stoje ispod drugog sadržaja na istoj stranici.
• Ne želite zasebnu stavku praćenu za dovršenost u tabeli sadržaja.

Vidljivost, Draft i uslovi objavljivanja

Nova FastComments tema je po podrazumevanju vidljiva studentima. Da biste je sakrili dok je podešavate:

1. U editoru sadržaja, kliknite naslov teme (Classic) ili meni sa tri tačke na aktivnosti (New Content Experience).
2. Postavite status na Draft (Classic) ili isključite Visibility (New Content Experience).

Draft teme su nevidljive studentima. Instruktori i TA i dalje ih vide sa oznakom "Draft".

Da biste ograničili temu na određenu grupu ili sekciju:

1. Otvorite temu.
2. Kliknite meni naslova teme > Edit Properties In-place (Classic) ili Edit > Restrictions (New Content Experience).
3. Pod Release Conditions, kliknite Create.
4. Izaberite Group enrollment ili Section enrollment, odaberite grupu/sekciju i sačuvajte.

Uslovi objavljivanja se sabiraju sa FastComments sopstvenim mapiranjem uloga. Studenti koji ne mogu da vide temu ne dobijaju LTI launch.

Šta studenti vide pri prvom pokretanju

Kada student klikne temu (ili učita HTML temu sa embedom):

1. Brightspace izvodi LTI 1.3 launch u pozadini.
2. FastComments prima studentovo ime, email, URL avatara i LMS ulogu, i automatski ga prijavljuje. Nema FastComments prozora za prijavu.
3. Nit komentara za taj resource link se renderuje unutar Brightspace iframe-a.

Mapiranje uloga pri launchu:

• Brightspace Administrator postaje FastComments administrator za nit (puna moderacija, brisanje, banovanje i pristup konfiguraciji).
• Brightspace Instructor postaje FastComments moderator (pin, sakrij, obriši, banovanje).
• Sve ostale uloge (Learner, TeachingAssistant, itd.) postaju standardni komentatori.

Komentari se pripisuju studentovom Brightspace nalogu. Ako student izmeni svoje ime ili avatar u Brightspace-u, sledeći LTI launch sinhronizuje promenu.

Zaključajte javni pristup (preporučeno)

Po podrazumevanju, FastComments podaci komentara su javno čitljivi. Bilo ko ko može da pogodi URL niti ili API endpoint može videti komentare, čak i van Brightspace-a. Za diskusije u kursu gotovo sigurno želite da ograničite pregled samo na upisane polaznike.

Otvorite vašu stranicu za prilagođavanje widgeta i kreirajte pravilo sa omogućenom opcijom Require SSO To View Comments, zatim postavite nivo bezbednosti na Secure SSO tako da se niti mogu učitavati samo putem potpisanog LTI launch-a.

Pogledajte Protecting Comment Threads With Single-Sign-On za kompletnu proceduru, uključujući kako da ograničite pravilo na jedan domen ili stranicu.

Visina iframe-a i promene veličine

FastComments emituje org.imsglobal.lti.frameResize postMessage pri svakom renderovanju niti i pri promenama sadržaja (novi komentar, proširi odgovore). Brightspace sluša ovu poruku i prilagođava visinu iframe-a tako da nit nije odsečena i da se ne prikazuje unutrašnji scrollbar.

Ako iframe ostane na fiksnoj maloj visini:

• Potvrdite da je kurs učitan preko HTTPS-a. Brightspace-ov postMessage listener odbacuje mixed-content frame-ove.
• Potvrdite da nijedno proširenje pregledača ne blokira postMessage kanal.
• Za inline embedove u HTML temi, okruživajući HTML ne sme da obavija iframe u kontejner fiksne visine. Uklonite bilo koji inline style="height: ..." sa roditeljskog elementa.

Specifični problemi u Brightspace-u

Alat se ne prikazuje u Add Existing pickeru. Deployment nije omogućen za org unit ovog kursa. Administrator treba da doda org unit (ili roditelja) na listu Org Units deployment-a. Sama registracija alata nije dovoljna; deployment određuje koji kursevi vide alat.

deployment_id mismatch pri launchu. FastComments TOFU-pin-uje prvi deployment_id koji vidi za registraciju. Ako administrator obriše originalni deployment i kreira novi, pokretanja iz novog deployment-a bivaju odbijena sa greškom o neusaglašenosti deployment-a. Rešenje je da se ponovo registruje FastComments (generišite novi registration URL (nabavite ga ovde) i ponovo pokrenite Dynamic Registration); stara konfiguraciona evidencija se zamenjuje.

Alat se pokreće ali prikazuje "Invalid LTI launch". Kurs je u drugačijoj tenant/org strukturi nego što deployment pokriva, ili je deployment onemogućen nakon registracije. Ponovo proverite Admin Tools > Manage Extensibility > LTI Advantage > FastComments > Enabled prekidač i listu org unit-a za deployment.

Imena i uloge nedostaju u FastComments-u. Brightspace šalje LTI launch-e sa Names and Role Provisioning Services (NRPS) tvrdnjama. Ako je kurs nadograđen sa starijeg LTI 1.1 linka, launch može da ne sadrži name i email tvrdnje. Ponovo dodajte FastComments temu preko Add Existing (ne migrirajte stari link) tako da launch koristi LTI 1.3.

Embed prikazuje ekran za prijavu umesto automatskog SSO. HTML tema je ubačena kao običan <iframe> koji pokazuje na FastComments umesto putem Insert Stuff > LTI Advantage. Obični iframe-ovi preskaču LTI launch i korisnici slijeću na javnu FastComments stranicu. Obrišite iframe i ponovo umetnite putem Insert Stuff toka.

Овај водич описује додавање FastComments у Moodle 4.x курс након што је администратор сајта регистровао алат и подешавао да се приказује у activity chooser-у. Ако FastComments још није регистрован, прво погледајте Moodle registration guide.

Open the Course in Edit Mode

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

Moodle 4.x је заменио застарели падајући мени "Add an activity or resource" који је користио 3.x пуноекранским дијалогом за избор активности (activity chooser). Moodle 4.5 задржава исти chooser али додаје ред омилених (starred/favorites) на врху, тако да једном када закачите FastComments биће брже доступан у наредним одељцима.

Add the FastComments Activity

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

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

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

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

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

Embed FastComments Inline with the Editor

За нит унутар 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 picker. Потврдите наслов нити и кликните Embed.
6. Едитор убацује LTI placeholder блок. Сачувајте ресурс.

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

Restrict Access and Group Settings

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

• Common module settings > Group mode. Постављање на Separate groups или Visible groups само по себи не раздваја FastComments у по-групне нити. Moodle-ов group mode само филтрира gradebook и листу чланова. Да бисте водили појединачну нит по групи, додајте по једну 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 осим лансирања.

Role Mapping

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

• Moodle Manager or Site administrator -> FastComments admin
• Moodle Editing teacher or Non-editing teacher -> FastComments moderator
• Moodle Student -> FastComments commenter
• Moodle Guest -> read-only

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

What Students See

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

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

Lock Down Public Access (Recommended)

По подразумевану, FastComments подаци коментара су јавни за читање. Сваки ко може да погодии URL нити или API endpoint може да види коментаре, чак и ван Moodle-а. За дискусије у курсу готово сигурно желите да ограничите преглед само на уписане студенте.

Отворите вашу widget customization page и креирајте правило са Require SSO To View Comments омогућеним, затим поставите security level на Secure SSO тако да нити могу да се учитавају само преко потписаног LTI лансирања.

Погледајте Protecting Comment Threads With Single-Sign-On за комплетан корак-по-корак водич, укључујући како да ограничите правило на један домен или страницу.

Moodle Gotchas

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

Launch fails or shows a blank frame when set to "Same window". Moodle-ове session cookies користе SameSite=Lax по подразумевaњу, и неки прегледачи их уклањају при 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 нити остају везане за старог 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 осим ако администратор није променио подразумевано.

Када администратор региструје FastComments као LTI 1.3 Advantage алатку и одобри политике институције, инструктори је додају на курсеве кроз стандардне тачке постављања у Blackboard-у. Тачни кораци се разликују између Ultra Course View и Original Course View, па су оба опisana испод.

Ultra Course View

Ultra Course View је подразумевани приказ у Blackboard Learn SaaS од 2026. године.

1. Отворите курс и идите на страницу Course Content.
2. Померите курсор или додирните место у садржају где желите да нит коментара буде и кликните на љубичасти тaster + (Add content).
3. Изаберите Content Market. Панел Content Market приказује све одобрене LTI алате и Building Block поставке за вашу институцију.
4. Пронађите плочицу FastComments и кликните на њу. Blackboard креира ставку садржаја на позицији где сте отворили + мени.
5. Ставка се подразумевано појављује у садржају као унос „Visible to students“ за инструкторе чија је лична подразумевана поставка Hide from students искључена. Ако вам је подразумевано Hidden, ставка се креира као скривена и укључите селектор видљивости у реду ставке када будете спремни.
6. Да переименујете ставку, кликните на наслов у садржају и откуцајте нову ознаку. Наслов који студенти виде у садржају је независан од идентификатора нити у FastComments, па је променa назива безбедна у било ком тренутку.

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

Уграђивање унутар ставке или документа

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

Original Course View:

1. Уредите било коју ставку са богатим текстом.
2. У Content Editor траци алата кликните икону плус Add Content и изаберите Content Market (означено као Add Content from External Tool у старијим Q4 2024 CU издањима).
3. Изаберите FastComments. Едитор убацује placeholder блок који реферира на deep-linked ресурс.
4. Пошаљите ставку.

Сваки deep-link embed генерише своју FastComments нит, тако да ставка са два уграђена FastComments блока има два независна тока коментара.

Видљивост, услови објављивања и ограничења група

Ставке садржаја FastComments понашају се као и било која друга ставка садржаја у Blackboard-у у погледу правила контроле приступа која су на њих накнадно примењена.

• Ultra: кликните селектор видљивости на реду (Visible to students, Hidden from students, Conditional availability). Conditional availability подржава временске прозоре, правила перформанси у односу на ставке у дневнику оцена и правила чланства у односу на групе курса.
• Original: отворите контекст мени ставке и изаберите Adaptive Release или Adaptive Release: Advanced да бисте ограничили приступ алату по датуму, чланству, оцени или статусу ревизије. Користите Set Group Availability на ставци да бисте ограничили на специфичне групе курса.

FastComments поштује шта год Blackboard-ово правило ограничења одлучи. Ако Blackboard сакрије ставку од студента, LTI покретање се за тог студента никада не деси и он се не појављује у модераторском приказу.

Понашање у Gradebook-у

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.

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

Када студент отвори FastComments ставку или скролује до уграђеног блока:

1. Blackboard покреће LTI 1.3 поруку ка FastComments. Студент је пријављен преко SSO користећи њихов Blackboard идентитет (име, е-пошта, аватар, улога) без приказа форме за пријаву.
2. Нит коментара се рендерује у iframe-у. Threading, одговори, помињања и реакције су доступни у складу са подешавањима видгета за коментаре конфигурисаним у 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) у линији на сваком коментару у нити.

Закључавање јавног приступа (препоручено)

По подразумеваној поставци, коментарски подаци на FastComments-у су јавно читљиви. Сваки ко може погодити URL нити или API крајње тачке може видети коментаре, чак и ван Blackboard-а. За дискусије на курсевима готово сигурно желите ограничити преглед само на уписане студенте.

Отворите вашу страницу за прилагођавање виџета и креирајте правило са омогућеним Require SSO To View Comments, затим подесите ниво безбедности на Secure SSO тако да се нити могу учитавати само преко потписаног LTI покретања.

Погледајте Protecting Comment Threads With Single-Sign-On за комплетан водич, укључујући како да ограничите правило на један домен или страницу.

Обухват нити (Thread Scoping)

FastComments обухвата сваку нит по (Blackboard host, course ID, resource link ID). Две FastComments ставке у истом курсу произведу две нити. Иста ставка копирана у две љуске курса (на пример, преко копије курса) производи две нити, јер Blackboard издаје нови resource link ID током копирања. Да бисте задржали заједничку нит преко копија курса, користите Deep Linking са експлицитним thread URN подешеним у FastComments пре покретања копије.

Проблеми специфични за Blackboard

Нема FastComments плочице у Build Content менију (Original) или 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" или "Tool is not deployed" при покретању. Опсег deploy-мента регистрован током динамичке регистрације не одговара контексту институције коме курс припада. У уносу провајдера алата у Blackboard-у, проверите да ли Deployment ID одговара ономе што FastComments приказује на својој LTI 1.3 Configuration страници за овај тенант. Ако се разликују, обришите постављање и поново покрените динамичку регистрацију из свежег registration URL ( нађите га овде ).

Висина iframe-а изгледа фиксна или садржај се одсеца. Неки Blackboard тенанти долазе са строгом Content Security Policy која блокира подразумевани LTI iframe-resize postMessage. FastComments емитује и Canvas-стил lti.frameResize поруку и IMS стандардну org.imsglobal.lti.frameResize поруку ради максималне компатибилности, али tenant-левел CSP оверрајд може блокирати listener у родитељу. Замолите вашег администратора да потврди да је *.fastcomments.com на allowlist-и LTI алата и да ниједан прилагођени CSP заглавље не уклања postMessage догађаје. Након тога ресајз ради без додатне конфигурације.

Копирање курса дуплира нити. Blackboard копија курса издаје нове resource link ID-јеве за LTI поставке, тако да копирани курсеви почињу са празним нитима. Ово је очекиванo. Ако желите да копирани курс наследи оригиналну нит, подесите Deep Linking са експлицитним thread URN пре копирања, или контактирајте FastComments подршку за масовно ремапирање ID-јева нити.

Студент види општу Blackboard грешку при покретању. Узрок је недостајући или застарели email claim. Потврдите да институцијска политика за FastComments има омогућено Role, Name, и Email Address под User Fields to Send. Сачувајте, па покрените поново у новом прозору прегледача.

Када се FastComments региструје на платформи, инструктори га додају у садржај курса користећи стандардне токове за спољне алате платформе. Ова страница покрива Sakai 23.x и Schoology Enterprise.

Lock Down Public Access (Recommended)

Пo подразумеваној вредности, FastComments подаци коментара су јавно читљиви на обе платформе. Сваки ко може да погоди URL нити или њен API ендпоинт може да види коментаре, чак и изван Sakai или Schoology. За дискусије у курсу готово сигурно желите да ограничите преглед само на уписане студенте.

Отворите вашу widget customization page и креирајте правило са омогућеним Require SSO To View Comments, затим подесите ниво безбедности на Secure SSO тако да се нитови могу учитавати само кроз потписано LTI покретање.

Погледајте Protecting Comment Threads With Single-Sign-On за потпун водич, укључујући како да ограничите правило на један домен или страницу.

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.

"Токен за регистрацију није пронађен, истекао је или је већ искоришћен"

Токен у вашем registration URL-у (преузмите га овде) важи 30 минута и може се користити само једном. Ако је ваш LMS потрошио више времена, или ако је регистрација покушана поново након успешне регистрације, токен ће бити одбачен. Генеришите нови URL на страници за конфигурацију FastComments LTI 1.3 и почните испочетка.

"Платформа је одбила регистрацију"

Ваш LMS је одбио процес размене регистрације. Најчешћи узроци:

• Алат је већ регистрован под истим именом клијента. Неке платформе (нарочито D2L) одбијају другу регистрацију "FastComments" док претходна не буде обрисана. Уклonite стари алат у вашем LMS-у, па покушајте поново.
• Погрешно поље у LMS-у. Уверите се да сте налепили URL у поље registration / tool initiation registration endpoint, а не у поље за launch URL или login URL.
• LMS заправо не подржава Dynamic Registration. Старије верзије Moodle и Blackboard најављују LTI 1.3 али дозвољавају само ручну конфигурацију. Проверите документацију ваше платформе.

"Неуспешно преузимање конфигурације платформе"

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 deployment-а другачијег од оног у коме је први пут покренут. FastComments закључава deployment_id при првом покретању као безбедносну проверу. Да бисте додали нови deployment под истим клијентом, контактирајте подршку - ми ћемо додати 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-style (lti.frameResize) и IMS-spec (org.imsglobal.lti.frameResize) resize поруке.

Интеграција FastComments LTI 1.3 следи принцип минималних привилегија: користи само launch захтеве (claims) потребне да се идентификује корисник, повежу коментари са исправним курсом и ресурсом, и примене дозволе по улогама.

Остатак ове странице мапира сваку тврдњу коју интеграција користи, сваки LTI Advantage сервис који не захтева и сваку категорију података које не прикупља. Ревизори за безбедност и набавку могу директно користити одговоре из табела испод.

Елементи података примљени од LMS-а

Сваки LTI 1.3 launch носи потписани JWT од LMS-а. FastComments извлачи следеће тврдње из тог JWT-а и не користи ништа друго:

Тврдње и опсези наведени при регистрацији

Током LTI 1.3 динамичке регистрације, FastComments се региструје са scope: "" (без додатних OAuth опсега) и декларише само следеће OpenID Connect тврдње:

iss, sub, name, email, picture

Регистроване су две врсте порука:

• LtiResourceLinkRequest - стандардно покретање курса у FastComments.
• LtiDeepLinkingRequest - омогућава инструкторима да поставе FastComments алат унутар курса.

Није захтеван додатни приступни токен од LMS-а.

LTI Advantage сервиси који нису захтевани

Податци који се не прикупљају

Поред самог LTI-а, FastComments не захтева и не прима следеће од LMS-а или корисника:

Границе приступа

• FastComments прима податке само у оквиру овлашћеног LTI 1.3 launch-a потписаног кључевима регистрованим код LMS-а. Интеграција не позива назад LMS ради додатних информација.
• Launch токени су за једнократну употребу и краткотрајни. Поновљени или истекли токени се одбацују.
• LMS администратори контролишу где се алат разврстава унутар њихове платформе. На пример, D2L Brightspace подржава ограничавање по организационим јединицама по постављању и по безбедносним подешавањима по деплојменту, што омогућава администраторима да ограничају алат на специфичне курсеве или организационе јединице уместо да га чине глобално доступним. Moodle, Blackboard, Sakai и Schoology нуде еквивалентне контроле по деплојменту у својим LTI 1.3 имплементацијама.

Складиштење и задржавање

FastComments чува LTI-изведене податке током трајања активне услуге коментисања и у складу са подешавањима задржавања које је конфигурисао купац. Подaци о коментарима се чувају у продукционом складишту шифрованом при миру. По прекиду налога или по писаном захтеву за брисање, FastComments брише или анонимизује податке купаца у складу са важећим уговором.

За детаљне информације о складиштењу и руковању подацима, погледајте Политику приватности FastComments.

Учесталост ревизије

Свака нова LTI функција која би захтевала додатне тврдње, опсеге или LTI Advantage сервисе прегледа се пре објављивања како би се потврдило да је тражени приступ неопходан и пропорционалан карактеристикама које се испоручују.

Кратка изјава за безбедносне упитнике

FastComments примењује принцип минималних привилегија и минимализације података у свом LTI 1.3 интеграционом слоју. Интеграција користи само LTI launch тврдње потребне за аутентификацију корисника (sub, name, email, picture), одређивање њихове улоге и идентификацију курса и ресурса чијим коментарима припадају. FastComments не захтева Names and Role Provisioning Services, Assignment and Grade Services, податке о оценама, присуству, пуне спискове учесника или администраторски приступ LMS-у. LMS администратори задржавају контролу над тим у којим организационим јединицама, курсевима и деплојментима је алат доступан.