Help:Quiz

This is the help page for the quiz extension.

For a simple and colourful guide, see Help:Quiz-Simple.

The quiz extension consists of very simple markup. This page is long because of the many possibilities which the quiz extension opens up.

Also see the Quiz learning project.

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 {X} {!X} {/X} tags.

Pedagogical considerations

 * Where are the strengths and weaknesses of Wikiversity quizzing?
 * How can you best use the quiz extension as a teaching tool?
 * Wikiversity compared to Moodle - offers a detailed consideration of the quiz feature differences between Moodle and Wikiversity, including suggestions as to how each is best used.

The quiz tag
{| class="wikitable" !wikitext (what you write)!!rendering (what you see)!!comments
 * valign=top width=200|&lt;quiz&gt; insert questions here &lt;/quiz&gt;
 * valign=top|
 * 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.
 * 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|&lt;quiz display=simple&gt; insert questions here &lt;/quiz&gt;
 * valign=top|
 * 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.
 * This is useful for short quizzes, and especially for situations where you insert single questions between text blocks.


 * valign=top|&lt;quiz shuffle=none&gt; insert questions here &lt;/quiz&gt;
 * valign=top|
 * valign=top|


 * 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|&lt;quiz shuffleanswers=true&gt; questions with proposal shuffled on reload here &lt;/quiz&gt;
 * valign=top|
 * 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.
 * valign=top|


 * }

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 &lt;quiz&gt; 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.

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

Markup that works inside quizzes

 * Hyperlinks: .....
 * Images: [[Image:....]].
 * Other media: .....
 * Bold and italic.
 * and

Markup that partly works inside quizzes

 * Templates:.
 * subst doesn't work.
 * Tables: {|....|}.
 * Headings: e.g. ===....===.
 * 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.

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 project space on MediaWiki. Lots of things are in planning.

Wikiversity

 * Quiz learning project
 * Simpler version of this documentation

Wikipedia

 * Educational assessment and evaluation category
 * Multiple choice testing
 * Cloze testing
 * Quiz

MediaWiki

 * The quiz extension project at MediaWiki where discussion and development of the quiz extension takes place.

de:Wikiversity:Quiz el:Βοήθεια:Quiz fr:Aide:Quiz it:Aiuto:Quiz pt:Wikiversidade:Quiz sl:Pomoč:Quiz/Sl sv:Hjälp:Quiz