# Handboek MediaWiki/Extensies/Quiz
### Quiz

De quiz-extensie maakt het mogelijk vragen te stellen, waarmee bijvoorbeeld het leren van de inhoud van een les kan worden gecontroleerd. Zie mw:Extension:Quiz voor de originele Engelstalige beschrijving van de extensie.

#### Installatie

* maak een nieuwe directory met de naam "quiz" in de "extensions" directory van de betreffende wiki.
* Kopieer de bestanden in de nieuwe directory. De bestanden zijn hier te vinden: Quiz.php en quiz.i18n.php en quiz.js
* Voeg deze instructie toe aan het einde van de LocalSettings.php :

#### Gebruik van de extensie
##### Toevoegen van een quiz in een Wikipagina

| Rendering | Wikitext | Commentaar |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: → Vraag hier invoegen ← | <quiz> {→ Vraag hier invoegen ←} </quiz> | De quiz-Tag doet het volgende: Er worden eerst enige standaard-quiz-opties toegevoegd. Alles tussen de quiz-tags worden door de quiz-extensie verwerkt en zo mogelijk in vragen omgezet Onderaan bevindt zich de verbeteringsknop, waarmee de scholier/student, nadat de quiz is beëindigd, de controle en oplossing kan vragen. Wordt er op de verbeteringsknop gedrukt, dan ziet men 3 verschillende kleuren, die gebruikt worden om aan te geven of de antwoorden juist, verkeerd of niet gegeven zijn De "Vragen in willekeurige volgorde"-knop zorgt ervoor dat met javascript de vragen in een nieuwe willekeurige volgorde worden gezet. |
Theoretisch is het mogelijk, elke vraag van een eigen Quiz-tag te voorzien. Dat neemt dan echter veel plaats in en de correctie/controle werkt dan niet meer zuiver.
Het actuele formaat van de extensie werkt het best met een quiz, waarbij alle vragen tussen een paar van Quiz-tags staan.

#### Types van vragen
##### Meerdere mogelijke antwoorden

| Rendering | Wikitext | Commentaar |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: Welke teams stonden bij het Wereldkampioenschap voetbal 2006 in de finale? Frankrijk Nederland Italië Brazilië Argentinië | <quiz> { Welke teams stonden bij het Wereldkampioenschap voetbal 2006 in de finale? } + Frankrijk - Nederland + Italië - Brazilië - Argentinië> </quiz> | Dit type van vragen is "Multiple Choice". Hierbij kan ook meer dan een antwoord goed zijn Dit is de standaardvorm voor een quizvraag (antwoordmogelijkheden met een checkbox). Dezelfde werking kan bereikt worden met | typ="" binnen de quizvraag. Juiste antwoorden krijgen een plusteken, verkeerde een minteken. Elk symbool, bijvoorbeeld |, +, - en alle andere bijzondere tekens (zie verder) moeten aan het begin van een nieuwe regel staan. |

##### Slechts één antwoord mogelijk

| Rendering | Wikitext | Commentaar |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: Wie werd in 2006 in Duitsland Wereldkampioen? Frankrijk Italië Nederland België | <quiz> { Wie werd in 2006 in Duitsland Wereldkampioen? | typ="" } - Frankrijk + Italië - Nederland - België </quiz> | Hier is slechts een antwoord mogelijk. Het correcte antwoord kan op elke mogelijke positie staan en wordt met een plusteken gemarkeerd (verkeerde antwoorden wederom met een min-teken). Symbolen moeten aan het begin van een nieuwe regel staan; tevens zijn er geen spaties toegestaan. |

##### Tabel

| Rendering | Wikitext | Commentaar |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: Water is bij een standaarddruk bij ... °C vloeibaarvastgasvormig ... onder 0 ... ... tussen 0 en 100 ... ... boven 100 ... | <quiz> { Water is bij een standaarddruk bij ... °C | typ="" } | vloeibaar | vast | gasvormig -+- ... onder 0 ... +-- ... tussen 0 en 100 ... --+ ... boven 100 ... </quiz> | Deze vorm van een meervoudige keuzemogelijkheid wordt bereikt door het herhaalde plaatsen van plus- und mintekens aan het begin van de regel. Er kan slechts een plusteken per regel staan De kolommenbeschrijving wordt op gebruikelijke wijze met het "|"-teken van elkaar gescheiden. |

