Puzzel.org in Canvas
Voeg een Puzzel-activiteit toe aan een Canvas-cursus, en de score van elke leerling komt vanzelf terug in de cijferlijst van die cursus. Je beheerder koppelt Puzzel.org één keer aan Canvas; daarna kan elke docent op school het gebruiken.
Canvas
Canvas registreert Puzzel.org zelf: je beheerder plakt één URL en doorloopt een korte wizard. Docenten voegen daarna activiteiten toe vanuit hun eigen cursus, en leerlingen spelen zonder Puzzel.org-account.
- De score, van de punten die je koos
- Hun beste poging, als ze opnieuw spelen
- Wat elke leerling heeft geantwoord
- Je resultaten per activiteit en per leerling
Canvas één keer koppelen
Canvas noemt dit dynamische registratie: je geeft het systeem één URL en het haalt zelf alles op wat het nodig heeft bij Puzzel.org. Geen sleutels of geheimen om uit te wisselen, niets om te downloaden.
- Open Apps in je Canvas-account Kies in Global Navigation voor Admin en daarna de naam van je account, en vervolgens Apps. Druk op het tabblad Manage op Install a New App. Admin → je account → Apps → Manage → Install a New App
- Kies LTI 1.3 en Dynamic Registration Selecteer LTI version 1.3, zet Install Method op Dynamic Registration, plak de URL hierboven en druk op Next. LTI version 1.3 → Install Method: Dynamic Registration
- Laat de rechten ingeschakeld Hiermee kan Puzzel.org de cijferlijstkolom aanmaken voor een activiteit die een docent toevoegt, en er scores in schrijven. Zet je ze uit, dan installeert de app nog steeds, maar bereikt er nooit een score Canvas. Set Permissions
- Namen van leerlingen delen “User's name only” is genoeg. Scores komen ook goed binnen bij “None (Anonymized)”, maar dan zien docenten in hun Puzzel.org-resultaten anonieme spelers in plaats van namen. Puzzel.org vraagt Canvas nooit om je klassenlijsten. User Data Shared With This App
- Kies waar docenten het vinden Schakel de placements in waar docenten Puzzel.org moeten vinden: die voor het kiezen van content bij een opdracht, en de knop in de tekstverwerker als je hem daar ook wilt. Bij elke placement staat een informatie-icoon dat precies laat zien waar hij in Canvas verschijnt. Set Placements
- Controleren, installeren en instellen wie het mag gebruiken Geef het eventueel een bijnaam en druk daarna op Install App. Puzzel.org verschijnt op het tabblad Manage, en daar kies je ook of het beschikbaar is voor het hele account of alleen voor bepaalde cursussen. Review and install → Manage
https://puzzel.org/lti/register Dit is het enige dat je plakt. Het is geen pagina om in een browser te openen: het geeft Canvas de configuratie door.
Een Canvas-accountbeheerder met de rechten “LTI Registrations - Manage”, en een Puzzel.org-account om halverwege mee in te loggen — maak dat account op puzzel.org voordat je begint, niet halverwege de wizard. Canvas Free-for-Teacher-accounts kunnen de developer key die hiervoor nodig is niet aanmaken, dus LTI 1.3 is voor hen niet beschikbaar — de eenvoudigere route onderaan deze pagina wel.
Nadat je de URL hebt geplakt, opent Canvas een Puzzel.org-venster binnen de wizard — ons scherm, niet een scherm van Canvas. Het noemt de naam van de Canvas-omgeving die het gaat koppelen: log in, druk op Verbinden, en Canvas gaat verder waar het gebleven was. Ben je in een ander tabblad ingelogd bij Puzzel.org, dan werkt dat niet door in dit venster — e-mailadres en wachtwoord is dus de betrouwbaarste manier om in te loggen.
Maakt niet uit welke — dat van de school zelf, of van de docent die je hierom vroeg. We noteren het alleen om te weten wie de koppeling heeft ingesteld. Het wordt nooit een gedeelde login en het bezit niets: docenten loggen later elk met hun eigen account in, in hun eigen cursus.
Activiteit toevoegen →Dan is de URL in het oudere LTI 1.1-scherm beland — External Apps, + App, By URL — dat alleen een XML-bestand accepteert en niets anders. De registratie-URL is geen XML, dus Canvas weigert hem. Er is aan geen van beide kanten iets stuk; het is gewoon het verkeerde scherm.
Gebruik in plaats daarvan Apps → Manage → Install a New App, zoals hierboven. Bedoelde je juist de eenvoudigere route zonder cijferlijst, gebruik dan de config-URL onderaan deze pagina.
Instructure beschrijft deze wizard scherm voor scherm, met een afbeelding van elk scherm. Dezelfde stappen, van hun kant bekeken.
Lees de Canvas-handleiding →Oudere installaties registreren een tool met de hand. Dit zijn de drie URL's waar daarbij om wordt gevraagd. Zowel de redirect URI als de target link URI zijn de launch-URL, en de publieke sleutels worden opgehaald bij de JWKS-URL — er is nergens een geheim om te plakken.
https://puzzel.org/lti/login https://puzzel.org/lti/launch https://puzzel.org/api/lti/jwks Voeg een activiteit toe aan je cursus
Zodra je beheerder Canvas heeft gekoppeld, staat Puzzel.org klaar in elke cursus. Je logt één keer in met je eigen Puzzel.org-account, kiest de activiteit en het aantal punten, en Canvas maakt zelf de cijferlijstkolom aan.
- Maak er een opdracht van Ga in je cursus naar Assignments en voeg er een toe. Zet Submission Type op External Tool en druk op Find. Assignments → + Assignment → Submission Type: External Tool → Find
- Kies Puzzel.org uit de lijst Canvas opent een Puzzel.org-venster binnen de opdracht. Het is een eigen venster van Puzzel.org, geen Canvas-scherm, en daarom vraagt het wie je bent. Find → Puzzel.org
- Log in met je eigen account Alleen de eerste keer, en hier gaan de twee logins uiteen: dit account is van jou, niet het account waarmee je beheerder Canvas heeft gekoppeld. Docenten loggen elk in als zichzelf en zien hun eigen activiteiten. Nog geen account? Het venster heeft een registratielink — maak er een aan in het tabblad dat opent, en kom daarna terug om in te loggen.
- Kies je activiteit en het aantal punten Kies een van je activiteiten en bevestig. Wat je bij Points invult, bepaalt hoeveel de activiteit waard is, en de cijferlijstkolom wordt aangemaakt zodra je de opdracht opslaat.
- Leerlingen openen het in Canvas Ze drukken op de opdracht en spelen meteen: geen Puzzel.org-account om aan te maken, geen naam om in te typen, geen code. De score komt in de cijferlijst zodra ze klaar zijn, en spelen ze opnieuw, dan telt hun beste poging.
Je eigen poging krijgt nooit een cijfer: open je de activiteit als docent, dan speel je hem op dezelfde manier, maar er wordt niets in de cijferlijst geschreven. Elke activiteit met een score per leerling werkt; team- en kamerspel niet. Scores versturen is onderdeel van een betaald abonnement op het account dat de activiteit bezit — zonder abonnement werkt de activiteit nog steeds in Canvas, alleen zonder cijfer.
De eenvoudigere route, cursus voor cursus
Canvas laat een docent een externe app toevoegen aan één enkele cursus, zonder IT erbij te betrekken. Puzzel.org staat dan in de tekstverwerker van die cursus: druk erop, kies een van je activiteiten, en hij wordt op de pagina voor je leerlingen geplaatst. Dit is de oudere LTI 1.1-manier, en die heeft geen cijferlijst.
https://puzzel.org/lti.xml Noem het Puzzel.org, laat Consumer Key en Shared Secret leeg, en plak de config-URL. Dit is het ene scherm waar een XML-config-URL wél het juiste antwoord is.
Alles wat je op deze manier toevoegt, blijft werken nadat je beheerder de school koppelt, en wat je vanaf dan toevoegt, stuurt ook zijn scores.
- Activiteiten spelen binnen de cursuspagina
- Resultaten blijven in Puzzel.org, onder je eigen account
- Geen cijferlijstkolom, geen scores in Canvas
- Canvas vertelt Puzzel.org niet wie de leerling is
Welke leerlinggegevens ontvangt en bewaart Puzzel.org voor cijfers?
Lees het privacybeleid →- Er komt alleen binnen wat nodig is
Het ID van de leerling in Google Classroom of het systeem van je school — met naam en e-mailadres alleen als dat systeem die deelt. Nooit klassenlijsten, andere leerlingen of ander lesmateriaal.
- Er gaat alleen de score naar buiten
Berekend op onze servers uit de gegeven antwoorden, en verstuurd naar de cijferlijstregel van die ene leerling. Niets anders.
- Verwijderd zodra je stopt
Het record van een leerling verdwijnt zodra de docent de synchronisatie van de activiteit stopzet of de activiteit verwijdert. Al verzonden scores blijven in de cijferlijst van de school staan.
- De school houdt de regie
Jouw school bepaalt wat er met de gegevens van haar leerlingen gebeurt; Puzzel.org verwerkt ze alleen namens de school.
Laat ons weten bij welke stap en wat Canvas zei, en we lossen het samen met je op — screenshots zijn welkom.