FastComments.com

Add Comments to Your LMS via LTI 1.3

FastComments se poveže z vsakim LMS, ki podpira LTI 1.3 - D2L Brightspace, Moodle, Blackboard Learn, Sakai, Schoology in drugimi - preko standarda IMS LTI Dynamic Registration. En URL, prilepljen na zaslon za registracijo v vašem LMS, poveže celotno integracijo: SSO, kontekst predmeta, preslikavo vlog in umestitev vsebine. Ni potrebe po vtičniku na vašem strežniku. (Canvas LMS ima svoj poseben vodič, ker je njegov postopek registracije drugačen.)

Ko je registriran, se FastComments prikaže kot učno orodje znotraj vaših predmetov. Študenti ob vsebini predmeta vidijo nitne komentarje in sodelovalni klepet ter so samodejno prijavljeni s svojim računom v LMS.

Cenik Internal Link

Integracija FastComments LTI 1.3 je vključena v načrte Flex in Pro brez dodatnih stroškov.

Deluje z vsakim LMS, ki podpira specifikacijo IMS LTI 1.3 Advantage, vključno z Dynamic Registration.

Dodajte v vsebino predmeta v Moodlu Internal Link

Ta vodnik opisuje, kako dodati FastComments v Moodle 4.x predmet, potem ko je skrbnik strani registriral orodje in ga nastavil tako, da se prikaže v izbiri dejavnosti. Če FastComments še ni registriran, si najprej oglejte vodič za registracijo v Moodlu.

Odprite predmet v načinu urejanja

  1. Prijavite se v Moodle kot urejevalni učitelj (Editing Teacher) ali z višjimi pravicami za predmet.
  2. Odprite predmet.
  3. Vklopite Način urejanja z gumbom v zgornjem desnem kotu glave predmeta.

Moodle 4.x je nadomestil staro spustno polje »Add an activity or resource«, ki ga je uporabljal 3.x, z izbirnikom dejavnosti na celozaslonskem dialogu. Moodle 4.5 ohranja isti izbirnik, a doda vrstico s priljubljenimi/zvezdicami na vrhu, tako da je pripenjanje FastComments-a enkrat naredi hitrejše dostopanje v kasnejših delih.

Dodajte dejavnost FastComments

  1. Pomaknite se do odseka predmeta (teme ali tedna), kamor spada razprava.
  2. Kliknite Add an activity or resource na dnu tega odseka.
  3. V dialogu izbirnika izberite FastComments. Če ga ne vidite, preskočite na razdelek o pogostih težavah spodaj.

Odpre se obrazec za nastavitve dejavnosti. Polja, ki so pomembna:

  • Activity name (obvezno). Prikazano na strani predmeta in v dnevniku ocen. Primer: Week 3 Discussion.
  • Activity description. Neobvezno uvodno besedilo, prikazano nad nitjo komentarjev.
  • Show description on course page. Označite, če želite, da je opis viden brez klika v dejavnost.
  • Preconfigured tool. Nastavljeno na FastComments (samodejno izbrano ob zagonu iz izbirnika). Ne spreminjajte.
  • Launch container. Nastavite na Novo okno. Poglejte razdelek o pogostih težavah, zakaj »Isto okno« v nekaterih Moodle nameščanjih povzroči napake.
  • Tool URL, Public key, Shared secret, Custom parameters. Pustite prazno. Dinamična registracija je to uredila na ravni strani.

Pomaknite se na dno in kliknite Save and return to course (ali Save and display, če želite takoj odpreti dejavnost).

Dejavnost se prikaže kot vrstica v odseku z ikono FastComments. Študenti kliknejo vrstico za odprtje niti komentarjev.

Vdelajte FastComments neposredno v urejevalnik

Za nit znotraj strani (Page), poglavja v Knjigi (Book chapter), lekcije (Lesson) ali katerekoli druge vsebine, ki uporablja urejevalnik Atto ali TinyMCE:

  1. Odprite vsebino v načinu urejanja.
  2. Postavite kazalec na mesto, kjer naj se prikaže nit.
  3. V orodni vrstici urejevalnika kliknite gumb LTI / External tool. V Atto je označen kot »Insert LTI Advantage content«. V TinyMCE (privzeto v Moodle 4.3+) je pod menijem More kot External tools.
  4. Izberite FastComments s seznama orodij.
  5. FastComments odpre izbirnik za deep-linking. Potrdite naslov niti in kliknite Embed.
  6. Urejevalnik vstavi LTI nadomestni blok. Shrani vsebino.

