Add Comments to Your LMS via LTI 1.3

1. Connectez-vous à FastComments et allez sur votre page de configuration LTI 1.3.
2. (Optionnel) Choisissez la plateforme depuis le menu déroulant Plateforme - cela définit le libellé affiché, mais la détection automatique fonctionne bien.
3. Cliquez sur Générer l'URL. Une Registration URL à usage unique apparaît (valide 30 minutes).
4. Dans votre LMS, ouvrez l'écran d'enregistrement dynamique LTI 1.3 et collez l'URL dans le champ Tool initiation registration endpoint (ou équivalent). Soumettez.
5. Votre LMS rappelle FastComments, échange les clés et crée l'intégration. La fenêtre contextuelle se ferme automatiquement une fois l'opération terminée.
6. De retour sur FastComments, la nouvelle configuration apparaît dans le tableau Existing Configurations. L'outil est désormais disponible dans vos cours LMS.

FastComments LTI 1.3 a été testé avec :

• D2L Brightspace (toute version avec LTI Advantage)
• Moodle 4.0+ (plugin External Tool, LTI Advantage)
• Blackboard Learn (SaaS et Ultra)
• Sakai (versions prenant en charge LTI Advantage)
• Schoology (Enterprise, Dynamic Registration là où disponible)

Tout autre LMS qui implémente la spécification IMS LTI 1.3 Advantage avec Dynamic Registration devrait également fonctionner - sélectionnez Autre plateforme LTI 1.3 dans le menu déroulant de la plateforme lors de la génération de votre URL d'enregistrement (obtenez-le ici).

Canvas LMS utilise un flux d'installation différent (JSON de configuration par clé développeur au lieu de Dynamic Registration). Consultez le guide d'installation dédié à Canvas LMS.

Accédez à la configuration LTI 1.3

Connectez-vous à FastComments et rendez-vous sur votre page de configuration LTI 1.3.

Si votre compte n'a pas encore accès à LTI, vous verrez "LTI not enabled for this account" - contactez le support pour l'activer sur votre forfait.

Choisissez une plateforme (facultatif)

Sous Générer une URL d'enregistrement dynamique, utilisez le menu déroulant Plateforme pour indiquer à FastComments auquel LMS vous vous connectez :

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Autre plateforme LTI 1.3

Vous pouvez aussi le laisser sur Auto-detect. La plateforme est lue à partir de l'openid-configuration de votre LMS lors de l'enregistrement ; le menu déroulant ne sert qu'à définir l'étiquette d'affichage pour la configuration résultante.

Générer l'URL

Cliquez sur Générer l'URL. FastComments crée un jeton d'enregistrement à usage unique et vous affiche une URL qui ressemble à :

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

Copiez-la. Cette URL :

• Est à usage unique - une fois que votre LMS appelle l'URL avec succès, le jeton est consommé.
• Expire après 30 minutes si elle n'est pas utilisée.
• Doit être gardée privée - toute personne disposant de l'URL peut enregistrer un outil contre votre tenant pendant ces 30 minutes.

Existing Configurations

Une fois un enregistrement effectué avec succès, la nouvelle configuration apparaît dans le tableau Existing Configurations sur la même page, avec ses Platform, Issuer, Client ID, et Status. Vous pouvez supprimer des configurations de ce tableau si vous devez un jour vous désenregistrer.

D2L Brightspace propose l'enregistrement dynamique via l'interface d'administration LTI Advantage. Vous aurez besoin d'un accès administrateur.

Ouvrir l'écran d'enregistrement

1. Connectez-vous à votre instance Brightspace en tant qu'administrateur.
2. Accédez à Outils d'administration > Gérer l'extensibilité > LTI Advantage.
3. Cliquez sur Register Tool. (L'URL directe est https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Coller l'URL

Vous verrez un formulaire d'enregistrement. Le champ clé est Tool initiation registration endpoint (certaines versions de Brightspace l'étiquettent "Tool Initiation Registration URL").

Collez l'URL d'enregistrement FastComments (obtenez-le ici) dans ce champ. Laissez les autres champs vides - ils sont remplis automatiquement par FastComments lors de la transaction d'enregistrement.

Cliquez sur Register.

Approuver l'outil