##### Tekst

| Rendering | Wikitext | Commentaar |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: 1 Invultekst Waar is Aristoteles geboren? Wie was de beroemde mentor van Aristoteles? was de bekendste leerling van Aristoteles. 2 Vertaal naar het Engels Nul 3 Vul de open ruimtes met tekst! Elektriciteit vliest van naar De elektronen bewegen zich van naar Gaten (elektronengaten) bewegen zich van naar | <quiz> { Invultekst | type="" } Waar is Aristoteles geboren? { Stageira } Wie was de beroemde mentor van Aristoteles? { Plato } { Alexander } was de bekendste leerling van Aristoteles. { Vertaal naar het Engels | type="" } Nul { zero|nil|null (i) } { Vul de open ruimtes met tekst! | type="" } Elektriciteit stroomt van { plus _6} naar { min _6} De elektronen bewegen zich van { min _6} naar { plus _6} Gaten (elektronengaten) bewegen zich van { plus _6} naar { min _6} </quiz> | De spaties tussen accolade en antwoord zijn belangrijk. Door middel van _getal kan het maximaal aantal letters vastgelegd worden. Bij een langer antwoord wordt een syntaxfehler getoond. Grote en kleine letters: dit speelt geen rol, behalve wanneer het met (i) wordt geactiveerd. (i) staat voor "case-insensitive". Belangrijk: Dit geldt *niet* voor alle antwoorden, maar alleen voor expliciet met (i) aangegeven antwoorden. |

##### Getallen

