Daarna druk je op de knop 'aanmaken'. Je zult een pop-up zien met de share-code van de klas. Deze kun je doorsturen naar leerlingen om ze de mogelijkheid te geven de klas toe te treden. Verder kan je op de link duwen en deze doorsturen. Na inloggen kunnen de studenten deze link in hun zoekbalk plakken waarna de code voor hen automatisch ingevuld wordt.

Nu heb je een nieuwe klas aangemaakt. Als je drukt op de naam van de klas kun je die beheren. Hieronder wordt er daar dieper op ingegaan.

Beheren

Leerlingen toevoegen

Leerlingen kunnen de klas toetreden door naar hun eigen klasoverzichtspagina te gaan en de deelcode in te vullen (Zie handleiding voor studenten). Eens ze dat hebben gedaan kun je de leerling weigeren of accepteren.

Leerkrachten toevoegen

Om leerkrachten toe te voegen moet je hun gebruikersnaam hebben. Deze kunnen ze vinden door bovenaan op het profiel icoontje te drukken.

Vul de gebruikersnaam in en druk op de knop 'uitnodigen'.

De uitgenodigde leerkracht kan de uitnodiging nu vinden in de overzichtspagina van zijn of haar klassen.

Opdrachten

Binnen een klas is het mogelijk om opdrachten aan te maken. Aan een opdracht hangt een leerpad vast. De leerlingen kunnen dan (in groep) alle onderdelen oplossen binnen het leerpad.

Aanmaken

Het aanmaken van een opdracht kan op twee manieren. Via de pagina van een leerpad of via het tabblad 'opdrachten'. Beide komen op hetzelfde neer.

We beginnen met te navigeren naar een leerpad. Daar vinden we onderaan links op de pagina een knop 'Als opdracht geven'. Als we hier op drukken komen we terecht op de pagina waar we verdere info over de opdracht kunnen ingeven.

Op deze pagina geven we een titel, klas, deadline en beschrijving in. Ook kunnen we op deze pagina de leerlingen in groepen plaatsen. Dan drukken we op de knop 'aanmaken'.

Zo komen we terecht op de overzichtspagina van de opdracht die we net hebben aangemaakt.

Hier kan je de opdracht verder finetunen door een beschrijving en deadline toe te voegen. Druk op het potloodje om de opdracht te bewerken en op het save-knopje om de veranderingen op te slaan.

Een opdracht kan gegeven worden aan de hele klas of aan enkele leden van de klas. Dit kan door op het potloodje te drukken in de tabel rechts op de pagina. In deze tabel komen alle groepen te staan. De vooruitgang van elke groep wordt voorgesteld door een balkje met het percentage van de opdracht die ze al gemaakt hebben. Groepen kunnen willekeurig samengesteld worden of handmatig.

Druk op Groepeer willekeurig om de studenten willekeurig in groepen te verdelen. Kies hierbij een groepsaantal en druk op genereren. Klap de groep open om te zien welke studenten ze bevat.

Om handmatig groepen samen te stellen kan je op het plusje duwen om extra groepen aan te maken. Sleep de studenten naar de groep waarin je ze wilt steken.

Beheren

Op de pagina van een opdracht kunnen we die beheren. We kunnen het leerpad bekijken, de opdracht verwijderen en kijken naar de vooruitgang van de groepen.

Vooruitgang

Door te drukken op op de knop 'leerpad' komen we terecht op de pagina van het leerpad. Daar kunnen we links ervoor kiezen om de voortgang van een bepaalde groep te bekijken. Zo kunnen we voor de leerobjecten waar een indiening mogelijk is die indiening bekijken.

Leerpaden

Leerpaden zijn trajecten die bestaan uit leerobjecten. Een leerobject kan een stuk tekst zijn met al dan niet een vraag op het einde. De leerobjecten in een leerpad volgen vaak een logische volgorde of gedachtestroom. Van deze leerpaden kun je opdrachten maken.

Zelf leerpaden aanmaken

De kracht van de website komt echt naar boven wanneer je zelf leerpaden leert aanmaken. Dit is echter enkel aangeraden is voor geavanceerde gebruikers. Daarmee wordt bedoeld: gebruikers die ietwat tech-savy zijn. Het is aangeraden om ervaring te hebben met bestanden zippen, JSON en markdown. Dit zijn allemaal zeer simpele dingen die je makkelijk zelf kunt leren online, de rest wordt hier uitgelegd.

Leerpaden en leerobjecten

Een leerpad kun je vergelijken met een uitdeelbundel. Een leerobject kun je dan weer zien als een hoofdstuk/pagina/vraag uit die bundel. Met andere woorden: een leerpad bestaat uit een lijst van leerobjecten. Deze leerobjecten kunnen gewoon volgen op mekaar, of je kunt er een ingewikkeldere structuur in steken. Bijvoorbeeld: als een leerling op een reflectievraag het foute antwoord geeft, kun je die naar het ene leerobject sturen met wat extra herhalingsvragen of bij een juist antwoord gewoon naar het volgende hoofdstuk. Ben je nu al niet meer mee? Geen zorgen, hieronder wordt op al dit dieper ingegaan.