Vsaka vdelana instanca je ločena nit, določena z ID-jem vsebine deep-link, zato stran s tremi vdelavami FastComments dobi tri neodvisne niti.

Omejite dostop in nastavitve skupin

Standardne nastavitve dejavnosti v Moodlu veljajo za FastComments dejavnosti:

  • Common module settings > Group mode. Nastavitev na Separate groups ali Visible groups sama po sebi ne razdeli FastComments v niti za posamezne skupine. Način skupin v Moodlu le filtrira dnevnik ocen in seznam članov. Če želite ločeno nit za vsako skupino, dodajte eno FastComments dejavnost za skupino in uporabite Restrict access, da omejite vsako posebej.
  • Restrict access > Add restriction. Podpira standardne Moodle pogoje: Date, Grade, Group, Grouping, User profile in gnezdene sklope omejitev. Uporabite Group, da zaklenete FastComments dejavnost za eno skupino.
  • Activity completion. Nastavite na Students must view this activity to complete it, če želite spremljanje dokončanja. FastComments trenutno ne poroča Moodle-u o dogodku dokončanja razen zagona.

Preslikava vlog

FastComments prebere LTI trditev roles, ki jo Moodle pošlje ob vsakem zagonu, in jo preslika tako:

  • Moodle Manager ali Site administrator -> FastComments admin
  • Moodle Editing teacher ali Non-editing teacher -> FastComments moderator
  • Moodle Student -> FastComments commenter
  • Moodle Guest -> samo za branje

Administratorji lahko izbrišejo katerikoli komentar, prepovejo uporabnike in urejajo nastavitve niti. Moderatorji lahko brišejo in potrjujejo komentarje znotraj niti, v katero so se zagnali. Prilagojene Moodle vloge podedujejo preslikavo arhetipa, iz katerega so bile klonirane.

Kaj vidijo študenti

Študenti kliknejo FastComments dejavnost (ali se pomaknejo do vdelanega bloka znotraj Strani ali Knjige). Moodle jim pošlje identiteto v FastComments preko LTI zagona:

  • Brez zaslona za prijavo. FastComments jih prijavi z njihovim Moodle računom.
  • Njihovo prikazno ime, e-pošta in avatar prihajajo iz Moodla.
  • Nit je omejena na (Moodle site, course, resource link ID), tako da ista dejavnost, podvojena v drugem predmetu, dobi novo nit.
  • Večstopenjske odgovore, glasovanje in obvestila delujejo enako kot pri samostojni FastComments niti.

Moodle pasti

FastComments manjka v izbiri dejavnosti. Skrbnik strani je registriral orodje, vendar ni nastavil Tool configuration usage na Show in activity chooser and as a preconfigured tool. To popravite pod Site administration > Plugins > Activity modules > External tool > Manage tools > ikona zobnika na ploščici FastComments.

Zagon ne uspe ali prikaže praznega okvira, ko je nastavljen na "Isto okno". Sejne piškotke Moodla uporabljajo SameSite=Lax privzeto, in nekateri brskalniki jih odstranijo pri med-spletni POST zahtevi, ki jo LTI 1.3 uporablja za vrnitev iz FastComments. Nastavite Launch container na Novo okno pri dejavnosti. To je stroga zahteva za vdelane FastComments znotraj Strani ali Knjige, saj pot do zagona, vgrajena v urejevalnik, vedno odpre novo okno.

Trditev iss je URL Moodle strani, ne ID najemnika. FastComments uporablja URL Moodle strani (konfiguracijsko vrednost wwwroot) kot LTI izdajatelja. Če se vaš Moodle premakne na novo domeno ali spremenite wwwroot, obstoječe FastComments niti ostanejo vezane na starega izdajatelja in se ne ujemajo z novimi zagoni. Ponovno registrirajte orodje za nov URL in po potrebi migrirajte niti preko FastComments skrbniške strani.

Varnostna kopija in obnovitev dejavnosti. Varnostno kopiranje predmeta in njegova obnova v nov predmet ustvari nove ID-je resource link, tako da obnovljene FastComments dejavnosti začnejo z praznimi nitmi. Izvirni predmet obdrži izvirne niti. To je pričakovano vedenje, ne napaka.

