Edurep:Widget

Uit Kennisnet Developers Documentatie
Ga naar: navigatie, zoeken

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.

Inhoud

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. Niet alle waarden staan genoemd, maar deze kunnen worden opgezocht in de OBK Browser (zoek begrip, klik op oogje, klik op tabblad achtergrond).

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.