Displaying the Quiz

For most users, you will follow a very basic usage. Just create any new page or post where you would like to insert the quiz. Then simply type in the shortcode  [mtouchquiz #] where the number is the id number of the quiz as seen on the far left column in “Manage Quizzes.” You may also use [mtouchquiz id=#]. Then when anyone visits this page or post, your quiz will display instead of the weird code. You can still put other words or images before or after that code to fancy up the page.

Various options are available to modify the behavior of the quiz, if you’d like to customize things further.

Simply add them to your shortcode as follows. No commas necessary.

[mtouchquiz id=# option1=value1 option2=value2]
For example: [mtouchquiz id=1 showanswers=now hints=off]

Option Description Default Determined Values Effect
id Determines which quiz to display. This can be located in the mTouch Quiz Dashboard. It is the numer in the first column of the “Manage Quizzes” Submenu. No default. Must specify Number Displays the questions from the Quiz with specified ID.
showanswers Determines when correct answers are indicated.Note: setting multiplechances=on will enforce the option showanswers=now In Quiz Options in Dashboard never Answers are never revealed.
end Answers are only revealed at the end of the quiz.
now Answers are revealed at the end of each question.
questions Determines how many questions are displayed. All questions Number The quiz will show the number of questions specified. Note that if randomq is not turned on, this will always be the same questions in the order they appear in the database.
randomq Determines if the questions are arranged randomly. In Quiz Options in Dashboard on Questions are displayed in a random order.
off Questions are displayed in the order they appear in the database.
randoma Determines if the answers are arranged randomly. In Quiz Options in Dashboard on Answers are displayed in random order.
off Answers are displayed in the order they appear in the database.
singlepage Determines if questions are displayed one at a time or all at once. In Quiz Options in Dashboard on All questions are displayed on a singple page with no “next” or “back” arrows.
off Questions appear 1 at a time with a “next” and “back” arrow to navigate to the next/previous items.
time Sets a time limit with a countdown clock. (Premium Feature) In Quiz Options in Dashboard 0 No time limit
Positive Integer Specifies the number of SECONDS before the quiz is automatically ended.
multiplechances Determines if multiple opportunities to answer a question is given.Note: setting multiplechances=on will enforce the option showanswers=now In Quiz Options in Dashboard on A user can attempt a problem more than once with partial credit for correct answer.
off A user can only attempt a problem once.
hints Determines if hints will be shown, when they have been supplied. In Quiz Options in Dashboard on Hints specified are displayed.
off Hints specified are not displayed.
startscreen Determines if the start screen created in the Quiz Options will be displayed. In Quiz Options in Dashboard on A user specified start screen is displayed along with a “Start” button to reveal the first question.
off No “Start” button or start screen is shown. The first question appears immediately.
finalscreen Determines if the final screen created in the Quiz options will be displayed. In Quiz Options in Dashboard on A user specified final screen is displayed. A “Get Results” button must be selected to show the screen.
off No final screen is shown.
list Determines if a summary list view will be available. This gives an easy way to navigate longer quizzes and to quickly determine which questions are compeleted. on on A list view is available.
off No list view is available.
autoadvance Determines if the questions automatically display after completing each question. off on After a question is completed, the next question is automatically displayed
off User must select the next arrow to see next question
proofread Determines if all hints and explanations and correct/wrong indicators are revealed automatically. This shows all questions in the database in order, in a singple page format. Note that this is a global option and if multiple quizzes are displayed on the same page, all quizzes generated after a quiz is in proofreading mode will also be in proofreading mode. This option simply includes a proofread mode CSS file which displayes everything. off on See description.
off Things display normally.
alerts Determines if a warning will be given before navigating away from a page containing an incomplete quiz. This is not currently supported (as of 2.1.0) in mobile browsers. In mTouch Quiz Options page (affects all quizzes unless changed on a per quiz basis) on A warning will be given if the quiz is not complete.
off No warning will be given.
title Determines if the quiz title is displayed. on on The title specified in the Quiz Options will be displayed.
off No title will be displayed.
labels Determines if the question labels “Question X” is displayed or not. on on Question labels will be displayed.
off No question labels will be displayed.
status Determines if the ‘real time’ grading and completion indicator line is displayed. on on A status line of current grading/completion will be displayed.
off No status will be shown.
offset Determines which question number to begin displaying. 1 Number Questions will only be chosen that are GREATER than OR EQUAL to the specified question number.
firstq Determines which question number to begin displaying. (Same as offset but with better name!) 1 Number Questions will only be chosen that are GREATER than OR EQUAL to the specified question number.
lastq Determines which question number to begin displaying. no effect Number Questions will only be chosen that are LESS than OR EQUAL to the specified question number.
singlequestion Allows for the display of a single question. no effect Number Only one question will be shown corresponding to the specified number.
formid Specify the form to use to submit quiz results. (Premium Feature) In Quiz Options in Dashboard Number Displays form specified for user to submit name and results.
autosubmit Specify if the form should be automatically submitted when a user hits “Get Results” off on Automatically submits when set to on.
showstamps Determine if the “Correct”, “Wrong” and “Partial-Credit” stamps appear at the end of the quiz even if you choose not to show correct answers. on end Turns ON the stamps at the end of the quiz regardless of showing correct answers.