Moodle 4.5 TinyMCE kot privzeto. Moodle 4.5 vsebuje TinyMCE kot privzeti urejevalnik za nova namestitev. Gumb External tool je pod menijem More (...) namesto v glavni orodni vrstici. Starejše strani, ki so nadgrajene z različice 4.1, obdržijo Atto, razen če skrbnik ni spremenil privzetega.

Dodajte v vsebino predmeta v Sakai ali Schoology Internal Link

Ko je FastComments registriran na platformi, ga inštruktorji dodajo v vsebino tečaja z uporabo standardnih tokov za zunanjo orodja platforme. Ta stran zajema Sakai 23.x in Schoology Enterprise.

Sakai

1. Dodajte FastComments na spletno mesto

Vzdrževalec mesta omogoči orodje za posamezno mesto:

  1. Odprite mesto in v levem meniju kliknite Site Info.
  2. Kliknite Manage Tools.
  3. Pomaknite se do seznama External Tools in preklopite FastComments na vklop.
  4. Kliknite Continue, pregledajte seznam orodij in nato kliknite Finish.

FastComments se zdaj prikaže kot element v levem meniju na mestu.

2. Spremenite vrstni red vnosa v levem meniju

Pojdite v Site Info > Tool Order. Povlecite FastComments na želeno mesto in kliknite Save. Na tem zaslonu lahko tudi preimenujete oznako v meniju in jo skrijete pred študenti.

3. Vdelajte znotraj strani Lessons

Če želite FastComments postaviti neposredno znotraj strani Lessons namesto kot samostojno orodje v levem meniju:

  1. Odprite orodje Lessons na mestu.
  2. Kliknite Add Content > Add External Tool.
  3. Izberite FastComments s seznama.
  4. Če je FastComments med registracijo oglaševal Deep Linking, Sakai odpre izbirnik vsebine orodja, da lahko izberete ali označite nit. Če Deep Linking ni bil oglaševan, Sakai vstavi privzeto lansirno povezavo.
  5. Shrani element Lessons.

Vsaka vdelana instanca dobi svojo nit, omejeno na ta povezavni vir.

4. Prilagoditve dovoljenj za dostop študentov

Sakai omejuje zagone zunanjih orodij preko Realms. Da potrdite, da lahko študenti zaženejo FastComments:

  1. Prijavite se kot Sakai skrbnik in odprite Administration Workspace > Realms.
  2. Odprite ustrezen realm (na primer, !site.template.course ali specifičen realm mesta).
  3. Potrdite, da ima vloga access omogočen lti.launch in da so dodeljena dovoljenja vlog v skupini external.tools.
  4. Shrani realm.

Za nadpise na ravni mesta lahko vzdrževalec prilagodi vidnost orodja po vlogah v Site Info > Tool Order tako, da FastComments skrije ali prikaže za posamezno vlogo.

5. Kaj vidijo študenti

Študenti kliknejo element FastComments v levem meniju (ali se pomaknejo do vdelanega bloka v Lessons) in pristanejo neposredno v pogledu z nitmi komentarjev. SSO je samodejen: Sakai pošlje identiteto uporabnika v LTI launch in FastComments jih prijavi pod njihovim Sakai računom.

Preslikava vlog:

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

6. Sakai opozorila

  • Orodje ni vidno v Manage Tools. Če se FastComments ne pojavi na seznamu External Tools, mora Sakai skrbnik odpreti register orodij (Administration Workspace > External Tools > FastComments) in nastaviti Stealthed na false. Stealthed orodja so skrita iz izbirnika Manage Tools na nivoju mesta.
  • Zagoni se prekinjajo v brskalnikih z deljenimi sejami. Portalni CSRF žeton Sakai je vezan na sejo brskalnika. Če je študent prijavljen v dva Sakai mesta v različnih zavihkih ali ima poteklo sejo, zagon vrne 403. Rešitev: zaprite druge zavihke Sakai, se odjavite, ponovno prijavite in ponovno zaženite. Skrbniki lahko tudi povečajo sakai.csrf.token.cache.ttl, če se to dogaja v celotnem gruči.
  • Vdelava v okvir. Potrdite, da je lti.frameheight v sakai.properties dovolj velik (600 ali več), da nit komentarjev ni odrezana znotraj strani Lessons.

Schoology

Schoology Enterprise ima dva scenarija namestitve. Pred dodajanjem orodja potrdite, kateri se uporablja.

