Add Comments to Your LMS via LTI 1.3

1. Meld je aan bij FastComments en ga naar je LTI 1.3-configuratiepagina.
2. (Optioneel) Kies het platform waarvandaan je verbinding maakt in het keuzemenu Platform - dit stelt het weergegeven label in, maar Automatisch detecteren werkt prima.
3. Klik op Genereer URL. Er verschijnt een eenmalige Registratie-URL (geldig gedurende 30 minuten, voor eenmalig gebruik).
4. Open in je LMS het LTI 1.3 Dynamic Registration-scherm en plak de URL in het veld Tool initiation registration endpoint (of gelijkwaardig). Verstuur.
5. Je LMS maakt een callback naar FastComments, wisselt sleutels uit en maakt de integratie aan. De pop-up sluit zichzelf wanneer dat klaar is.
6. Terug in FastComments verschijnt de nieuwe configuratie in de tabel Bestaande configuraties. De tool is nu beschikbaar binnen je LMS-cursussen.

FastComments LTI 1.3 is getest met:

• D2L Brightspace (elke versie met LTI Advantage)
• Moodle 4.0+ (External Tool-plug-in, LTI Advantage)
• Blackboard Learn (SaaS en Ultra)
• Sakai (versies met ondersteuning voor LTI Advantage)
• Schoology (Enterprise, Dynamic Registration waar beschikbaar)

Elke andere LMS die de IMS LTI 1.3 Advantage-specificatie met Dynamic Registration implementeert, zou ook moeten werken - selecteer Other LTI 1.3 platform in het platform-dropdown wanneer je je registratie-URL genereert (haal het hier op).

Canvas LMS gebruikt een andere installatieprocedure (per-developer-key configuration JSON in plaats van Dynamic Registration). Zie de toegewijde Canvas LMS-installatiegids.

Navigeer naar LTI 1.3-configuratie

Meld u aan bij FastComments en ga naar uw LTI 1.3-configuratiepagina.

Als uw account nog geen LTI-toegang heeft, ziet u "LTI not enabled for this account" - neem contact op met support om het op uw plan te activeren.

Kies een platform (optioneel)

Onder Dynamische registratie-URL genereren, gebruikt u de vervolgkeuzelijst Platform om FastComments te vertellen met welk LMS u verbinding maakt:

• D2L Brightspace
• Moodle
• Blackboard Learn
• Sakai
• Schoology
• Andere LTI 1.3-platform

U kunt het ook op Automatisch detecteren laten staan. Het platform wordt tijdens registratie uit de openid-configuration van uw LMS gelezen; de vervolgkeuzelijst vult alleen het weergavelabel voor de resulterende configuratie.

URL genereren

Klik op Genereer URL. FastComments maakt een eenmalige registratietoken aan en toont u een URL die er als volgt uitziet:

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

Kopieer deze. Deze URL:

• Is eenmalig - zodra uw LMS er met succes een oproep naar doet, wordt het registratietoken verbruikt.
• Vervalt na 30 minuten als het niet wordt gebruikt.
• Moet privé worden gehouden - iedereen met de URL kan binnen die 30 minuten een tool registreren voor uw tenant.

Bestaande configuraties

Zodra een registratie succesvol is voltooid, verschijnt de nieuwe configuratie in de tabel Bestaande configuraties op dezelfde pagina, met Platform, Issuer, Client ID en Status. U kunt configuraties uit deze tabel verwijderen als u ze ooit wilt de-registreren.

D2L Brightspace biedt Dynamic Registration via de LTI Advantage-beheerinterface. Je hebt beheerdersrechten nodig.

Open the Registration Screen