Leerobjecten 101

Zoals hierboven gezegd is een leerobject een pagina uit een leerpad. Hieronder zie je een lijst van leerobjecten uit een leerpad.

Maar hoe ziet de structuur er nu uit voor een eigen leerpad? Wel, begin met een map aan te maken. Die mag eender welke naam hebben maar we raden aan om iets herkenbaar te kiezen.

Het simpelste leerobject bestaat uit twee bestanden: content.md en metadata.json. Laat deze name je niet afschrikken, het is niet zo moeilijk als het lijkt. Maak deze bestanden aan in de map die je net hebt aangemaakt.

content.md

Eerst gaan we het bestand content.md invullen. Open het bestand met een tekstbewerker (bijvoorbeeld notepad of vscode). Je kunt hierin schrijven wat je wilt in markdown formaat. Dat is een soort word-bestand waar je opmaak doet in de vorm van speciale karakters. Bijvoorbeeld:

een # voor een lijn maakt er een titel van
woorden tussen ** worden vet
foto's kun je invoegen door een foto in de map te plaatsen en er een referentie naar te maken (internet!)

Om meer hierover te weten te komen zoek bijvoorbeeld naar "markdown cheatsheet".

metadata.json

Het bestand metadata.json beschrijft hoe de website moet omgaan met het bestand content.md. Hieronder geven we een voorbeeld invulling. Er wordt verder ingegaan op elke 'property'. Vergeet niet: tekst moet tussen apostroffen " staan, getallen en booleans (true of false) niet.

{
    "hruid": "u_leerpaden101_leerobject_1",
    "version": 1,
    "language": "nl",
    "title": "Het eerste leerobject horende bij het leerpad leerpaden101",
    "description": "Dit is een ander zelf aangemaakt leerobject voor testdoeleinden",
    "content_type": "text/markdown",
    "keywords": [
    	"fill", "in", "the", "keywords", "here"
    ],
    "target_ages": [10, 11, 12],
    "teacherExclusive": false,
    "skos_concepts": ["the", "concepts"],
    "educational_goals": [
    	{"source": "source", "id": "id"}
    ],
    "copyright": "Team 1 SELab2 2025",
    "license": "CC0",
    "difficulty": 3,
    "estimated_time": 10,
    "return_value": {
    	"callbackUrl": "",
    	"callbackSchema": ""
    },
    "available": true,
    "teacher_exclusive": false
}

hruid: Dit is een unieke identifier voor je leerobject. Zorg ervoor dat geen enkel van je andere eigen leerobjecten deze naam heeft. Dit moet altijd beginnen met u_ en mag enkel kleine letters, cijfers en underscores '_' bevatten.
version: Het versienummer van je leerobject. Ik heb gelogen: je kunt wel leerobjecten met dezelfde naam hruid hebben, op voorwaarde dat ze een verschillend versienummer hebben. Zo kun je makkelijk onderscheiden tussen verschillende versies.
language: De taal van je leerobject. Je kunt kiezen uit: 'nl', 'en', 'de' en 'fr' voor nederlands, engels, duits en frans.
title: De titel van je leerobject.
description: De beschrijving van je leerobject.
content_type: Dit is het formaat van je andere bestand: content.md. In dit geval zal dat dus text/markdown zijn.
keywords: Een lijst met sleutelwoorden die horen bij dit leerobject.
target_ages: Een lijst met leeftijden waarvoor het leerobject bedoeld is.
teacherExclusive: Geeft aan of het leerobject enkel bedoeld is voor de leerkracht. Een leerling kan deze dus niet zien. Deze property kan enkel de waarde true of false aannemen, zonder apostroffen ".
teacher_exclusive: Door rare shenanigans tijdens het ontwikkelen van de website hebben we twee keer dezelfde property. Deze heeft dezelfde betekenis als die hierboven.
skos_concepts: De concepten die aangebracht worden in dit leerobject.
educational_goals: Geen idee, zet hier maar gewoon een lege lijst [].
copyright: De copyright licentie, als je die hebt. Als je er geen hebt vul dan maar gewoon je naam in.
license: Geen idee eigenlijk.
difficulty: De moeilijkheid van het leerobject, gaande van 1 tot 10.
estimated_time: De geschatte tijd die nodig is om het leerobject af te werken, in minuten.
return_value: Kopieer maar gewoon van het voorbeeld voor deze.
available: Kan je dit leerobject gebruiken? Zet maar op true anders kun je het niet gebruiken in je eigen leerpad.

Voila! Met een beetje geluk heb je nu je eerste leerobject.

Preview

Om een preview te krijgen van wat je net hebt gemaakt kun je naar de home-pagina gaan op de website en 'Eigen leerinhoud' selecteren.

