Mediawiki Extension Quiz - Revision history

DochyJP: Text replacement - "[{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]" to ""

2021-04-14T12:56:17Z

Text replacement - "[{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]" to ""

DochyJP: Text replacement - " " to " [{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]"

2021-04-14T12:47:35Z

Text replacement - " " to " [{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]"

DochyJP: Added template version in infobox for future updates

2021-04-13T07:05:25Z

Added template version in infobox for future updates

DochyJP: Changed Infobox

2021-02-26T13:24:08Z

Changed Infobox

DochyJP: Text replacement - "Template-uk:Class-Infobox-Software" to "Template:Class-Infobox-Software"

2021-02-25T12:38:31Z

Text replacement - "Template-uk:Class-Infobox-Software" to "Template:Class-Infobox-Software"

DochyJP: Added infobox and semantic variables

2021-02-15T12:45:05Z

Added infobox and semantic variables

DochyJP: Page creation

2021-01-04T16:23:03Z

Page creation

New page

'''[[PageName::{{PAGENAME}}|]]'''

{{Template-uk:Class-Infobox-Software
|image = 
|Source = [[Source::DataSource]]
|Version = [[Version::MW-1.35-LTS]]
|Language = [[Language::English]]
|Subject = [[Subject::Mediawiki]]
|DocumentType = [[DocumentType::Extension]]
|LastEditBy = [[LastEditBy::{{REVISIONUSER}}]]
|LastEdit = [[LastEdit::{{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}]]
|DocumentStatus = [[DocumentStatus::Active]] 
}}


== Description ==

== Installation ==

=== Download ===
[https://extdist.wmflabs.org/dist/extensions/Quiz-REL1_31-58e310d.tar.gz Download] and place the file(s) in a directory called Quiz in your extensions/ folder.
=== Activation ===
Add the following code at the bottom of your LocalSettings.php:
<pre>wfLoadExtension( 'Quiz' );</pre>
== Create your Quiz==
=== Adding a new question type ===
Quiz was conceived to facilitate the addition of new question types. If the basic types (multiple choice with single/multiple responses) are not enough for you, you have the possibility of easily creating and integrating the type of questions which you need. For that you must have some knowledge of PHP.
:*The first thing that you must do is choose a syntax (the simplest possible) for your question type. The restrictions are:
:#The syntax of the question's header is fixed. The question has to be placed between curly brackets - i.e. { and }
:#For consistency, it is recommended to use || to mark the beginning of the feedback section ("correction").
:*Choose a new code name for your question type (example: "questionTypeName") as well as a symbol (currently the symbol "()" is used for single response multiple choice because it looks like a radio button, and the symbol "[]" is used for multiple response multiple choice because it looks like a checkbox).
:*Add a "case" at the beginning of the parseParameters's "switch", as follows :<pre>case 'symbol':
<pre>
$this->mType = "questionTypeName";
break;
</pre>
:*Add a parser function to Quiz.php. This function must convert a question object from quiz syntax to HTML and set a state to the question (right, wrong, error, NA or unmarked), according to syntax errors and eventually posted answers. Name the function "questionTypeNameParseObject" and implement as follows :
<pre>
/**
* Convert a basic type object from quiz syntax to HTML.
*
* @param $input A question object in quiz syntax
*
* @return $output A question object in HTML.
*/
function questionTypeNameParseObject($input)
{
// your code here.
$this->setState(""); // Set the state if needed.
return $output;
}
</pre>
:#Write down your syntax specifications which will be added to the help. Please read first the existing help.
:#Once this is all done, contact me to include officially your question type inside the extension.
 [[#top|Back to top of page]] - [[English|Back to Welcome Page]] 
== Quiz documentation ==

This is the help page for the quiz extension.

The quiz extension consists of very simple markup. This page is long because of the many possibilities which the quiz extension opens up. For a simpler and colourful guide to quizzes suitable for beginners, try the [[Help:Quiz-Simple|simple quiz help page]].

==Overview==
=== Version ===

* Version 1.0 of the quiz extension is now (20 May 2007) active on Wikiversity.
* This documentation covers all the major features and most of the minor ones.
* A few exotic features are not yet covered, such as shuffle control using <nowiki>{X} {!X} {/X}</nowiki> tags.

=== Pedagogical considerations ===
* Where are the strengths and weaknesses of Wikiversity quizzing?
* How can you best use the quiz extension as a teaching tool?
* [https://en.wikiversity.org/wiki/Help:Quiz/Wikiversity_compared_to_Moodle Wikiversity compared to Moodle] - offers a detailed consideration of the quiz feature differences between [https://en.wikiversity.org/wiki/Moodle Moodle] and [https://en.wikiversity.org/wiki/Wikiversity Wikiversity], including suggestions as to how each is best used.

== How to create a quiz ==

=== The quiz tag ===

{| class="wikitable"
!wikitext (what you write)!!rendering (what you see)!!comments
|-
|valign=top width=200|<quiz> ''insert questions here'' </quiz>
|valign=top|
{|
|<quiz>

{Sample Question 1
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

{Sample Question 2
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.
</quiz>
|}
|valign=top|The ''quiz'' tags do the following:
* They insert some standard quiz options at the top and a colour-key for marking. The colour-key only appears when the question is marked.
* They add a "submit" button at the bottom for when the learner has finished the quiz and wants it marked.
* Everything between the quiz tags is parsed by the quiz extension and turned into questions if possible.

Theoretically it is possible to put ''quiz'' tags around each individual question, allowing a learner to mark each one in turn.

'''Shuffling questions''': if the shuffle questions button is shown, the questions can be shuffled by clicking the button. This only works so long as the quiz-taker has not started to answer the questions. Once the quiz-taker starts answering, the order is locked.Shuffle button is not shown if there is one or less questions in a quiz.

|-
|valign=top|<quiz display=simple> ''insert questions here'' </quiz>
|valign=top|
{|
|<quiz display=simple>

{''This is where questions would appear.''}

</quiz>
|}
|valign=top|
* Importantly, the addition of "display=simple" as an attribute of the quiz tag removes the points table at the top.
* This is useful for short quizzes, and especially for situations where you insert single questions between text blocks.

|-
|valign=top|<quiz shuffle=none> ''insert questions here'' </quiz>
|valign=top|
{|
|<quiz shuffle=none>

{''This is where questions would appear.''}

</quiz>
|}
| valign=top|
* If you'd like to keep the points table but get rid of the button for shuffling questions, use ''shuffle=none'' as shown.

|-
|valign=top width=200|<quiz shuffleanswers=true> ''questions with proposal shuffled on reload here'' </quiz>
|valign=top|
{|
|<quiz shuffleanswers=true>

{Sample Question 1
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

{Sample Question 2
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.
</quiz>
|}
|valign=top|
'''Shuffling answers''': The quiz also provides the option of automatic shuffling of answers on load.This can be achieved by using shuffleanswers parameter.When shuffleanswers parameter is set to true the answers are shuffled for each reload of the page.
This only works so long as the quiz-taker has not started to answer the questions. Once the quiz-taker starts answering, the order is locked to the way it was before submission.

|}

=== Inserting questions ===

The types of questions available are shown below.

An important point is that '''each question must be separated by a blank line''', otherwise they are merged together into one question.

=== How to use the examples ===

In the examples on this page, there is both ''wikitext'' and ''rendering''. The ''wikitext'' shows you the code, which you can copy and paste into your pages, or just learn and understand. The ''rendering'' shows you what the result will look like.

==== Copying and pasting ====

The markup has been slightly simplified in order to help ''understanding''. If you copy and paste, you must insert <quiz> tags before and after the markup. You may wish to use the quiz tags with the "display=simple" option as shown above.

Note that the actual example below also use ''tables'' for clarity. If a quiz is inserted into a table, this modifies the appearance of a quiz - for example, boxes appear around some elements in the quiz. If you don't use a table, these boxes disappear and your quiz will look plainer.

When pasting, ensure that '''all the symbols are aligned with the beginning of the lines of the page''' - i.e. if any line begins with a space, formatting errors may occur.

==== Live demos ====

All the examples below should work. Don't be afraid to try them out. Hitting the ''correction'' button is OK - it won't change or damage this page.

== Basic question types ==

* '''Note''': For multiple choice questions(MCQs) with negative(-) sign and positive(+) sign, the positive sign(+) signifies the correct answer while the negative(-) sign(s) signifies the wrong answer and this is how Quiz know which answer is correct and which one is wrong.

=== Multiple choice / single response ===

{| class="prettytable"
!wikitext!!rendering!!comments
|-
|valign=top|
<pre>
{Question
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.
</pre>
|valign=top|
{|
|
<quiz display=simple>
{Question
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.
</quiz>
|}
|valign=top|
* This type of question allows a '''single''' correct response and any number of distractors (3 distractors are shown, but it could be one, or nine, or any other number).
* The correct answer may be in any position, and is marked by a plus sign. Distractors are marked by minus signs.
* The wikitext shown should be inserted between <quiz> tags as shown above.
* Answers appear in the same order as in the markup, so it is advisable to shuffle them before exporting into markup.
* Every symbol, i.e. '''|''', +, - and any other symbols listed further down, '''must''' be on a new line.
* The symbols must '''begin''' the newline - no spaces before them.
* The borders are a result of the border around the wiki table. They are optional.
* A ''distractor'' is the standard term for a multiple choice option which is wrong.
* The () symbol in the type attribute is supposed to look like a radio button.
* To see the full colour code (with four colours), try doing the quiz and clicking the correction button.
* A ''second'' click on a radio button (i.e. a click on an already clicked radio button) will deselect it.
|}

=== True/false questions ===

{| class="prettytable"
!wikitext!!rendering!!comments
|-
|valign=top|
<pre>
{Bulgaria and Romania joined the
European Union in 2007.
|type="()"}
+ TRUE.
- FALSE.
</pre>

<pre>
{Switzerland is a member of the
European Union.
|type="()"}
- TRUE.
+ FALSE.
</pre>

<pre>
{Anyone can be a Citizen Journalist.
|type="()"}
+ TRUE.
- FALSE.
</pre>
|valign=top|
{|width=260|
|
<quiz display=simple>
{Bulgaria and Rumania joined the European Union in 2007.
|type="()"}
+ TRUE.
- FALSE.

{Switzerland is a member of the European Union.
|type="()"}
- TRUE.
+ FALSE.

{Anyone can be a Citizen Journalist.
|type="()"}
+ TRUE.
- FALSE.
</quiz>

|}
|valign=top|
* In many quiz systems, true/false questions are listed as a separate kind of question, although they are really nothing more than a variety of multiple choice with a single response. The Wikiversity quiz extension correctly treats true/false questions as multiple choice with a single response. They are implemented in exactly the same way as above.
* The first of the two examples shows a true/false question where the correct answer is "true".
* The second of the two examples shows a true/false question where the correct answer is "false".
* The examples are live and can be tried out now.
* If you have a large number of true/false questions, a more efficient way to lay them out would be to use the tabular response type with radio buttons documented below.

|}

=== Multiple choice / multiple response ===

{| class="prettytable"
!wikitext!!rendering!!comments
|-
|valign="top"|
<pre>
{Question
|type="[]"}
+ Correct answer.
- Incorrect answer.
+ Correct answer.
- Incorrect answer.
</pre>
|valign="top"|
{|width=300|
|
<quiz display=simple>
{Question
|type="[]"}
+ Correct answer.
- Incorrect answer.
+ Correct answer.
- Incorrect answer.
</quiz>
|}
|valign="top"|
* This type of question is a multiple choice where more than one answer could be correct.
* Correct answers are indicated by plus signs, incorrect ones by minus signs.
* The wikitext shown should be inserted between <quiz> tags as shown above.
* Answers appear in the same order as in the markup, so it is advisable to shuffle them before exporting into markup.
* Every symbol, i.e. '''|''', +, - and any other symbols listed further down, '''must''' be on a new line.
* The symbols must '''begin''' the newline - no spaces before them.
* The borders are a result of the border around the wiki table. They are optional.
* The [] symbol in the type attribute is supposed to look like a checkbox.

|}

=== Typed response (short answer) ===

{| class="prettytable"
!wikitext!!rendering!!comments
|-
|valign=top|
<pre>
{ &nbsp;
|type="{}"}
Where was Aristotle born?
{ Stageira }

{ &nbsp;
|type="{}"}
Name Aristotle's famous mentor.
{ Plato }

{ &nbsp;
|type="{}"}
{ Alexander } was Aristotle's most
famous pupil.

</pre>

|valign="top"|
{|
|
<quiz display=simple>
{  
|type="{}"}
Where was Aristotle born? { Stageira }

{  
|type="{}"}
Name Aristotle's famous mentor. { Plato }

{  
|type="{}"}
{ Alexander } was Aristotle's most famous pupil.
</quiz>
|}
|valign=top|
* In a ''typed response'' the quiz-taker types an answer into a textfield using the keyboard.
* The question type is signalled using '''"{}"''' as the argument of the ''type''.
* A textfield is inserted using curly brackets at the desired position of the textfield.
** Note that curly brackets alone don't create a textfield. The curly brackets must have spaces between them and the enclosed text. '''{ Answer }''' works, but '''{Answer}''' doesn't work.
** The correct answer must be inserted between the curly brackets.
** The textfield can be positioned anywhere in the text. Text before and after the text field will display as normal text.
* The borders are a result of the border around the wiki table. They are optional.
* A non-breaking space was inserted between { and |type= because some text is required at that position (slightly buggy thing).
|-
|valign=top|
<pre>
{  
|type="{}"}
Name a famous Greek philosopher.
{ Aristotle|Plato }
</pre>

|
{|
|
<quiz display=simple>

{  
|type="{}"}
Name a famous Greek philosopher. { Aristotle|Plato }
</quiz>
|}
|valign=top|
* Typed responses often have more than one possible answer. You can list all the possible answers inside the curly brackets using a pipe to separate them.
* In the example, there are two possible answers. Try it - the demo is live.

|-
|valign=top|
<pre>
{  
|type="{}"}
Name Aristotle's famous mentor.
{ Plato _6 }
</pre>

|
{|
|
<quiz display=simple>

{  
|type="{}"}
Name Aristotle's famous mentor. { Plato _6 }
</quiz>
|}
|valign=top|
* To modify the size of the textfield, add an underscore and an integer following the answer within the curly brackets to represent the number of glyph spaces you need.
* This number depends, however it should be around n+2 (where n is the number of glyphs in the answer)

|-
|valign=top|
<pre>
{ Complete each box with a synonym
of the following words
|type="{}"}
#free: { gratis _6 }
#well: { good _4 }
</pre>

|valign="top"|
{|
|
<quiz display=simple>
{ Complete each box with a synonym of the following words
|type="{}"}
<ol><li>free: { gratis _6 }</li><li>well: { good _4 }</li></ol>
</quiz>
|}
|valign=top|
* You can group the items into one only question.
|-
|valign=top|
<pre>
{  
|type="{}"}
Where did Aristotle die?
{ Chalcis (i) }
</pre>

|
{|
|
<quiz display=simple>

{  
|type="{}"}
Where did Aristotle die? { Chalcis (i) }
</quiz>
|}
|valign=top|
* '''Case-sensitivity''': typed responses are ''case-sensitive'' unless you add '''''(i)''''' at the position shown. The (i) stands for case-'''in'''sensitive.
* If some question have more than one possible answer, you should include one '''''(i)''''' for each of them.

|}

=== Gapfill / cloze ===

{| class="prettytable"
|-
|'''wikitext'''
|
<pre>
{Complete the text from the Wikipedia article on [[w:Aristotle|Aristotle]].
|type="{}"}
Aristotle was born in { Stageira _8 } in Chalcidice. His parents were { Phaestis _8 }
and { Nicomachus _10 }, who became physician to King Amyntas of Macedon. Aristotle
was educated as a member of the aristocracy. At about the age of { eighteen|18 _8},
he went to { Athens _6 } to continue his education at { Plato _5 }'s Academy.
Aristotle remained at the Academy for nearly twenty years, not leaving until after
Plato's death in { 347 _3 } BC.
</pre>
|-
|'''rendering'''
|align=center|
{| class="prettytable" width=500
|
<quiz display=simple>
{Complete the text from the Wikipedia article on Aristotle.
|type="{}"}
Aristotle was born in { Stageira _8 } in Chalcidice. His parents were { Phaestis _8 } and { Nicomachus _10 }, who became physician to King Amyntas of Macedon. Aristotle was educated as a member of the aristocracy. At about the age of { eighteen|18 _8}, he went to { Athens _6 } to continue his education at { Plato _5 }'s Academy. Aristotle remained at the Academy for nearly twenty years, not leaving until after Plato's death in { 347 _3 } BC.
</quiz>
|}
|-
|'''comments'''
|
* Gapfills (or cloze exercises) are created in almost exactly the same way as typed responses. The difference is that you just write a bit more text and add a few more textfields.
* The gapfill above was additionally placed in a box and centered using a wiki table.
|}

=== Numerical response ===

{| class="prettytable"
!wikitext!!rendering!!comments
|-
|valign=top|
<pre>
{In which year was Plato born?
|type="{}"}
He was born in { 427-428 _5 } BC.
</pre>

|valign=top|
{|
|
<quiz display=simple>
{In which year was Plato born?
|type="{}"}
He was born in { 427-428 _5 } BC.
</quiz>
|}
|valign=top|
* At Wikiversity, numerical responses are a subtle modification of typed responses. The syntax is identical, except for some additions which allow numerical ranges and numerical tolerances if the answer is a number.
* In the example to the right, the uncertainty over Plato's date of birth is reflected in the answer by using a '''range'''. A simple hyphen between the numbers permits all numbers inbetween.

|-
|valign=top|
<pre>
{How far is the earth from the sun?
|type="{}"}
{ 91-95 _3 } million miles.
</pre>

|valign=top|
{|
|
<quiz display=simple>
{How far is the earth from the sun?
|type="{}"}
{ 91-95 _3 } million miles.
</quiz>
|}
|valign=top|
* This is another example of a range.
* The _3 ensures that the textfield doesn't get too wide.

|-
|valign=top|
<pre>
{What is 10*10?
|type="{}"}
{ 100 5% _3 }
</pre>

|valign=top|
{|
|
<quiz display=simple>
{What is 10*10?
|type="{}"}
{ 100 5% _3 }
</quiz>
|}
|valign=top|
* This is an example of specifying a '''tolerance'''. The critical part is "5%", which specifies the expected tolerance of 5%. In this example, values between 95 and 105 should work, but try it.
* At the time of writing, the underscore method of limiting the size of the textfield does not yet work in combination with a tolerance specification, so a range may be a better method of specifying numerical accuracy.

|-
|valign=top colspan=2 align=center|
{|width=500|
|
<quiz display=simple>
{Complete the following text, inserting words and numbers as appropriate.
|type="{}"}
The Earth formed around { 4.5-4.6 _3 } billion years ago and its only known natural satellite, the { Moon|moon _5 }, began orbiting it around { 4.5 _4 } billion years ago. At present, the Earth orbits the { Sun|sun _5 } once for every roughly { 366-367 _6 } times it rotates about its axis.
</quiz>
|}
|valign=top|
* Because numerical responses are, programmatically, a sub-variety of typed response, numerical and text responses can be freely mixed in a gapfill as shown to the left.

|}

=== Tabular response type with radio buttons ===

{| class="prettytable"
!wikitext!!rendering!!comments
|-
|
<pre>
{Question
|type="()"}
| A | B | C
+-- A is correct.
-+- B is correct.
--+ C is correct.
</pre>
|
{|width=360|
|
<quiz display=simple>
{Question
|type="()"}
| A | B | C
+-- A is correct.
-+- B is correct.
--+ C is correct.
</quiz>
|}
|
* Add extra radio buttons by reduplicating the +/- signs at the beginning of each row.
* There should only be one plus sign in each row.
* Specify columns headers by using pipes at the top.
|}

=== Tabular response type with checkboxes ===

{| class="prettytable"
!wikitext!!rendering!!comments
|-
|valign="top"|
<pre>
{Question
|type="[]"}
| Option A | Option B | Option C
++- Question 1
(Clue: A and B are correct).
-++ Question 2 (
Clue: B and C are correct).
--+ Question 3
(Clue: C is correct).
</pre>
|valign="top"|
{|width=360|
|
<quiz display=simple>
{Question
|type="[]"}
| Option A | Option B | Option C
++- Question 1 (Clue: A and B are correct).
-++ Question 2 (Clue: B and C are correct).
--+ Question 3 (Clue: C is correct).

</quiz>
|}
|valign="top"|
* This type of question has multiple everything.
* Correct answers are indicated by plus signs, incorrect ones by minus signs. By reduplicating the +/- signs at the beginning of each row, extra checkboxes can be added.
* The column headers are defined using pipes at the top as shown.
|}

== Advanced stuff ==

===Inserting feedback===

{| class="prettytable"
!wikitext!!rendering!!comments
|-
|valign="top"|
<pre>
{Question
|type="()"}
+ The correct answer.
|| Feedback for correct answer.
- Distractor.
|| Feedback for distractor.
- Distractor.
|| Feedback for distractor.
- Distractor.
|| Feedback for distractor.
</pre>
|valign="top"|
{|width=250|
|
<quiz display=simple>
{Question
|type="()"}
+ The correct answer.
|| Feedback for correct answer.
- Distractor.
|| Feedback for distractor.
- Distractor.
|| Feedback for distractor.
- Distractor.
|| Feedback for distractor.
</quiz>
|}
|valign="top"|
* Feedback is text which is initially hidden, and then shown to the user when they submit the quiz for correction. Feedback typically serves the purposes of encouragement, explanation, congratulation and commiseration.
* Feedback is set with all types by using a double vertical line '''<nowiki>||</nowiki>''' immediately after a response.
* The pipes beginning the ''feedback'' section must be on a new line.
* Unlike some other quiz systems, '''all''' feedback items are displayed on correction. With other quiz systems, the norm is to display the feedback only for those items which were selected by the user.
* To try out the feedback effect, choose a response and click the correction button. The feedback will then appear.
|}

=== Inserting blocks of text between questions ===

{| class="prettytable"
!wikitext!!rendering!!comments
|-
|valign=top|
<pre>
{This is the first question.
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.

{This is a block of text.}

{This is the second question.
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
</pre>
|
{|width=300|
|
<quiz display=simple>
{This is the first question.
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.

{
<div style="float:left;margin-right:0.9em">
[[Image:Arctic terns.jpg|100px|Arctic Terns]]
</div>

The '''Arctic Tern''' is a seabird of the tern family Sternidae. This bird has a circumpolar distribution, breeding colonially in Arctic and sub-Arctic regions of Europe, Asia, and North America (as far south as Brittany and Massachussets).
}

{This is the second question.
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
</quiz>
|}
|valign=top|
* Text blocks can be inserted between questions by placing it between curly brackets <nowiki>{....}</nowiki>.
* The text blocks can contain wiki markup, such images, hyperlinks and formatting tags, as shown in this example.
|}

===Using images as answers ===

{| class="prettytable"
!wikitext!!rendered!!comments
|-
|valign=top|
<pre>
<quiz display=simple>
{ Which of these are not nuts? }
- [[Image:Walnut03.jpg|100px]]
+ [[Image:Peanuts.jpg|100px]]
+ [[Image:Malus-Idared on tree.jpg|100px]]
- [[Image:Pistachios in a bag.jpg|100px]]
- [[Image:Chestnut.jpg|100px]]
+ [[Image:P10802511.JPG|100px]]
</quiz>
</pre>
|
{|
|
<quiz display=simple>
{ Which of these are not nuts? }
- [[Image:Walnut03.jpg|100px]]
+ [[Image:Peanuts.jpg|100px]]
+ [[Image:Malus-Idared on tree.jpg|100px]]
- [[Image:Pistachios in a bag.jpg|100px]]
- [[Image:Chestnut.jpg|100px]]
+ [[Image:P10802511.JPG|100px]]
</quiz>
|}
|valign=top|
* Unfortunately there does not yet seem to be a way of putting these into a row or tabularising the layout.
* Although this has not been done here for reasons of space, it is generally good practice to specify some kind of tooltip text for the images, but try to avoid text which gives away the answer.
|}

===Using images in the question===

{| class="prettytable"
!wikitext!!rendered!!comments
|-
|valign="top"|<pre>
<quiz display=simple>
{ What is this? [[Image:Butterfly tongue.jpg|100px| ]]
| type="()" }
- Tiger
+ Butterfly
- Bee
- Fly
</quiz>
</pre>
|valign="top"|
{|
|<quiz display=simple>
{ What is this? [[Image:Butterfly tongue.jpg|100px| ]]
| type="()" }
- Tiger
+ Butterfly
- Bee
- Fly
</quiz>
|}
|valign="top"|
In this example, the image is part of the question. You just use normal wiki-markup to insert the image(s).
|}

=== Using animations ===

The section adds no new technical tricks, but it looks pretty.

{| class="prettytable"
|valign=top|
{|
|
<quiz display="simple">
{ [[Image:Heringsschwarm.gif|thumb|left|What kind of fish are these?]] 
| typ="()" }
+ Herring
- Salmon
- Tunafish
- Goldfish
</quiz>
|}
|valign=top|
{|
|<quiz display=simple>
{ [[Image:Radial engine.gif|thumb|left|What's this?]] 
| typ="()" }
- a boxer engine
- a wankel engine
+ a radial engine
</quiz>
|}
|valign=top|
{|
|<quiz display=simple>
{ [[Image:Pyramid of 35 spheres animation.gif|thumb|left|How many balls are there here?]] 
| typ="{}" }
{ 35|thirty-five (i)|thirty five (i)|thirtyfive (i) }
</quiz>
|}

|}

===Hyperlinks and other markup===

==== Markup that works inside quizzes ====

* Hyperlinks: <nowiki>[[....]]</nowiki>.
* Images: <nowiki>[[Image:....]]</nowiki>.
* Other media: <nowiki>[[....]]</nowiki>.
* Bold and italic.
* <nowiki><big> and </nowiki>

==== Markup that partly works inside quizzes ====

* Templates: <nowiki>{{....}}</nowiki>.
** ''subst'' doesn't work.
* Tables: <nowiki>{|....|}</nowiki>.
* Headings: e.g. <nowiki>===....===</nowiki>.
** '''Warning:''' At the moment there is a problem with the toc.
* Lists and indents: using #, * and :

===Adding music and sound effects ===

This is similar to insertion of images. Standard wiki markup is used.

=== Configuring points ===

{| class="prettytable"
!wikitext (what you write)!!rendering (what you see)!!comments

|-
|valign=top|
<pre>
<quiz points="3/1!">
{Try this question now.}
+ Plus 3 points for this one.
- Minus 1 point for this one.
</quiz>
</pre>
|
{|
|<quiz points="3/1!">

{Try this question now.}
+ Plus 3 points for this one.
- Minus 1 point for this one.

</quiz>
|}
| valign=top|
* By default, there is 1 point for a correct answer and 0 for a wrong answer.
* You can change this for the whole quiz by using a ''points'' attribute for the ''quiz'' tag.
* The format is "X/Y!", where X gives the points for a correct answer and Y the points for a wrong answer. The Y points are expressed as a positive integer but are ''subtracted'' from the score.
* Values like 1.25 or 2.5 are allowed

|-
|valign=top|
<pre>
<quiz display=simple>
{Try this question now.
|type="()" }
+ 1 points for this one.
- 0 points for this one.

{Try this question now.
|type="()" coef="2"}
+ 2 points for this one.
- 0 points for this one.

{Try this question now.
|type="()" coef="4"}
+ 4 points for this one.
- 0 points for this one.

{Try this question now.
|type="()" coef="0.5"}
+ 1/2 point for this one.
- 0 points for this one.
</quiz>
</pre>
|
{|
|<quiz display=simple>

{Try this question now.
|type="()" }
+ 1 point for this one.
- 0 points for this one.

{Try this question now.
|type="()" coef="2"}
+ 2 points for this one.
- 0 points for this one.

{Try this question now.
|type="()" coef="4"}
+ 4 points for this one.
- 0 points for this one.

{Try this question now.
|type="()" coef="0.5"}
+ 1/2 point for this one.
- 0 points for this one.

</quiz>
|}
| valign=top|
* A ''coefficient'' is a way of giving a weighting to a specific question. Normally all the questions have the same number of points. By default, they all have one point. By specifying a coefficient for each or any question, you can multiply the number of points for that question by the coefficient.
* Coefficients can be both numbers above one and numbers between 0 and 1. If the coefficient is above 1, the question will receive greater weighting. If the coefficient is less than 1, the question will receive less weighting.
* You '''must''' put inverted commas around the argument of the ''coef'' attribute.

|}

===Shuffle Control Tags ===
{| class="prettytable"
!wikitext!!rendered!!comments
|-
|valign=top|
|-
|valign=top width=200|<quiz> 
{X} 
{ Sample Question 1 |type="()"} + The correct answer. - Distractor. - Distractor. - Distractor. 

{ Sample Question 2 |type="()"} + The correct answer. - Distractor. - Distractor. - Distractor. 
{\X} 

{!X} 
{ Sample Question 3 |type="()"} + The correct answer. - Distractor. - Distractor. - Distractor. 

{ Sample Question 4 |type="()"} + The correct answer. - Distractor. - Distractor. - Distractor. 
{\X} 

</quiz>
|valign=top|
{|
|<quiz>

{X}

{Sample Question 1
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

{Sample Question 2
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

{/X}

{!X}

{Sample Question 3
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

{Sample Question 4
|type="()"}
+ The correct answer.
- Distractor.
- Distractor.
- Distractor.

{/X}

</quiz>
|}
|valign=top|'''Conditional shuffling using tags''':It can be achieved by using {X},{!X} and {/X} tags inside quiz.Any questions that are within {X} and {/X} are treated as a block and will be shuffled.The questions that are within {!X} and {/X} are not shuffled internally, i.e the order of questions inside {!X} and {/X} remain the same.
In the example Sample Question 1 and 2 can be shuffled but Sample Question 3 and 4 are always in the same order.
|-
|}

== Troubleshooting ==

* You '''cannot''' test out the quiz while editing a page, because the ''submit'' button is grayed out. If you wish to test your new quiz, then create a sandbox page somewhere else first (e.g. as a subpage of your user page), then test the quiz there, and finally transfer the quiz to its final location (and test it again anyway).
* The quiz was developed for IE6, IE7, Firefox (and Opera?), but display quality on Opera may not be optimal, and there may be display differences between browsers.
* A reminder: each question must be separated by a blank line, otherwise the questions are merged together into one question.

== Future stuff ==

Information about future developments is mainly available at the [[mw:Extension:Quiz|project space on MediaWiki]]. Lots of things are in planning.

 [[#top|Back to top of page]] - [[English|Back to Welcome Page]] 

[[Category:Mediawiki]]

@@ Line 1: / Line 1: @@
 '''<span style="color:white; background:white">[[PageName::{{PAGENAME}}|]]</span>'''
 <!-- Template Infobox Software -->
-{{Template-uk:Class-Infobox-Software
+{{Template:Class-Infobox-Software
 	|image = <!-- If an logo is required, enter the link here -->
 	|Section = [[Section::{{PAGENAME}}]]

@@ Line 15: / Line 15: @@
 }}
 <!-- End of Template Infobox Generic-->
-[{{fullurl:{{FULLPAGENAMEE}}|action=mpdf}} Download this page as PDF]== Description ==
+== Description ==
 == Installation ==

@@ Line 11: / Line 11: @@
 	|LastEdit = [[LastEdit::{{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}]]
 	|Status = [[Status::Active]] <!--[[Status::Active]]  [[Status::Development]] [[Status::Obsolete]] [[Status::Archived]] [[Status::To Delete]]-->
 }}
 <!-- End of Template Infobox Generic-->

@@ Line 1: / Line 1: @@
-'''<span style="color:white; background:white">[[PageName::{{PAGENAME}}|]]</span>'''
+<!-- Template Infobox Generic-->
-<!-- Template Infobox Software -->
+{{Template:Class-Infobox-Generic<!-- ALL MUST BE FILLED IN -->
 	|image = <!-- If an logo is required, enter the link here -->
 	|Section = [[Section::{{PAGENAME}}]]
-	|Source =  [[Source::DataSource]]<!-- [[Source::DataSource]], [[Source::Semantic Query]], ... -->
+	|Source = [[Source::DataSource]]  <!-- [[Source::DataSource]], [[Source::Query]] ... -->
-	|Version = [[Version::MW-1.35-LTS]]<!-- [[Version::MW-1.31-LTS]] -->
+	|Language = [[Language::English]] <!-- [[Language::English]], [[Language::Français]], [[Language::Nederlands]] -->
-	|Language = [[Language::English]]<!-- [[Language::English]], [[Language::Français]] -->
+	|Topic =  [[Topic::Mediawiki]] <!-- [[Topic::Mediawiki]], [[Subject::Microsoft]], ... -->
-	|Subject =  [[Subject::Mediawiki]]<!-- [[Subject::Mediawiki]], ... -->
+	|SubTopic = [[SubTopic::Mediawiki Extension]] <!-- [[SubTopic::Mediawiki Extension]], [[SubTopic::Office 365]] , ... -->
-         |DocumentType =  [[DocumentType::Extension]]<!-- [[DocumentType::Extension]] -->
+         |DocumentType =  [[DocumentType::Documentation]] <!-- [[DocumentType::User Guide]], [[DocumentType::Procedure]], [[DocumentType::Script]], [[DocumentType::Gallery]], ...-->
 	|LastEditBy = [[LastEditBy::{{REVISIONUSER}}]]
 	|LastEdit = [[LastEdit::{{REVISIONYEAR}}-{{REVISIONMONTH}}-{{REVISIONDAY2}}]]
-	|DocumentStatus = [[DocumentStatus::Active]] <!--[[DocumentStatus::Active]]  [[DocumentStatus::Development]] [[DocumentStatus::Obsolete]] -->
+	|Status = [[Status::Active]] <!--[[Status::Active]]  [[Status::Development]] [[Status::Obsolete]] [[Status::Archived]] [[Status::To Delete]]-->
 }}
-<!-- End of Template Infobox Software -->
+<!-- End of Template Infobox Generic-->
 == Description ==