Add Comments to Canvas LMS via LTI 1.3
FastComments si integra con Canvas LMS tramite lo standard LTI 1.3. Questo aggiunge commenti in tempo reale e chat collaborativa direttamente ai tuoi corsi Canvas - nessun plugin da installare sul tuo server.
I commenti appaiono automaticamente sotto i compiti, e gli istruttori possono incorporare FastComments in Pagine, Quiz e Annunci tramite il Rich Content Editor. Il SSO viene gestito automaticamente tramite il lancio LTI - gli studenti commentano con i loro account Canvas senza un accesso separato. L'integrazione supporta commenti nidificati, chat collaborativa in tempo reale con evidenziazione del testo e mappatura automatica dei ruoli.
Prezzi 
L'integrazione FastComments LTI 1.3 è inclusa nei piani Flex e Pro senza costi aggiuntivi.
Avvio rapido
- Vai a la tua FastComments LTI Config.
- Inserisci un Configuration Name e il tuo Platform URL (ad esempio
https://yourschool.instructure.com). Scegli quali Placements abilitare (Assignment View and/or Editor Button — entrambi attivi per impostazione predefinita). Fai clic su Create Configuration. La procedura guidata avanza al Passo 2 e mostra il tuo Configuration URL. - In Canvas, vai su Admin > Developer Keys > + Developer Key > LTI Key. Imposta Method su "Enter URL" e incolla il Configuration URL. Salva la key, quindi imposta il suo State su ON e fai clic su Allow quando richiesto.
- Copia il numero Client ID dalla tabella Developer Keys in Canvas. Torna su FastComments, incollalo nel campo Client ID e fai clic su Save & Continue.
- Controlla il riepilogo della configurazione e fai clic su Enable Integration per andare in produzione.
- Installa l'External App in Canvas (Admin > Settings > Apps > + App > By Client ID). I commenti appariranno automaticamente sotto le assignments, e gli istruttori possono incorporare FastComments in Pages, Quizzes e Announcements tramite il pulsante della barra degli strumenti del Rich Content Editor.
Configurazione della dashboard di FastComments
Vai alla Configurazione LTI
Vai a la tua Configurazione LTI di FastComments.
La pagina di configurazione utilizza una procedura guidata che ti accompagna in ogni passaggio. Inizierai da Passaggio 1: Crea.
Crea una nuova configurazione LTI
Compila i seguenti campi:
- Configuration Name - un'etichetta opzionale per identificare questa configurazione (utile se colleghi più istanze di Canvas).
- Platform URL - l'URL della tua istanza Canvas (es.
https://yourschool.instructure.com). Questo campo è obbligatorio.
Scegli le posizioni
Sotto il campo Platform URL, puoi scegliere dove appare FastComments nei tuoi corsi Canvas. Entrambe le posizioni sono abilitate di default:
- Assignment View - i commenti appaiono automaticamente sotto le assegnazioni.
- Rich Content Editor Button - gli istruttori possono incorporare FastComments in Pagine, Quiz e Annunci usando il pulsante della barra degli strumenti nell'Editor di contenuti ricchi.
Puoi abilitare uno o entrambi. Deve essere abilitata almeno una posizione.
Fai clic su Crea configurazione.
Copia l'URL di configurazione
Dopo aver creato la configurazione, la procedura guidata passa a Passaggio 2: Connetti. Un evidente URL di configurazione è mostrato nella parte superiore della pagina con un pulsante Copia.
Copia questo URL. Ne avrai bisogno nel passaggio successivo per creare una Developer Key in Canvas.
La pagina mostra anche istruzioni numerate su cosa fare in Canvas, oltre ai campi per inserire il Client ID e l'opzionale Deployment ID non appena li avrai.
Chiave sviluppatore di Canvas
Open Developer Keys in Canvas
Accedi a Canvas come amministratore. Vai su Admin (nella barra laterale sinistra) > seleziona il tuo account > Developer Keys.
Create an LTI Developer Key
Fai clic su + Developer Key e seleziona LTI Key.
Nel modulo di configurazione:
- Nel campo Redirect URIs (lato sinistro), incolla il Launch URL dalla pagina di configurazione di FastComments.
- A destra, imposta Method su Enter URL.
- Incolla il Configuration URL copiato da FastComments nel campo JSON URL.
- Canvas caricherà automaticamente la configurazione LTI.
- Assegna alla chiave un nome (es. "FastComments").
- Fai clic su Save.
Enable the Developer Key
Dopo il salvataggio, la nuova chiave apparirà nella tabella Developer Keys con il suo State impostato su OFF. Fai clic sull'interruttore per impostarlo su ON. Canvas potrebbe chiederti di confermare — fai clic su Allow per abilitare la chiave.
Copy the Client ID
La tabella Developer Keys mostra un Client ID numerico nella colonna Details (e.g. 17000000000042). Copia questo numero - ti servirà nel passaggio successivo.
Completa la connessione
Inserisci il Client ID in FastComments
Torna a la tua configurazione LTI di FastComments. Il wizard dovrebbe essere su Passo 2: Connessione.
Incolla il Client ID copiato da Canvas nel campo Client ID. Facoltativamente inserisci il Deployment ID se il tuo LMS ne fornisce uno.
Fai clic su Salva e continua.
Abilita l'integrazione
Il wizard passa a Passo 3: Vai Live. Viene mostrato un riepilogo della tua configurazione (nome, URL della piattaforma, Client ID e Deployment ID).
Rivedi i dettagli, quindi fai clic su Abilita integrazione per attivare la connessione LTI.
Dopo l'attivazione, il wizard mostra la Vista di gestione dove puoi modificare la tua configurazione, visualizzare tutti gli URL LTI o aggiungere deployment aggiuntivi.
Installa l'app esterna in Canvas
In Canvas, vai su Amministrazione > seleziona il tuo account > Impostazioni > scheda App.
Fai clic su + App e configura:
- Imposta Configuration Type su By Client ID.
- Incolla il Client ID dalla tabella Developer Keys.
- Fai clic su Invia.
- Conferma l'installazione quando richiesto.
FastComments è ora installato a livello di account e disponibile in tutti i corsi.
Aggiungi a un corso
Come Appaiono i Commenti nei Tuoi Corsi
Una volta abilitata l'integrazione LTI e installata l'App esterna, FastComments funziona automaticamente in base alle posizioni che hai configurato:
Visualizzazione compito
Se la posizione Visualizzazione compito è abilitata, i commenti appaiono automaticamente sotto ogni compito del corso. Studenti e istruttori vedono una sezione di commenti a thread quando visualizzano un compito — non è necessaria alcuna configurazione aggiuntiva per singolo compito.
Ogni compito ottiene il proprio thread di commenti separato.
Pulsante dell'Editor di contenuti ricchi
Se la posizione Pulsante dell'Editor è abilitata, gli istruttori possono incorporare FastComments in qualsiasi contenuto che utilizzi l'Editor di contenuti ricchi:
- Modifica una Pagina, un Quiz o un Annuncio.
- Nella barra degli strumenti dell'Editor di contenuti ricchi, clicca il pulsante FastComments.
- FastComments viene incorporato automaticamente nel contenuto.
- Salva la pagina.
Quando gli studenti visualizzano la pagina, il widget FastComments incorporato si carica con un thread di commenti unico per quella pagina.
SSO automatico
In entrambe le posizioni, gli studenti effettuano l'accesso automaticamente tramite il loro account Canvas. Nomi, email e avatar vengono sincronizzati tramite il lancio LTI, non è necessario un accesso separato.
Limitare l'accesso pubblico (consigliato)
Per impostazione predefinita, i dati dei commenti di FastComments sono leggibili pubblicamente. Chiunque riesca a indovinare l'URL di un thread o l'endpoint API può visualizzarne i commenti, anche al di fuori di Canvas. Per le discussioni del corso quasi certamente vorrai limitare la visualizzazione solo agli studenti iscritti.
Apri la tua pagina di personalizzazione del widget e crea una regola con Require SSO To View Comments abilitato, quindi imposta il livello di sicurezza su Secure SSO in modo che i thread possano essere caricati solo tramite il lancio LTI autenticato.
Vedi Protecting Comment Threads With Single-Sign-On per la procedura completa, inclusa la modalità per limitare la regola a un singolo dominio o pagina.
Stili di commento
FastComments aggiunge commenti annidati ai tuoi corsi Canvas. Il widget standard di FastComments appare sulla pagina. Gli utenti possono pubblicare commenti annidati, rispondere, votare e usare tutte le funzionalità standard.
I commenti sono associati a ogni pagina del corso o link di risorsa, quindi le discussioni rimangono organizzate per pagina, compito o modulo.
Mappatura dei ruoli
I ruoli di Canvas vengono mappati automaticamente sui ruoli di FastComments durante il lancio LTI. Non è necessaria alcuna configurazione manuale.
Mappatura dei ruoli
| Canvas Role | FastComments Role | Permissions |
|---|---|---|
| Amministratore | Admin | Accesso completo all'account, gestione di tutti i commenti e delle impostazioni |
| Docente | Moderator | Modificare ed eliminare commenti, fissare i thread, gestire le discussioni |
| Studente | Commenter | Pubblicare commenti, rispondere, votare e usare le menzioni |
Come funziona
Quando un utente avvia FastComments da Canvas, il protocollo LTI 1.3 include il suo ruolo Canvas. FastComments legge questo ruolo e assegna automaticamente le autorizzazioni appropriate.
Se un utente ha più ruoli (ad es. un Docente che è anche Admin), viene utilizzato il ruolo con il privilegio più elevato.
Personalizzazione
FastComments è progettato per essere personalizzato per adattarsi al tuo sito.
Se desideri aggiungere uno stile personalizzato o modificare la configurazione, Consulta la nostra documentazione sulle personalizzazioni e la configurazione per scoprire come.
Errori di dominio
Potresti ricevere un errore di autorizzazione, simile al seguente:
Questo perché FastComments non sa che dovrebbe consentire l'utilizzo del tuo account su questo dominio.
In questo caso, la soluzione è semplice. Devi solo aggiungere il dominio della tua istanza Canvas al tuo account FastComments.
Vai qui per aggiungere il tuo sito al tuo account.
Aggiungi il dominio Canvas (ad es. yourschool.instructure.com) e i commenti dovrebbero caricarsi correttamente.