Template:Quiz Multiple Choice/doc

From WikiEducator
Jump to: navigation, search

This is the documentation for Template:Quiz Multiple Choice.


This template is used to create multiple choice quiz questions. One or more questions may be included for each implementation of the template.

This is an experimental feature, with functionality and format subject to change based on user feedback.

Usage

Parameters

The Quiz_Multiple_Choice template requires one parameter:

body
the quiz in the form of a nested un-ordered list. The top level items in the list are questions, the next level are the answers, and the lowest level contains the feedback to be displayed when the student selects that particular answer. This formatting makes it easy to edit and print the teacher's resource that shows the questions and answer. (Note: The unordered list must start on the next line so that the standard wikitext list formatting is recognized.)

Optional parameters include:

title
the title for the quiz (if not supplied, defaults to ***Multi Choice Questions***)
theme
the iDevice theme to use (defaults to ***WikiEducator***)
mix
if set to the string ***true*** the answers are randomized within each question when the page is displayed/refreshed
hint
provides a tip for the entire set of questions

Wiki Syntax

Copy and paste the following code. Be sure that each set of asterisks, which occur prior to the question, answer and feedback text, begins on the left margin of a new line.

{{Quiz_Multiple_Choice
|title=A Multiple Choice Quiz
|body=
* Question 1
** Answer 1
*** Feedback 1
** Answer 2
*** Feedback 2
** Answer 3
*** Feedback 3
* Question 2
** Answer 1
*** Feedback 1
** Answer 2
*** Feedback 2
|mix=
|hint=
}}

Examples

A basic example which does not include the mix and hint options:

Icon qmark.gif
A Multiple Choice Quiz
  • Question 1
    • Answer 1
      • Feedback 1
    • Answer 2
      • Feedback 2
    • Answer 3
      • Feedback 3
  • Question 2
    • Answer 1
      • Feedback 1
    • Answer 2
      • Feedback 2



An example which includes the mix and hint options:

Icon qmark.gif
A Multiple Choice Quiz
  • Question 1
    • Answer 1
      • Feedback 1
    • Answer 2
      • Feedback 2
    • Answer 3
      • Feedback 3
    • Answer 4
      • Feedback 4
  • Question 2
    • Answer 1
      • Feedback 1
    • Answer 2
      • Feedback 2


Icon present.gif
Tip: The hint text displays here.


See also

Template Data for VisualEditor

<templatedata> { "description": "Multi choice quiz", "params": {

               "body": {
                       "label": "Body",
                       "description": "Unordered list representing quiz (on a new line)",
                       "aliases": ["3"],
                       "default": "",
                       "type": "string"
               },
               "theme": {
                       "label": "Theme",
                       "description": "style family (e.g. WikiEducator, OP, Line, Blue, etc.)",
                       "aliases": [],
                       "default": "WikiEducator",
                       "type": "string"
               },

"title": { "label": "Title", "description": "title, if other than the iDevice type", "aliases": ["2"], "default": "", "type": "string" },

               "hint": {
                       "label": "Hint",
                       "description": "Tip string for the quiz",
                       "aliases": [],
                       "default": "",
                       "type": "string"
               },
               "classes": {
                       "label": "Classes",
                       "description": "additional HTML classes to apply to iDevice (advanced use only)",
                       "aliases": [],
                       "type": "string"
               }

} } </templatedata>