Help:Quiz/How to create a quiz using the quiz tool

The WikiEducator quiz feature offers functionality to create multiple-choice (single response and multiple response), true-false, short answer (typed response), cloze (providing missing word(s) in a phrase), numerical response, and tabular response questions using wikitext. In addition, the quiz feature includes a feedback option (e.g., for each option in a multiple-choice question), as well as the ability to include images, animations, audio, and hyperlinks.

How to insert a quiz into your page
The quiz feature has two components: 1) the quiz tag with optional attributes and 2) the question text and wikitext to specify the question type.

The quiz tag
The wikitext tags implement the basic quiz functioning (see first row in the table below.) The second row in the table displays the code to suppress the display of the scoring table; the quiz score is then displayed as #right/total following the quiz. The third row displays the code to suppress the question shuffle feature. {| class="prettytable" !wikitext (what you write)!!rendering (what you see)!!comments insert questions here &lt;/quiz&gt;
 * valign=top width=200|&lt;quiz&gt;
 * valign=top width=200|&lt;quiz&gt;
 * valign=top|
 * valign=top|The quiz feature parses the text between the quiz tags, to the extent possible, to create quiz questions. The quiz tags create the following quiz elements:
 * a table for displaying/entering scoring points to award for right and wrong responses as well as for indicating to use or ignore coding for differentially weighted questions (i.e., questions' coefficients); displayed at the top prior to the first question in the quiz
 * a Shuffle questions button, which must be used prior to answering any of the questions; once the quiz-taker starts answering questions, the order is locked; displayed at the top prior to the first question in the quiz
 * a Submit button for use by the learner to score his/her responses; displayed below the last question in the quiz.
 * Once scored, a colour-key indicating assigned colours for right, wrong, and not-answered responses; displayed at the top.

Note that at this time, it is not possible to score, separately, questions occurring on the same page, even if placed in separate quiz tags.

insert questions here &lt;/quiz&gt;
 * valign=top|&lt;quiz display=simple&gt;
 * valign=top|&lt;quiz display=simple&gt;
 * valign=top|

Use "display=simple" as an attribute in the quiz tag to remove the "scoring points" table at the top. Consider using this option when:
 * valign=top|
 * the quiz is for self-assessment and scoring is only for personal information.
 * it is unlikely that users will want to revise the points awarded for rights/wrongs and the quiz doesn't use differentially weighted questions in the scoring.

insert questions here &lt;/quiz&gt; Use "shuffle=none" as an attribute in the quiz tag to remove the Shuffle questions button.
 * valign=top|&lt;quiz shuffle=none&gt;
 * valign=top|&lt;quiz shuffle=none&gt;
 * valign=top|
 * valign=top|


 * }

Inserting questions
The basic structure of the question component includes


 * The question text (or the characters " ", called the non-breaking space code, because some text is required at this point).
 * The type of question, which indicates the type of response area:
 * type="" displays a radio button next to each option (only one choice allowed)
 * type="[]" displays a check box next to each item(two or more choices allowed)
 * type="{}" displays a textbox (the size of the text box can be adjusted larger or smaller)
 * The answer choices, if displayed, as in multiple-choice and true/false questions
 * An indication or listing of the right answer(s)
 * Feedback text for a text box or each answer choice (optional)

How you arrange these few features creates the various question types which may be included in a quiz.

The next section includes instructions for how to code for each of the basic question types.

Basic question types
The basic question types are described below by example. Both wikitext and rendering are provided. The wikitext shows you the code, which you may copy and paste into your pages, or just read and understand. The rendering shows you what the result will look like.

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

For clarity, the examples provided below are displayed in a table. However, when a quiz is inserted into a table, the appearance of a quiz is modified, for example, boxes appear around some elements in the quiz. When a page includes a quiz not in a table, the boxes are not displayed and the format of the quiz appears simpler.

All the examples below are functioning quizzes. Don't be afraid to try them out. Hitting the Submit button is OK - it won't change or damage this page.

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.

About the WikiEducator quiz feature
The quiz feature is powered by MediaWiki's quiz extension; see the WikiMedia project page for specifics about the extension, as well as discussion and development of future functionality.

Acknowledgements
Portions of this page were adapted from:
 * Help:Quiz. In Wikiversity, retrieved 24 August 2011.