1. Dva scenarija namestitve

  • (a) Namestitev na ravni podjetja. System Administrator Schoology je namestil FastComments na ravni organizacije in ga dodelil vsem tečajem ali določenim predlogam tečajev. Inštruktorji preskočijo namestitev in gredo neposredno na "Add Materials".
  • (b) Samostojna namestitev inštruktorja. Inštruktor namesti orodje v posamezen tečaj iz Course Options > External Tools > Install LTI Apps. Samostojna namestitev zahteva, da je System Administrator najprej odobril aplikacijo FastComments na ravni organizacije.

2. Dodajte FastComments kot gradivo tečaja

Znotraj tečaja:

  1. Odprite tečaj in pojdite na Materials.
  2. Kliknite Add Materials > Add File/Link/External Tool.
  3. Izberite External Tool.
  4. Izberite FastComments s seznama registriranih orodij.
  5. Nastavite Name (to je tisto, kar študenti vidijo na seznamu gradiv) in po želji Description.
  6. Pustite Enable Grading (grade passback) OFF. FastComments ne poroča ocen nazaj v Schoology, zato omogočanje vrnitve ocen ustvari prazen stolpec v ocenjevalnici.
  7. Kliknite Submit.

Gradivo se sedaj prikaže na seznamu gradiv v tečaju in ob kliku odpre nit FastComments.

3. Vdelava v vrstico z Rich Text urejevalnikom

Če je System Administrator med registracijo omogočil Deep Linking postavitev za FastComments, lahko inštruktorji vstavijo nit komentarjev v katerokoli polje Rich Text (navodila za nalogo, telo strani, pozive za razpravo):

  1. Odprite Rich Text urejevalnik na ciljni strani.
  2. Kliknite ikono External Tool (ikona sestavljanke) v orodni vrstici.
  3. Izberite FastComments.
  4. Konfigurirajte vdelavo v pogovornem oknu za deep-linking in kliknite Insert.
  5. Shrani stran.

Če gumb External Tool ne prikazuje v Rich Text urejevalniku, je za to orodje na tej najemniški ravni onemogočen Deep Linking. Glejte spodnja opozorila.

4. Vidnost in dodelitve sekcij

Schoology omejuje razpoložljivost orodja po sekcijah znotraj Course Options:

  1. Iz tečaja kliknite Course Options > External Tools.
  2. Za vsako nameščeno LTI aplikacijo upravljate, ali je na voljo vsem sekcijam v tečaju ali samo določenim sekcijam.
  3. Če želite omejiti FastComments na določene sekcije, počistite sekcije, ki ne bi smele videti orodja.
  4. Dostop na ravni sekcij tudi določa, katere sekcije vidijo vnos Add Materials > External Tool za FastComments.

5. Kaj vidijo študenti

Študenti kliknejo gradivo FastComments (ali se pomaknejo do vdelave) in pristanejo v nitni razpravi. SSO je samodejno preko Schoology LTI launch pod njihovim Schoology računom.

Preslikava vlog:

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

6. Schoology opozorila

  • Samo za Enterprise. Osebni in brezplačni Schoology računi ne morejo namestiti LTI 1.3 orodij. Če je vaš najemnik na brezplačnem nivoju, možnost External Tools manjka v Course Options. Nadgradite na Schoology Enterprise, da uporabljate FastComments.
  • Deep Linking onemogočen po privzetku najemnika. Nekateri najemniki Schoology omejujejo Deep Linking postavitev na ravni organizacije. Ko je to tako, inštruktorji vidijo samo potek Add Materials > External Tool in ne gumb External Tool v Rich Text urejevalniku. Za omogočanje vdelave v vrstico mora System Administrator iti v System Settings > Integration > LTI 1.3 > FastComments in omogočiti postavitev Content Item / Deep Linking, nato shraniti.
  • Nadpis dodelitve po sekcijah. Če je FastComments dodeljen na ravni podjetja, vendar ga inštruktor ne vidi v Add Materials, je sekcija tečaja izključena v dodelitvi na ravni organizacije. Prosite System Administratorja, da doda sekcijo k dodelitvi aplikacije FastComments.
  • Ime gradiva v primerjavi z identiteto niti. Preimenovanje gradiva v Schoology ne premakne niti komentarjev. Niti so ključene na LTI resource link ID, zato preimenovanje ohrani isto nit; brisanje in ponovno ustvarjanje gradiva ustvari novo, prazno nit.