Het ingeven van getallen is verwant met de ingave van tekst; men kan ze samen gebruiken.
| Rendering | Wikitext | Commentaar |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: 1 Geef 1/3 in een decimaal antwoord? Antwoord: 2 Hoeveel is 10 keer 10 3 2^.5=? | <quiz> {{ Geef 1/3 in een decimaal antwoord? | type="" } Antwoord: { 0.33-0.34 } || Feedback { Hoeveel is 10 keer 10 | type="" } { 100 5% } { 2^.5=? | type="" } { 1.4-1.42 | -1.42--1.4 } </quiz> | Zowel punt als komma kan gebruikt worden voor het weergeven van een decimaal. Zowel het opgeven van een bereik als ook het opgeven van een tolerantie in procenten is mogelijk In de derde vraag zijn twee mogelijkheden juist. Deze meerkeuzemogelijkheid wordt van elkaar gescheiden door een pipe-teken. |

#### Mediawikisyntax

Binnen de quiz-tags functioneert een groot gedeelte van de wikisyntax, en dus kunnen ook afbeeldingen, geluid en animaties in een vraag worden weergegeven.
De voorbeelden hier zijn slechts een paar van de mogelijkheden.

##### Afbeeldingen

| Rendering | Wikitext | Commentaar |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: 1 Wat is geen noot? 2 Wat is dat ? Tijger Vlinder Bij Vlieg | <quiz> { Wat is geen noot? } - [[Image:Two English Walnuts edit.jpg|100px|Okkernoot]] + [[Image:ARS peanuts.jpg|100px|Pinda]] + [[Image:Red Delicious.jpg|100px|Appel]] - [[Image:Ab food 12.jpg|100px|Pistache]] - [[Image:Roastedchestnuts.JPG|100px|Kastanje]] + [[Image:Citrus sinensis.jpg|100px|Sinaasappel]] { Wat is dat [[Image:Butterfly tongue.jpg|100px| ]]? | typ="" } - Tijger + Vlinder - Bij - Vlieg </quiz> | Er bestaat geen mogelijkheid om de afbeeldingen in een rij te zetten, zoals met de gallery-tag. |

##### Animaties

Dit gedeelte introduceert geen technische trucs, maar laat alleen het gebruik van geanimeerde GIF's zien.
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: Wat voor dieren zijn dat? Haring Forel Baars Snoek | Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: Wat voor een motor is dat? Boxermotor Wankelmotor Stermotor | Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: Uit hoeveel kogels bestaat de pyramide? |

##### Muziek

| Rendering | Wikitext |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: 1 Welk lied is dat? Eine kleine Nachtmusik Beethovens 5. symfonie Für Elise 2 Welk lied is dat? Stille nacht, heilige nacht Jingle Bells O dennenboom O du fröhliche 3 Welk lied is dat? Joy to the World O dennenboom Jingle Bells Stille nacht, heilige nacht | <quiz> { Welk lied is [[Media:Mozart Eine kleine Nachtmusik KV525 Satz 4 Rondo.ogg|dat]]? | typ="" } ||[[Media:Mozart Eine kleine Nachtmusik KV525 Satz 4 Rondo.ogg]] + Eine kleine Nachtmusik - Beethovens 5. symfonie - Für Elise { Welk lied is [[Media:Jingle Bells.ogg|dat]]? | typ="" } ||[[Media:Jingle Bells.ogg|Jingle Bells]] - Stille nacht, heilige nacht + Jingle Bells - O dennenboom - O du fröhliche { Welk lied is [[Media:Oh Christmas Tree.ogg|dat]]? | typ="" } ||[[Media:Oh Christmas Tree.ogg| Oh Christmas Tree]] - Joy to the World + O dennenboom - Jingle Bells - Stille nacht, heilige nacht </quiz> |

##### Het gebruik van sjablonen

Het gebruik van sjablonen is met weinig beperkingen mogelijk.
Substitueren van sjablone met Subst: is voorlopig nog niet mogelijk; tevens zijn er beperkingen bij het gebruik van parameters.
| Rendering | Wikitext |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: Van wie is dit lied (info·uitleg)? Beethoven Bach Mozart ... | <quiz> { Van wie is {{Audio|BWV726.ogg|dit lied}}? } - Beethoven + Bach - Mozart - ... </quiz> |

##### De oplossing en feedback

| Rendering | Wikitext | Kommentar |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: 1 Wat is geen noot? Walnoot Pinda Appel Pistache Kastanje Sinaasappel 2 Wie heeft de gloeilamp uitgevonden? Thomas Alva Edison Frederick de Moleyns Heinrich Göbel Niet bekend | <quiz> { Wat is geen noot? } - Walnoot + Pinda ||Hülsenfrucht, siehe {{W|Pinda}} + Appel - Pistache - Kastanje + Sinaasappel { Wie heeft de gloeilamp uitgevonden? } - Thomas Alva Edison || Edison heeft de gloeilamp in belangrijke mate verder ontwikkeld - Frederick de Moleyns || Deze persoon is in bezit van het eerste patent - Heinrich Göbel || Deze persoon heeft beweerd deel te hebben gehad aan de verdere ontwikkeling van de gloeilamp, hetgeen echter niet waar bleek te zien. + Niet bekend || zie {{W|Gloeilamp#Uitvinding}} </quiz> | De Feedback-tekst achter het teken " | " is verstopt en verschijnt pas, wanneer de gebruiker op de verbeteringknop heeft gedrukt Typisch gebruikt: Beloning/lof Uitleg Felicitatie Opbeurende woorden of medelijden Feedback is met alle typen vragen mogelijk De dubbele verticale lijn (||) moet direct na de verschillende antwoorden staan. Ook dit bijzondere teken moet aan het begin van een nieuwe regel staan. Anders als bij ander quizsystemen, worden alle feedbacks bij de verbetering getoond. Bij andere quizsystemen is het standaard alleen feedbacks te tonen bij antwoorden die de gebruiker heeft gekozen. Om feedbacks uit te proberen, druk op "verbetering". |

#### Coëfficient

Indien niet elke vraag dezelfde punten zou moeten geven, kan men elke vraag met | koef="X" } van een factor (coëfficient) voorzien.
| Rendering | Wikitext | Commentaar |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: 1 Deze vraag geeft 5 punten. Juist antwoord Ook juist Verkeerd antwoord 2 Deze vraag geeft 3 punten. Juist antwoord Verkeerd antwoord 3 Deze vraag geeft 1 punt. Juist antwoord Verkeerd antwoord | <quiz> { Deze vraag geeft 5 punten. | koef="5" } + Juist antwoord + Ook juist - Verkeerd antwoord { Deze vraag geeft 3 punten. | typ="" koef="3" } + Juist antwoord - Verkeerd antwoord { Deze vraag geeft 1 punt. | typ="" } + Juist antwoord - Verkeerd antwoord </quiz> | |

#### Inclusie van een quiz

De inclusie van een of meerder quizen is mogelijk, wat bijvoorbeeld het maken van dynamische druckversie mogelijk maakt.
| Render | Wikitext | Inhoud van het sjabloon |
| Wikibooks:Quizsjabloon | {{Wikibooks:Quizsjabloon}} | <quiz> { Deze quiz is een sjabloon } + Juist - Verkeerd </quiz> |
Het overleveren van parameters (dus {{Wikibooks:Quisjabloon|Parameter}} en {{{1}}}) werkt niet.

#### Resultaatbepaling
##### Punten

| Rendering | Wikitext | Commentaar |
| Punten toegevoegd voor een goed antwoord:   Punt afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: Vraag Juist antwoord Ook juist Verkeerd antwoord | <quiz points="2/1!"> { Vraag } + Juist antwoord + Ook juist - Verkeerd antwoord </quiz> | <quiz points="X/Y!"> X is het aantal punten voor een juist antwoord, Y is het aantal punten aftrek voor een verkeerd antwoord en het optionale "!" is voor het negeren van de coëfficienten. De Gebruiker kan de waarde veranderen. Er kunnen alleen positieve getallen worden ingegeven. Niet gehele getallen als 1.5 zijn ook mogelijk. |

#### Quizopties
##### simple

Met behull van display="simple" kan je het kopje van de quiz verbergen.
| Rendering | Wikitext |
| Test Juist Verkeerd | <quiz display="simple"> { Test } + Juist - Verkeerd </quiz> |

#### Gemengde opties
##### shuffle="none"

Met shuffle="none" kan je de "Vragen in willekeurige volgorde" onderdrukken:
| Rendering | Wikitext |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: 1 Test Juist Verkeerd 2 Hallo Juist Verkeerd 3 Pi is precies 3 Juist Verkeerd | <quiz shuffle="none"> { Test } + Juist - Verkeerd { Hallo } + Juist - Verkeerd { Pi is precies 3 } + Juist - Verkeerd </quiz> |

#### Fijninstelling

Je kunt een blok definiëren, dat met {X} begint en dan door {/X} beëindigd wordt. Hiermee worden alleen de vragen binnen dit zo gedefinieerde blok in een willekeurige volgorde geplaatst, binnen het blok. Buiten het blok kan de volgorde wel wijzigen
| Render | Wikitext | Inhalt der Vorlage |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: 1 Kann overal geplaatst worden Juist antwoord Verkeerd antwoord 2 Slechts intern in willekeurige volgorde geplaatst Juist antwoord Verkeerd antwoord 3 Slechts intern in willekeurige volgorde geplaatst Juist antwoord Verkeerd antwoord 4 Wordt niet verplaatst Juist antwoord Verkeerd antwoord 5 Wordt niet verplaatst Juist antwoord Verkeerd antwoord | <quiz> { Kann overal geplaatst worden } + Juist antwoord - Verkeerd antwoord {X} { Slechts intern in willekeurige volgorde geplaatst } + Juist antwoord - Verkeerd antwoord { Slechts intern in willekeurige volgorde geplaatst } + Juist antwoord - Verkeerd antwoord {/X} {!X} { Wordt niet verplaatst } + Juist antwoord - Verkeerd antwoord { Wordt niet verplaatst } + Juist antwoord - Verkeerd antwoord {/X} </quiz> | De nummers van de vragen, blijft gehandhaafd. Indien iets wordt aangekruist wordt de knop "Vragen in willekeurige volgorde" inactief (grijs) gemaakt. |

#### Tekst tussen de vragen

| Rendering | Wikitext |
| Punt toegevoegd voor een goed antwoord:   Punten afgetrokken voor een onjuist antwoord: De coëfficienten van de vragen negeren: 1 Test Juist Verkeerd Dit is een testtekst 2 Pi is precies 3 Verkeerd Juist | <quiz> {{ Test } + Juist - Verkeerd { Dit is een testtekst<br> } { Pi is precies 3 } + Verkeerd - Juist </quiz> |