Edurep:Widget

Uit Kennisnet Developers Documentatie
Versie door Zijlmans01 (overleg | bijdragen) op 14 nov 2023 om 12:49 (EoF verwijderd)
(wijz) ← Oudere versie | Huidige versie (wijz) | Nieuwere versie → (wijz)
Naar navigatie springen Naar zoeken springen

Edurep-symbol.png Edurep: Widget

Het implementeren van de Edurep Widget op een website is vrij eenvoudig. Het enige wat vereist is, is het invoegen van een klein stukje javascript. Dit kan handmatig met de onderstaande beschrijving of via point-and-click met de wizard.

Inbedden in HTML

De javascript wordt in het onderstaande voorbeeld ingebed in een HTML-pagina. In de configuratie kunnen een aantal velden worden ingevuld:

  • title: de titel komt bovenaan de widget te staan
  • description: een korte beschrijving over waar de widget naar zoekt
  • border: teken een lijn om de widget
  • bordered: laat witruimte tussen de rand en de content van de widget
  • showExport: geeft de gebruiker de mogelijkheid om de URL's van geselecteerde leerobjecten te exporteren
<html>
<body>
<script type="text/javascript" src="//widget.edurep.nl/latest/js/init.js"></script>
<script type="text/javascript">
  var EdurepWidget={};
  EdurepWidget.config = {
  widget:{
    title: "de Edurep Widget",
    description: "Zoek hier naar digitaal lesmateriaal",
    bordered: true,
    border: true,
    showExport: false
  }
};
</script>
<div style="width:280px">
  <div id="eduwidget"></div>
</div>
</body>
</html>
Edurepwidget.png

Filters toevoegen

Het is ook mogelijk om vooraf gedefinieerde filters mee te geven in de aanroep van de widget. Het is in principe mogelijk om op alle Edurep zoekvelden te filteren. Binnen een veld kan men op 1 of meerdere waarden filteren.

  • name: het Edurep zoekveld
  • values -> label: een gebruiksvriendelijke naam voor de filterwaarde
  • values -> value: de daadwerkelijke filterwaarde


Bekijk het onderstaande stukje javascript voor een voorbeeld van 2 filters, leerniveau en kosten, waarbij leerniveau op 2 waarden wordt gefilterd.

  var EdurepWidget={};
  EdurepWidget.config = {
  widget:{
   title: "de Widget met filters",
    description: "Zoek hier naar gratis digitaal lesmateriaal voor het VO en MBO",
    bordered: true,
    border: true,
    showExport: false
  },
  "filters": {
    "lom.rights.cost": [{
      "label": "Gratis",
      "value": "no"
    }],
    "lom.classification.educationallevel.id": [{
      "label": "MBO",
      "value": "caa97efc-a713-41ea-a845-1534ca65eac9"
    },
    {
      "label": "VO",
      "value": "2a1401e9-c223-493b-9b86-78f6993b1a8d"
    }]
  }
};


Omdat de zoekvelden en waarden niet altijd voor zichzelf spreken, bij deze een overzicht. Vak en leerniveau zoeken met OBK waarden.

filter zoekveld label value
leerniveau lom.classification.educationallevel.id PO 512e4729-03a4-43a2-95ba-758071d1b725
VO 2a1401e9-c223-493b-9b86-78f6993b1a8d
MBO caa97efc-a713-41ea-a845-1534ca65eac9
vak lom.classification.discipline.id aardrijkskunde c001f86a-4f8f-4420-bd78-381c615ecedc
wiskunde 7afbb7a6-c29b-425c-9c59-6f79c845f5f0
economie 4ba5583f-b147-42cc-a083-ce5ebfd53746
kosten lom.rights.cost niet gratis yes
gratis no

Wizard

Met de Widget Wizard kan de configuratie eenvoudig worden gegenereerd op basis van een gemaakte zoekopdracht. Een in de widget gemaakte zoekopdracht kan als widget code worden ge-exporteerd.