Vooraleer je het leerobject kunt uploaden moeten we er eerst een zipbestand van maken. Het is aangeraden van even op te zoeken hoe dit moet als je dat niet weet. Klaar? Alright let's go. Druk op 'leerobject uploaden', selecteer het zipbestand dat je net hebt gemaakt en druk op uploaden.

Je kunt nu een preview krijgen van je leerobject door links op het vinkje te klikken.

Als alles goed is gegaan kun krijg je dan rechts een voorbeeld!

Leerpaden 101

Met een leerobject op zich ben je niet veel. In deze sectie leer je een leerpad te maken van je leerobjecten. Dit is een iets technischere sectie, maar geen zorgen, ik hou je hand stevig vast.

Een leerpad aanmaken doe je als volgt. Ga naar het tabblad 'leerpaden' op de pagina 'eigen leerinhoud'.

Schrik niet van de ingewikkelde test die daar rechts tevoorschijn komt. We gaan er stap voor stap door. Hieronder staat opnieuw een voorbeeld. Daaronder staan weer alle 'properties' uitgelegd. Je kunt de properties invullen in de editor bij het tabblad 'leerpaden', of je kunt het kopiëren naar je favoriete tekstbewerker (bv. notepad of vscode).

{
  "language": "nl",
  "hruid": "u_leerpad101",
  "title": "Leerpaden 101",
  "description": "Dit is een leerpad dat uitleg geeft over hoe je leerpaden moet aanmaken.",
  "nodes": [
    {
      "learningobject_hruid": "u_leerpaden101_leerobject_1",
      "language": "nl",
      "version": 1,
      "start_node": true,
      "transitions": [
        {
          "default": true,
          "next": {
            "hruid": "u_leerpaden101_leerobject_2",
            "version": 1,
            "language": "nl"
          }
        }
      ]
    },
    {
      "learningobject_hruid": "u_leerpaden101_leerobject_2",
      "language": "nl",
      "version": 1,
      "start_node": false,
      "transitions": []
    }
  ]
}

Alright, dat is een hele boterham.

hruid: De unieke identifier van je leerpad. Deze keer moet het echt uniek zijn :(.
language: Zoals bij een leerobject, de taal van je leerpad. Het is aangeraden dezelfde taal te kiezen als je leerobjecten (en die ook allemaal in dezelfde taal te zetten).
title: De titel van je leerpad.
description: De beschrijving van je leerpad.
nodes: Een lijst met nodes. Hieronder wordt daar dieper op ingegaan.

`nodes`

Zoals hierboven al gezegd, is een leerpad een collectie van leerobjecten. Dit wordt duidelijk gemaakt aan de website met de property 'nodes'. Nodes bevat een lijst van nodes. Een node bestaat uit een leerobject en een lijst met overgangen die duidelijk maken hoe je van het ene leerobject naar het andere gaat. Klinkt ingewikkeld he? Geen zorgen. Een node ziet er als volgt uit:

{
  "learningobject_hruid": "u_leerpaden101_leerobject_1",
  "language": "nl",
  "version": 1,
  "start_node": true,
  "transitions": [
    {
      "default": true,
      "next": {
        "hruid": "u_leerpaden101_leerobject_2",
        "version": 1,
        "language": "nl"
      }
    }
  ]
}

learningobject_hruid: De hruid van het leerobject dat je wilt toevoegen aan dit leerpad.
language: De taal van het leerobject dat je wilt toevoegen.
version: Het versienummer van het leerobject dat je wilt toevoegen.
start_node: Duidt aan of dit de eerste node is in het leerpad of niet. Deze property kan true of false zijn, of je kunt hem volledig weglaten. Deze kan true zijn voor maximaal 1 leerobject!
transitions: Aangezien dit de 101 sectie is houden we het simpel. Deze property houdt een lijst bij met transities. In het simpelste geval is dit gewoon 1 transitie. Als dit het laatste leerobject is dat je wilt toevoegen dan zet je daar gewoon een lege lijst []. Een transitie wordt verder hieronder uitgelegd.
default: Is dit de standaardovergang? In dit geval wel, dus zet maar op 'true'.
next: Deze property duidt aan naar waar de overgang gaat. Zoals hierboven vermeld is een leerpad een lijst met leerobjecten. Om bij te houden welke leerobjecten op welke volgen worden dus overgangen gespecificeerd. 'next' zegt ons wat het volgende leerobject is na de huidige. Vul hier opnieuw de 'learningobject_hruid', 'version' en 'language' in. Let wel op: je kunt enkel een transitie specifieren naar een leerobject die ook in dit leerpad zit. Dus stel dat je volgende leerobject de hruid 'leerobject_2' heeft, dan moet in de 'nodes' lijst ook een node aangemaakt worden met dat leerobject.

Hopelijk heb je dat allemaal gesnopen.

Aanmaken

Als je bezig was in je favoriete tekstbewerker dan kopieer je nu alles dat je hebt geschreven naar de tekstbewerker op de website. Dan druk je op aanmaken. Als alles goed is gegaan dan kun je nu links op het vinkje drukken om je leerpad in te laden. Druk dan op 'openen' om je leerpad te zien.