Brightspace ouvre une fenêtre contextuelle qui communique avec FastComments, échange les clés et affiche un écran de confirmation. La fenêtre se ferme automatiquement lorsque l'enregistrement est terminé.

Le nouvel outil apparaît dans votre liste d'outils LTI Advantage. Par défaut, Brightspace marque les nouveaux outils comme disabled - basculez l'interrupteur sur enabled pour que vos cours puissent l'utiliser.

Ajouter un déploiement

Dans Brightspace, les outils LTI nécessitent un déploiement avant de pouvoir être utilisés dans les cours :

1. Ouvrez l'outil FastComments nouvellement enregistré.
2. Cliquez sur View Deployments > New Deployment.
3. Donnez un nom au déploiement (par ex. "FastComments - All Courses"), choisissez les unités organisationnelles dans lesquelles il doit être disponible, puis enregistrez.

Après le premier lancement via ce déploiement, FastComments attache le deployment_id à son enregistrement de configuration - les lancements suivants depuis un autre déploiement sous le même client seront refusés à moins que vous ne vous réenregistriez.

Vous utilisez Moodle ? Nous publions également un plugin Moodle dédié pour FastComments offrant une intégration plus poussée que LTI 1.3 (hooks de synchronisation des notes, rapports d'activité plus approfondis, interface native de paramètres Moodle). Consultez le guide d'installation du plugin Moodle. Le flux LTI 1.3 ci-dessous est le bon choix si vous souhaitez un enregistrement unique couvrant également d'autres LMS, ou si votre administrateur Moodle n'installera pas de plugins tiers.

Moodle 4.0+ prend en charge l'enregistrement dynamique LTI 1.3 via le plugin Outil externe.

Ouvrir l'écran de gestion des outils

1. Connectez-vous à Moodle en tant qu'administrateur du site.
2. Accédez à Administration du site > Plugins > Modules d'activité > Outil externe > Gérer les outils.

Coller l'URL

Vous verrez une carte intitulée URL de l'outil. Collez l'URL d'enregistrement FastComments (obtenez-la ici) dans le champ de texte et cliquez sur Ajouter LTI Advantage.

Moodle ouvre un écran d'enregistrement affichant l'identité de l'outil et les autorisations demandées. Vérifiez et cliquez sur Activer (ou Enregistrer, selon la version de Moodle).

La fenêtre contextuelle se ferme lorsque l'enregistrement est terminé ; le nouvel outil FastComments apparaît dans la liste Outils avec le statut Actif.

Rendre l'outil disponible

Par défaut, Moodle ajoute les nouveaux outils à la liste "Outils du cours" mais ne les affiche pas dans le sélecteur d'activité. Pour rendre FastComments visible dans tout le cours :

1. Cliquez sur l'icône d'engrenage sur la tuile FastComments.
2. Sous Utilisation de la configuration de l'outil, choisissez Afficher dans le sélecteur d'activités et comme outil préconfiguré.
3. Enregistrez.

Les enseignants peuvent maintenant ajouter FastComments à n'importe quel cours via Ajouter une activité ou une ressource > FastComments.

Blackboard Learn SaaS and Ultra support LTI 1.3 Dynamic Registration.

Open the Tool Provider Screen

1. Connectez-vous à Blackboard en tant qu'administrateur système.
2. Navigate to Administrator Panel > Integrations > LTI Tool Providers.
3. Click Register LTI 1.3 / LTI Advantage Tool.

If you only see "Register LTI 1.1 Provider", your Blackboard version doesn't support LTI 1.3 yet - upgrade or contact Blackboard support.

Paste the URL

Paste the FastComments registration URL (obtenez-la ici) into the Client ID / Registration URL field (Blackboard's labeling varies by version). Submit.

Blackboard performs the registration handshake with FastComments and shows you a confirmation screen.

Approve and Enable

Blackboard marks newly-registered tools as Approved but excluded by default:

1. Find the FastComments entry in the tool provider list.
2. Open the menu and choose Edit.
3. Set Tool Status to Approved.
4. Under Institution Policies, review what user data is sent (name, email, role). Save.

The tool is now available to instructors when they add content to courses.

Sakai

Sakai prend en charge l'enregistrement dynamique LTI 1.3 sur les versions avec LTI Advantage. Depuis l'Administration Workspace :

1. Connectez-vous en tant qu'administrateur Sakai et ouvrez l'Administration Workspace.
2. Choisissez External Tools > Install LTI 1.3 Tool.
3. Collez l'URL d'enregistrement FastComments (obtenez-le ici) et soumettez.
4. Approuvez l'outil lorsque la négociation se termine.

L'outil apparaît ensuite sous External Tools et peut être ajouté aux sites par leurs gestionnaires.

Schoology

Les instances Schoology Enterprise prennent en charge LTI 1.3, mais la disponibilité de l'enregistrement dynamique varie selon le déploiement. Vérifiez auprès de votre responsable de compte Schoology.

Si l'enregistrement dynamique n'est pas disponible sur votre instance Schoology, vous devrez configurer l'intégration manuellement en utilisant ces points de terminaison :

• 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

Après que Schoology vous ait fourni un Client ID et un Deployment ID, contactez le support FastComments pour enregistrer la configuration sur votre tenant.

Autres plateformes LTI 1.3

Tout LMS qui suit la spécification IMS LTI 1.3 Advantage devrait fonctionner avec la même URL d'enregistrement (obtenez-le ici). Recherchez un paramètre intitulé "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint", ou similaire.

Si votre plateforme ne prend en charge que la configuration manuelle de LTI 1.3, utilisez les quatre points de terminaison listés dans la section Schoology ci‑dessus et contactez le support pour finaliser.

Cette page explique comment ajouter FastComments à un cours Brightspace après qu’un administrateur a enregistré l’outil et créé un déploiement. Si l’outil n’est pas encore enregistré, consultez d’abord le guide d’enregistrement D2L.

FastComments intégré comme sujet d’unité dans Brightspace

Brightspace propose deux expériences de création de contenu : Classic Content et la New Content Experience (également appelée Lessons). Les deux exposent FastComments, mais les chemins de menu diffèrent. Chaque section ci‑dessous couvre les deux lorsque les procédures divergent.

Localiser l’outil FastComments

L’outil FastComments apparaît à deux endroits dans l’éditeur de contenu d’un cours :

1. Le sélecteur d’activités, accessible depuis le bouton Add Existing du module/unité (étiqueté Add Existing Activities dans les anciennes versions de Brightspace). FastComments apparaît directement dans le sélecteur dans les builds actuels de Brightspace ; les versions plus anciennes le placent sous un sous‑menu External Learning Tools. Chaque chemin ajoute FastComments en tant que sujet autonome.
2. La boîte de dialogue Insert Stuff dans l’éditeur HTML, sous LTI Advantage. Cela intègre FastComments en ligne dans un sujet HTML via le flux de deep linking LTI.

Si FastComments n’apparaît dans aucun des deux sélecteurs, le déploiement n’est pas activé pour l’unité organisationnelle (org unit) qui contient le cours. Demandez à votre administrateur Brightspace d’ouvrir Admin Tools > Manage Extensibility > LTI Advantage > outil FastComments > View Deployments, d’ouvrir le déploiement et d’ajouter l’unité organisationnelle du cours (ou une unité parente) sous Org Units.

Ajouter FastComments comme sujet dans un module

Classic Content:

1. Ouvrez le cours et cliquez sur Content dans la barre de navigation.
2. Sélectionnez le module qui doit contenir la discussion (ou créez‑en un via Add a module).
3. Cliquez sur Add Existing (Brightspace plus ancien : Add Existing Activities > External Learning Tools).
4. Dans le sélecteur, cliquez sur FastComments. Brightspace crée un sujet dans le module et vous ramène à la vue du contenu.
5. Cliquez sur le nouveau sujet. Renommez‑le par quelque chose de descriptif comme FastComments Discussion en utilisant l’éditeur de titre inline.

New Content Experience (Lessons) :

1. Ouvrez le cours et cliquez sur Content.
2. Ouvrez l’unité et la leçon qui doivent contenir la discussion.
3. Cliquez sur Add > Existing Activity et sélectionnez FastComments (Brightspace plus ancien : imbriqué sous External Learning Tools).
4. L’activité est ajoutée à la leçon.
5. Cliquez sur le titre de l’activité pour la renommer.

La première fois qu’un utilisateur (instructeur ou étudiant) ouvre le sujet, FastComments initialise le fil pour ce resource link. Le fil est lié à l’ID du resource link, donc renommer ou déplacer le sujet ne change pas le fil chargé.

Intégrer FastComments en ligne dans un sujet HTML

Utilisez ce flux lorsque vous souhaitez que les commentaires apparaissent sous une lecture, une vidéo ou autre contenu à l’intérieur du même sujet plutôt que comme sujet séparé.

1. Ouvrez ou créez un sujet HTML dans le module/la leçon.
2. Cliquez sur Edit HTML pour ouvrir l’éditeur HTML de Brightspace.
3. Placez le curseur à l’endroit où le fil de commentaires doit apparaître.
4. Cliquez sur le bouton Insert Stuff (icône puzzle dans la barre d’outils de l’éditeur).
5. Dans la boîte de dialogue Insert Stuff, descendez jusqu’à LTI Advantage et cliquez sur FastComments.
6. FastComments ouvre un sélecteur de deep linking. Confirmez l’emplacement (les options par défaut conviennent pour les discussions de contenu) ; cliquez sur Insert ou Continue.
7. Brightspace revient à l’éditeur HTML avec un bloc de remplacement représentant le lancement LTI. Cliquez sur Save and Close dans le sujet.

Quand le sujet se charge, Brightspace remplace le bloc de remplacement par un iframe qui lance automatiquement FastComments via LTI. Les étudiants voient le fil de discussion en ligne.

Un seul sujet HTML peut contenir plusieurs intégrations deep‑linked de FastComments. Chaque intégration obtient son propre fil parce que chaque deep link produit un resource link ID distinct.

Sujet de module vs lien rapide intégré

Choisissez l’approche sujet de module lorsque :

• La discussion est l’activité principale pour cette étape du module.
• Vous souhaitez que le sujet apparaisse dans la table des matières de Brightspace, le suivi d’achèvement et Class Progress.

Choisissez l’approche intégration en ligne lorsque :

• Les commentaires doivent être situés sous d’autres contenus sur la même page.
• Vous ne voulez pas d’élément distinct traçable pour l’achèvement dans la table des matières.

Visibilité, brouillon et conditions de publication

Un nouveau sujet FastComments est visible par défaut pour les étudiants. Pour le cacher pendant sa configuration :

1. Dans l’éditeur de contenu, cliquez sur le titre du sujet (Classic) ou sur le menu à trois points de l’activité (New Content Experience).
2. Mettez le statut sur Draft (Classic) ou désactivez la Visibility (New Content Experience).

Les sujets en mode brouillon sont invisibles pour les étudiants. Les instructeurs et assistants voient toujours le sujet avec un badge « Draft ».

Pour restreindre le sujet à un groupe ou une section spécifique :

1. Ouvrez le sujet.
2. Cliquez sur le menu du titre du sujet > Edit Properties In-place (Classic) ou Edit > Restrictions (New Content Experience).
3. Sous Release Conditions, cliquez sur Create.
4. Choisissez Group enrollment ou Section enrollment, sélectionnez le groupe/la section, puis enregistrez.

Les conditions de publication s’ajoutent au mapping de rôles de FastComments. Les étudiants qui ne peuvent pas voir le sujet n’obtiennent pas de lancement LTI.

Ce que voient les étudiants au premier lancement

Lorsqu’un étudiant clique sur le sujet (ou charge un sujet HTML avec une intégration) :

1. Brightspace effectue le lancement LTI 1.3 en arrière‑plan.
2. FastComments reçoit le nom de l’étudiant, son email, l’URL de son avatar et son rôle dans l’LMS, et le connecte automatiquement. Il n’y a pas d’invite de connexion FastComments.
3. Le fil de commentaires pour ce resource link se rend à l’intérieur de l’iframe Brightspace.

Mapping des rôles au lancement :

• Brightspace Administrator devient un administrateur FastComments pour le fil (modération complète, suppression, bannissement et accès à la configuration).
• Brightspace Instructor devient un modérateur FastComments (épingler, masquer, supprimer, bannir).
• Tous les autres rôles (Learner, TeachingAssistant, etc.) deviennent des commentateurs standards.

Les commentaires sont attribués au compte Brightspace de l’étudiant. Si l’étudiant modifie son nom ou son avatar dans Brightspace, le lancement LTI suivant synchronise la modification.

Hauteur de l’iframe et redimensionnement

FastComments émet le postMessage org.imsglobal.lti.frameResize à chaque rendu de fil et lors des changements de contenu (nouveau commentaire, développement des réponses). Brightspace écoute ce message et ajuste la hauteur de l’iframe afin que le fil ne soit pas tronqué et qu’il n’affiche pas de barre de défilement interne.

Si l’iframe reste à une hauteur courte et fixe :

• Confirmez que le cours est chargé en HTTPS. Le listener postMessage de Brightspace rejette les frames en contenu mixte.
• Confirmez qu’aucune extension de navigateur ne bloque le canal postMessage.
• Pour les intégrations en ligne dans un sujet HTML, le HTML environnant ne doit pas envelopper l’iframe dans un conteneur à hauteur fixe. Supprimez tout attribut inline style="height: ..." de l’élément parent.

Particularités spécifiques à Brightspace

L’outil n’apparaît pas dans le sélecteur Add Existing. Le déploiement n’est pas activé pour l’unité organisationnelle de ce cours. Un administrateur doit ajouter l’unité organisationnelle (ou une parente) à la liste Org Units du déploiement. L’enregistrement de l’outil seul ne suffit pas ; le déploiement détermine quels cours voient l’outil.

Mismatch de deployment_id au lancement. FastComments pinne (TOFU) le premier deployment_id qu’il voit pour une inscription. Si un administrateur supprime le déploiement original et en crée un nouveau, les lancements depuis le nouveau déploiement sont rejetés avec une erreur de mismatch de déploiement. La solution est de réenregistrer FastComments (générez une nouvelle URL d’enregistrement (get it here) et lancez à nouveau l’enregistrement dynamique) ; l’ancien enregistrement de configuration est remplacé.

Lancer l’outil mais affichage de « Invalid LTI launch ». Le cours se trouve dans une structure de locataire/organisation différente de celle couverte par le déploiement, ou le déploiement a été désactivé après l’enregistrement. Vérifiez de nouveau Admin Tools > Manage Extensibility > LTI Advantage > FastComments > le bouton Enabled et la liste des unités organisationnelles du déploiement.

Noms et rôles absents dans FastComments. Brightspace envoie les lancements LTI avec les claims NRPS (Names and Role Provisioning Services). Si un cours a été migré depuis un ancien lien LTI 1.1, le lancement peut être dépourvu des claims name et email. Réajoutez le sujet FastComments via Add Existing (ne migrez pas l’ancien lien) afin que le lancement utilise LTI 1.3.

L’intégration affiche un écran de connexion au lieu d’un SSO automatique. Le sujet HTML a été inséré comme un <iframe> simple pointant vers FastComments plutôt que via Insert Stuff > LTI Advantage. Les iframes simples contournent le lancement LTI et envoient les utilisateurs vers la page publique de FastComments. Supprimez l’iframe et réinsérez‑la via le flux Insert Stuff.

Une fois qu'un administrateur a enregistré FastComments en tant qu'outil LTI 1.3 Advantage et approuvé les politiques de l'établissement, les enseignants l'ajoutent aux cours via les points de placement standard de Blackboard. Les étapes exactes diffèrent entre la Vue de cours Ultra et la Vue classique du cours, les deux cas étant décrits ci‑dessous.

Vue de cours Ultra

La Vue de cours Ultra est la valeur par défaut dans Blackboard Learn SaaS depuis 2026.

1. Ouvrez le cours et allez sur la page Contenu du cours.
2. Survolez ou appuyez à l'endroit où vous voulez positionner le fil de commentaires dans la structure et cliquez sur le bouton violet + (Ajouter du contenu).
3. Choisissez Marché de contenu. Le panneau Marché de contenu liste tous les outils LTI approuvés et les placements Building Block pour votre établissement.
4. Trouvez la tuile FastComments et cliquez dessus. Blackboard crée un élément de contenu à la position où vous avez ouvert le menu +.
5. L'élément apparaît dans la structure par défaut comme une entrée « Visible pour les étudiants » pour les enseignants dont le réglage personnel par défaut Masquer aux étudiants est désactivé. Si votre par défaut est Masqué, l'élément est créé masqué et vous activez le sélecteur de visibilité sur la ligne de l'élément lorsque vous êtes prêt.
6. Pour renommer l'élément, cliquez sur le titre dans la structure et tapez un nouveau libellé. Le titre que les étudiants voient dans la structure est indépendant de l'identifiant du fil FastComments, donc le renommage est sans risque à tout moment.

Si vous ne voyez pas Marché de contenu comme option, votre établissement a masqué le placement. Vous pouvez aussi accéder au même sélecteur via Plus d'outils dans le même menu + sous le groupe Outils LTI.

Vue classique du cours

La Vue classique du cours est toujours prise en charge dans Learn SaaS et reste l'expérience principale pour les sites Learn 9.1 auto‑hébergés sur la ligne de correctifs CU de Q4 2024.

1. Ouvrez le cours et entrez dans une Zone de contenu (par exemple, la zone par défaut Informations ou Contenu dans le menu du cours).
2. Activez le Mode édition avec le sélecteur en haut à droite de la page.
3. Cliquez sur Créer du contenu dans la barre d'actions.
4. Sous le sous‑menu Outils d'apprentissage, cliquez sur FastComments. Le sous‑menu Outils d'apprentissage est alimenté par les placements d'outil LTI 1.3 après qu'un administrateur a enregistré l'outil. Si vous ne le voyez pas, consultez la section des problèmes connus ci‑dessous.
5. Dans le formulaire Créer FastComments, réglez :
   • Nom : le libellé que les étudiants voient dans la zone de contenu.
   • Description : texte optionnel affiché au‑dessus du fil intégré.
   • Permettre aux utilisateurs de voir ce contenu : bascule Oui/Non pour la disponibilité.
   • Suivre le nombre de vues : activez si vous voulez les statistiques de vues par élément de Blackboard. FastComments exécute ses propres analyses indépendamment.
   • Restrictions de date et d'heure : fenêtres optionnelles Afficher après / Afficher jusqu'à.
6. Soumettez. L'outil apparaît comme un élément cliquable dans la zone de contenu.

Intégration dans un élément ou un document

Dans les deux vues de cours, les enseignants intègrent FastComments en ligne dans le corps d'un Élement, d'un Document ou de tout champ riche via le bouton LTI Advantage de l'éditeur de contenu.

Vue Ultra :

1. Créez ou modifiez un Document.
2. Cliquez sur Ajouter du contenu à l'intérieur du corps du document à l'endroit où vous voulez que le fil apparaisse.
3. Dans la barre d'outils de l'éditeur, ouvrez le menu Insérer du contenu et cliquez sur Marché de contenu (le point d'entrée LTI Advantage / Deep Linking).
4. Choisissez FastComments. FastComments retourne une charge utile de deep-link et Blackboard insère un bloc intégré dans le corps du document à la position du curseur.
5. Enregistrez le document. Les étudiants voient le fil rendu en ligne lorsqu'ils font défiler la page.

Vue classique :

1. Modifiez n'importe quel élément avec un corps en texte enrichi.
2. Dans la barre d'outils de l'éditeur de contenu, cliquez sur l'icône plus Ajouter du contenu et choisissez Marché de contenu (étiqueté Ajouter du contenu depuis un outil externe dans les anciens CU de Q4 2024).
3. Choisissez FastComments. L'éditeur insère un bloc de remplacement référant la ressource deep-linked.
4. Soumettez l'élément.

Chaque intégration deep-link crée son propre fil FastComments, donc un élément contenant deux blocs FastComments intégrés possède deux flux de commentaires indépendants.

Visibilité, conditions de publication et restrictions de groupe

Les éléments de contenu FastComments se comportent comme n'importe quel autre élément de contenu Blackboard pour les règles de contrôle d'accès qui leur sont appliquées.

• Ultra : cliquez sur le sélecteur de visibilité sur la ligne (Visible pour les étudiants, Masqué aux étudiants, Disponibilité conditionnelle). La disponibilité conditionnelle prend en charge les fenêtres de date/heure, les règles de performance liées aux éléments du carnet de notes et les règles d'appartenance aux groupes de cours.
• Classique : ouvrez le menu contextuel de l'élément et choisissez Publication adaptive ou Publication adaptive : Avancé pour restreindre l'outil par date, appartenance, note ou statut d'examen. Utilisez Définir la disponibilité par groupe sur l'élément pour restreindre à des groupes de cours spécifiques.

FastComments respecte la décision de verrouillage de Blackboard. Si Blackboard masque l'élément pour un étudiant, le lancement LTI n'a jamais lieu pour cet étudiant et il n'apparaît pas dans la vue modérateur.

Comportement dans le carnet de notes

FastComments ne renvoie pas de notes via LTI Advantage Assignment and Grade Services. Aucune colonne de notes n'est créée automatiquement pour les éléments de contenu FastComments.

Si votre instance Blackboard est configurée pour créer automatiquement une colonne de carnet de notes pour chaque nouvel élément de contenu indépendamment des métadonnées de notation, une colonne vide apparaît quand même. Pour la masquer :

• Ultra : ouvrez le Carnet de notes, cliquez sur l'en‑tête de colonne, choisissez Modifier, et désactivez Afficher aux étudiants ainsi que Inclure dans les calculs. Ou utilisez Supprimer si votre établissement autorise la suppression de colonnes pour les éléments non notés.
• Classique : ouvrez le Centre de notes, cliquez sur le chevron de la colonne, choisissez Masquer pour les utilisateurs (on/off), et éventuellement Masquer pour la vue de l'enseignant sous Organisation des colonnes.

Ce que voient les étudiants

Lorsqu'un étudiant ouvre l'élément FastComments ou fait défiler une zone contenant un bloc intégré :

1. Blackboard lance le message LTI 1.3 vers FastComments. L'étudiant est connecté via SSO avec son identité Blackboard (nom, e‑mail, avatar, rôle) sans voir de formulaire de connexion.
2. Le fil de commentaires s'affiche dans l'iframe. Le fil, les réponses imbriquées, les mentions et les réactions sont tous disponibles selon les paramètres du widget de commentaires configurés dans FastComments.
3. Leurs commentaires sont attribués à leur compte Blackboard. Si l'étudiant modifie ensuite son nom ou sa photo dans Blackboard, le lancement suivant mettra à jour le profil FastComments.

Correspondance des rôles de Blackboard vers FastComments :

• Administrateur système et Constructeur de cours correspondent à FastComments admin.
• Enseignant et Assistant pédagogique correspondent à FastComments moderator.
• Étudiant, Invité, et Observateur correspondent à FastComments commenter.

Les modérateurs voient les contrôles de modération (épingler, masquer, bannir, supprimer) directement sur chaque commentaire du fil.

Portée des fils

FastComments scope chaque fil par (hôte Blackboard, ID de cours, ID de lien de ressource). Deux éléments FastComments dans le même cours produisent deux fils. Le même élément copié dans deux environnements de cours (par exemple, via la copie de cours) produit deux fils, car Blackboard émet un nouvel ID de lien de ressource lors de la copie. Pour conserver un fil partagé lors des copies de cours, utilisez le Deep Linking avec un URN de fil explicite configuré dans FastComments avant de lancer la copie.

Problèmes spécifiques à Blackboard

Tuile FastComments manquante dans le menu Créer du contenu (Classique) ou le Marché de contenu (Ultra). L'administrateur a approuvé l'outil mais a laissé une politique d'établissement bloquant le placement concerné. Allez dans Panneau d'administration > Intégrations > Fournisseurs d'outils LTI, modifiez l'entrée FastComments, et confirmez que les placements Outil Contenu de cours (Classique) et Outil Contenu de cours - autoriser les étudiants / Outil de contenu Deep Linking (Ultra) sont activés. Enregistrez et actualisez la page du cours.

Erreur « Tool not configured for this context » ou « Tool is not deployed » au lancement. La portée de déploiement enregistrée lors de l'enregistrement dynamique ne correspond pas au contexte institutionnel auquel appartient le cours. Dans l'entrée du fournisseur d'outils de Blackboard, vérifiez que Deployment ID correspond à ce que FastComments affiche sur sa page de configuration LTI 1.3 pour ce locataire. S'ils diffèrent, supprimez le placement et relancez l'enregistrement dynamique depuis une URL d'enregistrement fraîche (récupérez‑la ici).

La hauteur de l'iframe semble fixe ou le contenu est rogné. Certains locataires Blackboard livrent une Content Security Policy stricte qui bloque le postMessage de redimensionnement d'iframe LTI par défaut. FastComments émet à la fois le message de style Canvas lti.frameResize et le message au format spécifié par l'IMS org.imsglobal.lti.frameResize pour maximiser la compatibilité, mais une surcharge CSP au niveau du locataire bloque l'écouteur parent. Demandez à votre administrateur de confirmer que *.fastcomments.com est sur la liste blanche des outils LTI et qu'aucun en‑tête CSP personnalisé ne supprime les événements postMessage. Le redimensionnement fonctionnera alors sans configuration supplémentaire.

La copie de cours duplique les fils. La copie de cours de Blackboard émet de nouveaux ID de lien de ressource pour les placements LTI, donc les cours copiés commencent avec des fils vides. C'est attendu. Si vous avez besoin que le cours copié hérite du fil original, configurez le Deep Linking avec un URN de fil explicite avant la copie, ou contactez le support FastComments pour remapper les ID de fil en masse.

Un étudiant voit une erreur générique Blackboard au lancement. La cause est une réclamation email manquante ou périmée. Confirmez que la politique d'établissement pour FastComments a Rôle, Nom, et Adresse e‑mail activés sous Champs utilisateur à envoyer. Enregistrez, puis relancez dans une nouvelle session de navigateur.

"Registration token not found, expired, or already used"

Le token dans votre registration URL (obtenez-la ici) est valide pendant 30 minutes et ne peut être utilisé qu'une seule fois. Si votre LMS a mis plus de temps que cela, ou si l'enregistrement a été relancé après avoir réussi, le token sera rejeté. Générez une nouvelle URL sur la page de configuration FastComments LTI 1.3 et recommencez.

"Platform rejected registration"

Votre LMS a refusé la poignée de main d'enregistrement. Les causes les plus courantes :

• Tool already registered with the same client name. Certaines plateformes (notamment D2L) refusent un second enregistrement de "FastComments" tant que le précédent n'a pas été supprimé. Supprimez l'ancien outil dans votre LMS, puis réessayez.
• Wrong field in the LMS. Assurez-vous d'avoir collé l'URL dans le champ registration / tool initiation registration endpoint, et non dans le champ launch URL ou login URL.
• The LMS doesn't actually support Dynamic Registration. Les anciennes versions de Moodle et Blackboard annoncent LTI 1.3 mais n'autorisent que la configuration manuelle. Consultez la documentation de votre plateforme.

"Failed to fetch platform configuration"

FastComments n'a pas pu lire le document openid-configuration de votre LMS. C'est rare et signifie généralement que le LMS a fourni une URL de découverte malformée ou injoignable. Contactez le support de votre LMS.

Launch shows "Configuration not found"

Soit la configuration dans FastComments a été supprimée, soit le lancement provenait d'une paire iss/client_id que nous ne reconnaissons pas. Si vous avez supprimé puis réenregistré, demandez à votre LMS de supprimer puis de réajouter l'outil FastComments afin qu'il obtienne le nouveau client_id.

Launch shows "Deployment not registered"

Vous avez lancé FastComments depuis un déploiement Brightspace/Moodle/Blackboard différent de celui dans lequel il a été lancé initialement. FastComments associe le deployment_id lors du premier lancement comme mesure de sécurité. Pour ajouter un nouveau déploiement sous le même client, contactez le support — nous ajouterons l'ID de déploiement à la configuration.

Launch shows "Unsupported message_type"

Le LMS a envoyé un message LTI que FastComments ne gère pas (par ex. LtiSubmissionReviewRequest). FastComments prend en charge uniquement le lancement standard resource-link et les flux de deep-linking. Contactez-nous si vous avez besoin qu'un type de message spécifique soit ajouté.

Iframe doesn't resize

La plupart des LMS redimensionnent automatiquement les iframes LTI. Si le vôtre ne le fait pas, vérifiez que les paramètres de lancement de la plateforme autorisent l'outil à envoyer des événements postMessage au cadre parent. FastComments émet à la fois des messages de redimensionnement de type Canvas (lti.frameResize) et conformes à la spécification IMS (org.imsglobal.lti.frameResize).