Edurep:Widget: verschil tussen versies
(add wizard) |
|||
| Regel 1: | Regel 1: | ||
| − | Het implementeren van de Edurep Widget op een website is vrij eenvoudig. Het enige wat vereist is, is het invoegen van een klein stukje |
+ | 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. |
__TOC__ |
__TOC__ |
||
== Inbedden in HTML == |
== Inbedden in HTML == |
||
| − | De |
+ | 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 |
* title: de titel komt bovenaan de widget te staan |
||
* description: een korte beschrijving over waar de widget naar zoekt |
* description: een korte beschrijving over waar de widget naar zoekt |
||
| Regel 37: | Regel 37: | ||
== Filters toevoegen == |
== Filters toevoegen == |
||
| − | Het is ook mogelijk om |
+ | 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:Veldenlijst|Edurep zoekvelden]] te filteren. Binnen een veld kan men op 1 of meerdere waarden filteren. |
* name: het Edurep zoekveld |
* name: het Edurep zoekveld |
||
* values -> label: een gebruiksvriendelijke naam voor de filterwaarde |
* values -> label: een gebruiksvriendelijke naam voor de filterwaarde |
||
| Regel 43: | Regel 43: | ||
| − | Bekijk het onderstaande stukje |
+ | Bekijk het onderstaande stukje javascript voor een voorbeeld van 2 filters, leerniveau en kosten, waarbij leerniveau op 2 waarden wordt gefilterd. |
<syntaxhighlight lang="javascript"> |
<syntaxhighlight lang="javascript"> |
||
var EdurepWidget={}; |
var EdurepWidget={}; |
||
| Regel 112: | Regel 112: | ||
== Wizard == |
== Wizard == |
||
| − | Met de [ |
+ | Met de [kn.nu/edurep-widget 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. |
[[Categorie:Edurep]] |
[[Categorie:Edurep]] |
||
Versie van 12 jun 2017 16:38
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>
|
|
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 [kn.nu/edurep-widget 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.