1. Meld je aan bij je Brightspace-instantie als beheerder.
2. Navigeer naar Admin Tools > Manage Extensibility > LTI Advantage.
3. Klik op Register Tool. (De directe URL is https://<your-brightspace-host>/d2l/le/ltiadvantage/registrations/create.)

Paste the URL

Je ziet een registratieformulier. Het belangrijkste veld is Tool initiation registration endpoint (sommige Brightspace-versies noemen het "Tool Initiation Registration URL").

Plak de FastComments-registratie-URL (haal het hier op) in dat veld. Laat de andere velden leeg - ze worden automatisch ingevuld door FastComments tijdens de registratie-handshake.

Klik op Register.

Keur de tool goed

Brightspace opent een pop-up die met FastComments communiceert, sleutels ruilt en een bevestigingsscherm toont. De pop-up sluit automatisch wanneer de registratie is voltooid.

De nieuwe tool verschijnt in je LTI Advantage-toollijst. Standaard markeert Brightspace nieuwe tools als disabled - zet de schakelaar naar enabled zodat je cursussen deze kunnen gebruiken.

Voeg een Deployment toe

In Brightspace hebben LTI-tools een deployment nodig voordat ze in cursussen kunnen worden gebruikt:

1. Open de zojuist geregistreerde FastComments-tool.
2. Klik op View Deployments > New Deployment.
3. Geef de deployment een naam (bijv. "FastComments - All Courses"), kies de organisatie-eenheden waarin het beschikbaar moet zijn, en sla op.

Na de eerste start via deze deployment koppelt FastComments de deployment_id aan zijn configuratierecord - volgende starts vanuit een andere deployment onder dezelfde client worden geweigerd, tenzij je opnieuw registreert.

Gebruik je Moodle? We publiceren ook een speciale Moodle-plug-in voor FastComments met een nauwere integratie dan LTI 1.3 (hooks voor synchronisatie van cijfers, uitgebreidere activiteitrapportage, native Moodle-instellingen-UI). Zie de Moodle plug-in installatiehandleiding. De LTI 1.3 flow hieronder is de juiste keuze als je een enkele registratie wilt die ook andere LMSes dekt, of als je Moodle-beheerder geen plug-ins van derden wil installeren.

Moodle 4.0+ ondersteunt LTI 1.3 Dynamic Registration via de External Tool-plug-in.

Open het Toolbeheer-scherm

1. Meld je aan bij Moodle als sitebeheerder.
2. Navigeer naar Site administration > Plugins > Activity modules > External tool > Manage tools.

Plak de URL

Je ziet een kaart met het label Tool URL. Plak de FastComments-registratie-URL (get it here) in het tekstveld en klik op Add LTI Advantage.

Moodle opent een registratiescherm waarin de identiteit van de tool en de gevraagde machtigingen worden weergegeven. Controleer dit en klik op Activate (of Register, afhankelijk van de Moodle-versie).

De popup sluit zodra de registratie is voltooid; de nieuwe FastComments-tool verschijnt in de lijst Tools met de status Active.

Maak het beschikbaar

Standaard voegt Moodle nieuwe tools toe aan de lijst "Course tools", maar toont ze niet in de activiteitskiezer. Om FastComments cursusbreed zichtbaar te maken:

1. Klik op het tandwielpictogram op de FastComments-tegel.
2. Kies onder Tool configuration usage voor Show in activity chooser and as a preconfigured tool.
3. Opslaan.

Docenten kunnen nu FastComments aan elke cursus toevoegen via Add an activity or resource > FastComments.

Blackboard Learn SaaS en Ultra ondersteunen LTI 1.3 Dynamic Registration.

Open het Tool Provider-scherm

1. Meld u aan bij Blackboard als systeembeheerder.
2. Ga naar Administrator Panel > Integrations > LTI Tool Providers.
3. Klik op Register LTI 1.3 / LTI Advantage Tool.

Als u alleen "Register LTI 1.1 Provider" ziet, ondersteunt uw Blackboard-versie LTI 1.3 nog niet - upgrade of neem contact op met Blackboard support.

Plak de URL

Plak de FastComments-registratie-URL (haal het hier op) in het veld Client ID / Registration URL (de benaming in Blackboard varieert per versie). Indienen.

Blackboard voert de registratie-handshake met FastComments uit en toont een bevestigingsscherm.

Goedkeuren en inschakelen

Blackboard markeert nieuw-geregistreerde tools standaard als Approved but excluded:

1. Zoek de FastComments-vermelding in de tool provider-lijst.
2. Open het menu en kies Edit.
3. Stel Tool Status in op Approved.
4. Controleer onder Institution Policies welke gebruikersgegevens worden verzonden (naam, e-mail, rol). Sla op.

De tool is nu beschikbaar voor docenten wanneer zij inhoud aan cursussen toevoegen.

Sakai

Sakai ondersteunt LTI 1.3 Dynamic Registration op releases met LTI Advantage. Vanuit de Administratiewerkruimte:

1. Meld u aan als Sakai-beheerder en open de Administratiewerkruimte.
2. Kies Externe Tools > Installeer LTI 1.3-tool.
3. Plak de FastComments-registratie-URL (haal deze hier) en verstuur.
4. Keur de tool goed wanneer de handshake is voltooid.

De tool verschijnt vervolgens onder Externe Tools en kan door sitebeheerders aan sites worden toegevoegd.

Schoology

Schoology Enterprise-instanties ondersteunen LTI 1.3, maar de beschikbaarheid van Dynamic Registration varieert per implementatie. Neem contact op met uw Schoology-accountmanager.

Als Dynamic Registration niet beschikbaar is op uw Schoology-instantie, moet u de integratie handmatig configureren met behulp van deze endpoints:

• 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

Nadat Schoology u een Client ID en Deployment ID heeft gegeven, neem contact op met FastComments-support om de configuratie voor uw tenant te registreren.

Other LTI 1.3 Platforms

Elke LMS die de IMS LTI 1.3 Advantage-specificatie volgt, zou moeten werken met dezelfde registratie-URL (haal deze hier). Zoek naar een instelling met het label "Dynamic Registration", "Tool Registration URL", "Tool initiation registration endpoint", of iets soortgelijks.

Als uw platform alleen handmatige LTI 1.3-configuratie ondersteunt, gebruik dan de vier endpoints die in de Schoology-sectie hierboven zijn vermeld en neem contact op met de ondersteuning om dit af te ronden.

Deze pagina behandelt het toevoegen van FastComments aan een Brightspace-cursus nadat een beheerder de tool heeft geregistreerd en een deployment heeft gemaakt. Als de tool nog niet is geregistreerd, raadpleeg dan eerst de D2L-registratiehandleiding.

FastComments ingebed als een unit-onderwerp in Brightspace

Brightspace biedt twee content-authoringervaringen: Classic Content en de New Content Experience (ook wel Lessons genoemd). Beide bieden toegang tot FastComments, maar de menupaden verschillen. Elke sectie hieronder behandelt beide waar ze uit elkaar lopen.

Locate the FastComments Tool

De FastComments-tool verschijnt op twee plaatsen binnen een cursuscontenteditor:

1. De activity picker, bereikbaar via de module/unit-knop Add Existing (in oudere Brightspace-versies gelabeld Add Existing Activities). FastComments verschijnt rechtstreeks in de picker in recente Brightspace-builds; oudere versies plaatsen het onder het submenu External Learning Tools. Beide paden voegen FastComments toe als een zelfstandig onderwerp.
2. De dialog Insert Stuff binnen de HTML-editor, onder LTI Advantage. Dit embedt FastComments inline in een HTML-onderwerp via de LTI deep linking-flow.

Als FastComments in geen van beide pickers verschijnt, is de deployment niet ingeschakeld voor de org-eenheid die de cursus bevat. Vraag uw Brightspace-beheerder om Admin Tools > Manage Extensibility > LTI Advantage > FastComments tool > View Deployments te openen, de deployment te openen en de org-eenheid van de cursus (of een bovenliggende org-eenheid) toe te voegen onder Org Units.

Add FastComments as a Topic in a Module

Classic Content:

1. Open de cursus en klik op Content in de navigatiebalk.
2. Selecteer de module die de discussie moet bevatten (of maak er een via Add a module).
3. Klik op Add Existing (oudere Brightspace: Add Existing Activities > External Learning Tools).
4. Klik in de picker op FastComments. Brightspace maakt een onderwerp in de module en keert terug naar de contentweergave.
5. Klik op het nieuwe onderwerp. Hernoem het naar iets beschrijvends zoals FastComments Discussion met de inline-titelbewerker.

New Content Experience (Lessons):

1. Open de cursus en klik op Content.
2. Open de unit en lesson die de discussie moeten bevatten.
3. Klik op Add > Existing Activity en selecteer FastComments (oudere Brightspace: genest onder External Learning Tools).
4. De activity wordt aan de lesson toegevoegd.
5. Klik op de activiteitstitel om deze te hernoemen.

De eerste keer dat een gebruiker (instructeur of student) het onderwerp opent, initialiseert FastComments de thread voor die resource link. De thread is gebonden aan de resource link ID, dus het hernoemen of verplaatsen van het onderwerp verandert niet welke thread wordt geladen.

Embed FastComments Inline in an HTML Topic

Gebruik deze flow wanneer u wilt dat reacties onder een tekst, video of andere inhoud binnen dezelfde topic-pagina verschijnen in plaats van als een apart onderwerp.

1. Open of maak een HTML-onderwerp in de module/lesson.
2. Klik op Edit HTML om de Brightspace HTML-editor te openen.
3. Plaats de cursor waar de comment-thread moet verschijnen.
4. Klik op de knop Insert Stuff (puzzle-piece-icoon in de editorbalk).
5. Scroll in de Insert Stuff-dialog naar LTI Advantage en klik op FastComments.
6. FastComments opent een deep linking-picker. Bevestig de plaatsing (de standaardopties werken voor contentdiscussies); klik op Insert of Continue.
7. Brightspace keert terug naar de HTML-editor met een placeholderblok dat de LTI-launch vertegenwoordigt. Klik op Save and Close in het onderwerp.

Wanneer het onderwerp laadt, vervangt Brightspace de placeholder door een iframe dat automatisch FastComments lanceert via LTI. Studenten zien de discussie-thread inline.

Een enkel HTML-onderwerp kan meerdere deep-linked FastComments-embeds bevatten. Elke embed krijgt zijn eigen thread omdat elke deep link een unieke resource link ID oplevert.

Module Topic vs Inline Quicklink

Kies de module topic-aanpak wanneer:

• De discussie de primaire activiteit is voor die stap in de module.
• U wilt dat het onderwerp verschijnt in Brightspace's inhoudsopgave, voltooiingstracking en Class Progress.

Kies de inline embed-aanpak wanneer:

• Reacties onder andere content op dezelfde pagina moeten staan.
• U geen afzonderlijk, voor voltooiing traceerbaar item in de inhoudsopgave wilt.

Visibility, Draft, and Release Conditions

Een nieuw FastComments-onderwerp is standaard zichtbaar voor studenten. Om het te verbergen terwijl u het instelt:

1. Klik in de contenteditor op de onderwerpstitel (Classic) of op het drie-puntjesmenu van de activity (New Content Experience).
2. Zet de status op Draft (Classic) of schakel Visibility uit (New Content Experience).

Draft-onderwerpen zijn onzichtbaar voor studenten. Instructeurs en TA's zien ze nog steeds met een "Draft"-badge.

Om het onderwerp te beperken tot een specifieke groep of sectie:

1. Open het onderwerp.
2. Klik op het onderwerptitelenesmenu > Edit Properties In-place (Classic) of Edit > Restrictions (New Content Experience).
3. Klik onder Release Conditions op Create.
4. Kies Group enrollment of Section enrollment, selecteer de groep/sectie en sla op.

Release conditions stapelen bovenop FastComments' eigen rolmapping. Studenten die het onderwerp niet kunnen zien, krijgen geen LTI-launch.

What Students See on First Launch

Wanneer een student op het onderwerp klikt (of een HTML-onderwerp met een embed laadt):

1. Brightspace voert de LTI 1.3-launch op de achtergrond uit.
2. FastComments ontvangt de naam van de student, e-mailadres, avatar-URL en LMS-rol, en logt ze automatisch in. Er verschijnt geen FastComments-inlogprompt.
3. De comment-thread voor die resource link wordt weergegeven binnen het Brightspace-iframe.

Rolmapping bij launch:

• Brightspace Administrator wordt een FastComments admin voor de thread (volledige moderatie, verwijderen, verbannen en configuratietoegang).
• Brightspace Instructor wordt een FastComments moderator (vastzetten, verbergen, verwijderen, verbannen).
• Alle andere rollen (Learner, TeachingAssistant, etc.) worden standaard commenters.

Reacties worden toegeschreven aan het Brightspace-account van de student. Als de student zijn naam of avatar in Brightspace wijzigt, synchroniseert de volgende LTI-launch de wijziging.

Iframe Height and Resize

FastComments stuurt de org.imsglobal.lti.frameResize postMessage bij elke thread-render en bij inhoudswijzigingen (nieuwe reactie, uitklappen van antwoorden). Brightspace luistert naar dit bericht en past de iframe-hoogte aan zodat de thread niet wordt afgesneden en er geen interne scrollbar verschijnt.

Als de iframe op een vaste korte hoogte blijft:

• Controleer of de cursus over HTTPS wordt geladen. De postMessage-listener van Brightspace wijst mixed-content-frames af.
• Controleer of geen browserextensie het postMessage-kanaal blokkeert.
• Voor inline-embeds in een HTML-onderwerp mag de omliggende HTML het iframe niet in een container met vaste hoogte plaatsen. Verwijder eventuele inline style="height: ..." van het bovenliggende element.

Brightspace-Specific Gotchas

Tool not showing in the Add Existing picker. De deployment is niet ingeschakeld voor de org-eenheid van deze cursus. Een beheerder moet de org-eenheid (of een ouder) toevoegen aan de Org Units-lijst van de deployment. Alleen het registreren van de tool is niet genoeg; de deployment bepaalt voor welke cursussen de tool zichtbaar is.

deployment_id mismatch on launch. FastComments TOFU-pins de eerste deployment_id die het ziet voor een registratie. Als een beheerder de oorspronkelijke deployment verwijdert en een nieuwe aanmaakt, worden launches vanaf de nieuwe deployment geweigerd met een deployment mismatch-fout. De oplossing is om FastComments opnieuw te registreren (genereer een nieuwe registratie-URL (haal deze hier op) en voer Dynamic Registration opnieuw uit); het oude configuratieregister wordt vervangen.

Tool launches but shows "Invalid LTI launch". De cursus bevindt zich in een andere tenant/org-structuur dan de deployment dekt, of de deployment is uitgeschakeld na registratie. Controleer opnieuw Admin Tools > Manage Extensibility > LTI Advantage > FastComments > de Enabled-schakelaar en de org-eenhedenlijst van de deployment.

Names and roles missing inside FastComments. Brightspace verzendt LTI-launches met Names and Role Provisioning Services (NRPS)-claims. Als een cursus is geüpgraded van een oudere LTI 1.1-link, ontbreken mogelijk de name- en email-claims in de launch. Voeg het FastComments-onderwerp opnieuw toe via Add Existing (migreer de oude link niet) zodat de launch LTI 1.3 gebruikt.

Embed shows a login screen instead of auto-SSO. Het HTML-onderwerp is ingevoegd als een gewoon <iframe> dat naar FastComments wijst in plaats van via Insert Stuff > LTI Advantage. Gewone iframes slaan de LTI-launch over en brengen gebruikers naar de publiek toegankelijke FastComments-pagina. Verwijder het iframe en voeg het opnieuw in via de Insert Stuff-flow.

Zodra een beheerder FastComments heeft geregistreerd als een LTI 1.3 Advantage-tool en de institutionele beleidsregels heeft goedgekeurd, voegen docenten het toe aan cursussen via de standaard Blackboard-plaatsingspunten. De exacte stappen verschillen tussen Ultra Course View en Original Course View, dus beide worden hieronder behandeld.

Ultra Course View

Ultra Course View is de standaard in Blackboard Learn SaaS vanaf 2026.

1. Open de cursus en ga naar de pagina Course Content.
2. Zweef of tik waar je de discussiedraad in de inhoudsopgave wilt plaatsen en klik op de paarse + (Add content) knop.
3. Kies Content Market. Het Content Market-paneel toont elk goedgekeurd LTI-gereedschap en Building Block-plaatsing voor uw instelling.
4. Zoek de tegel FastComments en klik erop. Blackboard maakt een inhoudsitem op de positie waar je het +-menu opende.
5. Het item verschijnt standaard in de inhoudsopgave als een vermelding "Visible to students" voor docenten die Hide from students uit hebben staan als hun persoonlijke standaard. Als jouw standaard Hidden is, wordt het item verborgen aangemaakt en zet je de zichtbaarheidsschakelaar op de itemrij aan wanneer je er klaar voor bent.
6. Om het item een andere naam te geven, klik je op de titel in de inhoudsopgave en typ je een nieuw label. De titel die studenten in de inhoudsopgave zien is onafhankelijk van de FastComments-threadidentifier, dus hernoemen is op elk moment veilig.

Als je Content Market niet als optie ziet, heeft jouw instelling de plaatsing verborgen. Je bereikt dezelfde keuze ook via More tools in hetzelfde +-menu onder de groep LTI Tools.

Original Course View

Original Course View wordt nog steeds ondersteund in Learn SaaS en blijft de primaire ervaring voor zelf-gehoste Learn 9.1-sites op de Q4 2024 CU-releaselijn.

1. Open de cursus en ga naar een Content Area (bijvoorbeeld het standaard Information of Content-gebied in het cursusmenu).
2. Zet Edit Mode aan met de schakelaar rechtsboven op de pagina.
3. Klik op Build Content in de actiebalk.
4. Klik onder het submenu Learning Tools op FastComments. Het Learning Tools-submenu wordt gevuld vanuit LTI 1.3-toolplaatsingen nadat een beheerder de tool registreert. Als je het niet ziet, zie de sectie met veelvoorkomende problemen hieronder.
5. Op het formulier Create FastComments, stel in:
   • Name: het label dat studenten in het contentgebied zien.
   • Description: optionele tekst die boven de ingesloten draad wordt getoond.
   • Permit Users to View this Content: Ja/Nee beschikbaarheidsschakelaar.
   • Track Number of Views: inschakelen als je Blackboard's statistieken per item wilt. FastComments draait zijn eigen analytics onafhankelijk.
   • Date and Time Restrictions: optionele Display After / Display Until vensters.
6. Verzenden. De tool verschijnt als een klikbaar item in het contentgebied.

Embedding Inside an Item or Document

In beide course views integreren docenten FastComments inline in de body van een Item, Document of elk rich-textveld via de LTI Advantage-knop in de Content Editor.

Ultra Course View:

1. Maak of bewerk een Document.
2. Klik op Add content in de documenttekst waar je de draad wilt laten verschijnen.
3. Open in de editorwerkbalk het menu Insert content en klik op Content Market (de LTI Advantage / Deep Linking toegangspoort).
4. Kies FastComments. FastComments retourneert een deep-link payload en Blackboard plaatst een ingesloten blok in de documenttekst op de cursorpositie.
5. Sla het document op. Studenten zien de draad inline gerenderd terwijl ze er langs scrollen.

Original Course View:

1. Bewerk elk item met een rich-text body.
2. Klik in de Content Editor-werkbalk op het plus-icoon Add Content en kies Content Market (gelabeld Add Content from External Tool in oudere Q4 2024 CUs).
3. Kies FastComments. De editor voegt een tijdelijke plaatsaanduiding toe die verwijst naar de deep-linked resource.
4. Verstuur het item.

Elke deep-link embed maakt zijn eigen FastComments-thread, dus een Item met twee ingesloten FastComments-blokken heeft twee onafhankelijke commentstreamen.

Visibility, Release Conditions, and Group Restrictions

FastComments-inhoudsitems gedragen zich als elk ander Blackboard-inhoudsitem wat betreft de toegangscontroles die erop worden toegepast.

• Ultra: klik op de zichtbaarheidsschakelaar op de rij (Visible to students, Hidden from students, Conditional availability). Conditional availability ondersteunt datum/tijd-vensters, prestatieregels tegen gradebook-items en ledenregels tegen cursusgroepen.
• Original: open het contextmenu van het item en kies Adaptive Release of Adaptive Release: Advanced om de tool te beperken op datum, lidmaatschap, cijfer of beoordelingsstatus. Gebruik Set Group Availability op het item om te beperken tot specifieke cursusgroepen.

FastComments respecteert wat het Blackboard-poort besluit. Als Blackboard het item voor een student verbergt, gebeurt de LTI-launch nooit voor die student en verschijnt die niet in de moderatorweergave.

Gradebook Behavior

FastComments rapporteert geen cijfers terug via LTI Advantage Assignment and Grade Services. Er wordt geen cijferkolom automatisch aangemaakt voor FastComments-inhoudsitems.

Als jouw Blackboard-tenant is geconfigureerd om automatisch een gradebook-kolom aan te maken voor elk nieuw inhoudsitem ongeacht grading-metadata, verschijnt er toch een lege kolom. Om deze te verbergen:

• Ultra: open het Gradebook, klik op de kolomkop, kies Edit, en zet Show to students plus Include in calculations uit. Of gebruik Delete als jouw instelling het verwijderen van kolommen voor niet-gecodeerde items toestaat.
• Original: open het Grade Center, klik op de chevron van de kolom, kies Hide from Users (on/off), en optioneel Hide from Instructor View onder Column Organization.

What Students See

Wanneer een student het FastComments-item opent of naar een ingesloten blok scrolt:

1. Blackboard lanceert het LTI 1.3-bericht naar FastComments. De student wordt aangemeld via SSO met hun Blackboard-identiteit (naam, e-mail, avatar, rol) zonder een inlogformulier te zien.
2. De commentdraad rendert in de iframe. Threading, reacties, mentions en reacties zijn allemaal beschikbaar op basis van de commentwidget-instellingen geconfigureerd in FastComments.
3. Hun opmerkingen worden toegeschreven aan hun Blackboard-account. Als de student later zijn naam of foto in Blackboard aanpast, werkt de volgende launch het FastComments-profiel bij.

Rolmapping van Blackboard naar FastComments:

• System Administrator en Course Builder mappen naar FastComments admin.
• Instructor en Teaching Assistant mappen naar FastComments moderator.
• Student, Guest, en Observer mappen naar FastComments commenter.

Moderators zien moderatiecontroles (pin, hide, ban, delete) inline bij elke opmerking in de draad.

Thread Scoping

FastComments scopeert elke thread by (Blackboard host, course ID, resource link ID). Twee FastComments-items in dezelfde cursus produceren twee threads. Hetzelfde item gekopieerd naar twee cursusomgevingen (bijvoorbeeld via course copy) produceert twee threads, omdat Blackboard tijdens de kopie een nieuw resource link ID uitgeeft. Om een gedeelde thread te behouden over cursuskopieën, gebruik Deep Linking met een expliciete thread URN geconfigureerd in FastComments vóór het starten van de kopie.

Blackboard-Specific Gotchas

FastComments-tegel ontbreekt in het Build Content-menu (Original) of Content Market (Ultra). De beheerder heeft de tool goedgekeurd maar een institutioneel beleid achtergelaten dat de relevante plaatsing blokkeert. Ga naar Administrator Panel > Integrations > LTI Tool Providers, bewerk de FastComments-vermelding en bevestig dat zowel Course Content Tool (Original) als Course Content Tool - allow students / Deep Linking content tool (Ultra) plaatsingen zijn ingeschakeld. Sla op en vernieuw de cursuspagina.

"Tool not configured for this context" of "Tool is not deployed" fout bij lancering. De deployment scope die tijdens dynamische registratie is geregistreerd, komt niet overeen met de institutionele context waartoe de cursus behoort. Controleer in de tool provider-vermelding van Blackboard of de Deployment ID overeenkomt met wat FastComments op zijn LTI 1.3 Configuration-pagina voor deze tenant toont. Als ze verschillen, verwijder dan de plaatsing en voer dynamische registratie opnieuw uit vanaf een verse registratie-URL (get it here).

Iframe-hoogte lijkt vast of inhoud wordt afgekapt. Sommige Blackboard-tenants leveren een strikte Content Security Policy die de standaard LTI iframe-resize postMessage blokkeert. FastComments verzendt zowel het Canvas-stijl lti.frameResize-bericht als het IMS-spec-form org.imsglobal.lti.frameResize-bericht om compatibiliteit te maximaliseren, maar een tenant-niveau CSP-override blokkeert de parent-listener. Vraag je beheerder te bevestigen dat *.fastcomments.com op de LTI-tool-allowlist staat en dat geen aangepaste CSP-header postMessage-events wegfiltert. Daarna werkt het resizen zonder verdere configuratie.

Course copy dupliceert threads. Blackboard course copy geeft nieuwe resource link IDs uit voor LTI-plaatsingen, dus gekopieerde cursussen starten met lege threads. Dit is verwacht gedrag. Als je wilt dat de gekopieerde cursus de oorspronkelijke thread erft, stel dan Deep Linking in met een expliciete thread URN vóór het kopiëren, of neem contact op met FastComments-ondersteuning om thread-ID's in bulk te remappen.

Student ziet een generieke Blackboard-fout bij lancering. De oorzaak is een ontbrekende of verouderde email-claim. Bevestig dat het institutionele beleid voor FastComments Role, Name, en Email Address heeft ingeschakeld onder User Fields to Send. Sla op en start daarna opnieuw in een verse browsersessie.

"Registratietoken niet gevonden, verlopen of al gebruikt"

Het token in uw registratie-URL (haal het hier op) is 30 minuten geldig en kan slechts één keer worden gebruikt. Als uw LMS daar langer over deed, of als de registratie opnieuw werd geprobeerd nadat deze al geslaagd was, wordt het token geweigerd. Genereer een nieuwe URL op de FastComments LTI 1.3 Configuration-pagina en begin opnieuw.

"Platform rejected registration"

Uw LMS weigerde de registratie-handshake. De meest voorkomende oorzaken:

• Tool already registered with the same client name. Sommige platforms (vooral D2L) weigeren een tweede registratie van "FastComments" totdat de vorige is verwijderd. Verwijder het oude tool in uw LMS en probeer het opnieuw.
• Wrong field in the LMS. Zorg ervoor dat u de URL hebt geplakt in het veld registration / tool initiation registration endpoint, niet in het launch URL- of login URL-veld.
• The LMS doesn't actually support Dynamic Registration. Oudere versies van Moodle en Blackboard adverteren LTI 1.3 maar staan alleen handmatige configuratie toe. Controleer de documentatie van uw platform.

"Failed to fetch platform configuration"

FastComments kon het openid-configuration-document van uw LMS niet lezen. Dit is zeldzaam en betekent meestal dat het LMS een foutieve of onbereikbare discovery URL heeft opgegeven. Neem contact op met de ondersteuning van uw LMS.

Launch shows "Configuration not found"

Ofwel is de configuratie in FastComments verwijderd, of de launch kwam van een iss/client_id-paar dat we niet herkennen. Als u de configuratie hebt verwijderd en opnieuw hebt geregistreerd, geef uw LMS de opdracht om de FastComments-tool te verwijderen en opnieuw toe te voegen zodat deze de nieuwe client_id krijgt.

Launch shows "Deployment not registered"

U hebt FastComments gestart vanuit een Brightspace/Moodle/Blackboard-deployment die verschilt van degene waarin het voor het eerst werd gestart. FastComments legt de deployment_id vast bij de eerste start als beveiligingscontrole. Om een nieuwe deployment onder dezelfde client toe te voegen, neem contact op met support - wij voegen de deployment ID toe aan de configuratie.

Launch shows "Unsupported message_type"

Het LMS stuurde een LTI-bericht dat FastComments niet afhandelt (bijv. LtiSubmissionReviewRequest). FastComments ondersteunt alleen de standaard resource-link launch- en deep-linking-flows. Neem contact op als u een specifiek berichttype toegevoegd wilt hebben.

Iframe doesn't resize

De meeste LMS'en schalen LTI-iframes automatisch. Als dat bij uw LMS niet het geval is, controleer dan of de launch-instellingen van het LMS toestaan dat de tool postMessage-events naar het ouderframe stuurt. FastComments stuurt zowel Canvas-stijl (lti.frameResize) als IMS-specificatie (org.imsglobal.lti.frameResize) resize-berichten.