Reference

[qwiz] … [/qwiz] A quiz.

Options: [qwiz align=”left” dataset=”” dataset_intro=”true” display_name=”” qrecord_id=”” random=”false” repeat_incorrect=”true” style=”border: 1px solid black;” use_dataset=””]

align. Horizontal alignment of quiz box. “left” (default), “center”, “right”.

dataset.  Name under which these questions are saved in the Qwizcards database.  You should not enter or change this yourself; It is set by the “Quizzes/decks – use ‘dataset’ or save as ‘dataset'” option of the Qwizcards editing menu.

dataset_intro.  For a quiz that uses questions from a dataset, whether the introductory menu to choose questions by unit and topic will be shown.  “true” (default) or “false“.

display_name.  For a quiz that uses questions from a dataset, the name displayed when the user chooses among units at the beginning of a quiz session.  Default is the name of the dataset.  You may specify the color and font of the name you provide.  See Datasets.

qrecord_id. ID for recording student progress. You should not enter or change this yourself; It is set by the “Enable progress recording for quizzes/flashcard decks” option of the Qwizcards editing menu.

random. Present questions in shuffled order. “false” (default: questions are presented in order entered) or “true“.

repeat_incorrect. Incorrectly-answered questions will be repeated at the end of the quiz until all questions have been answered correctly. “true” (default) or “false” (users do not get additional chances to answer questions).

style. CSS style settings for quiz box. “border: 1px solid black;” (default). You can use standard CSS specifications to change the border, width, etc. of a quiz box.

use_dataset.  Dataset from which questions will be drawn for this quiz.  You should not enter or change this yourself; It is set by the “Quizzes/decks – use ‘dataset’ or save as ‘dataset'” option of the Qwizcards editing menu.

[qdeck] … [/qdeck] A flashcard deck.

Options: [qdeck align=”left” card_back=”” card_back_image=”” click_flip=”true” dataset=”” dataset_intro=”true” display_name=”” qrecord_id=”” random=”false” scroll=”false” style=”border: 1px solid black;”]

align. Horizontal alignment of flashcards. “left” (default), “center”, “right”.

card_back.  The default card back is “ruled lines” (like a 3 x 5 index card).  You can specify “none” to hide the lines, or an HTML color of your choice (for example, card_back=”LightGray”).

card_back_image.  Alternative to card_back.  You can specify your own image by providing a URL.

click_flip. Clicking on a card causes a flip. “true” (default) or “false”.

dataset.  Name under which these flashcards are saved in the Qwizcards database.  You should not enter or change this yourself; It is set by the “Quizzes/decks – use ‘dataset’ or save as ‘dataset'” option of the Qwizcards editing menu.

dataset_intro.  For a deck that uses flashcards from a dataset, whether the introductory menu to choose cards by unit and topic will be shown.  “true” (default) or “false“.

display_name.  For a deck that uses flashcards from a dataset, the name displayed when the user chooses among units at the beginning of a flashcard session.  Default is the name of the dataset.  You may specify the color and font of the name you provide.  See Datasets.

qrecord_id. ID for recording student progress. You should not enter or change this yourself; It is set by the “Enable progress recording for quizzes/flashcard decks” option of the Qwizcards editing menu.

random. Initial order of cards is random. “false” (default: the initial order of the cards is the order in which they are entered) or “true”.

scroll.  Whether the card-size will expand to accommodate the card contents (“false”, the default) or scrollbars will appear to allow you to view the “overflow” (“true”).

style. CSS style settings for flashcards. “border: 1px solid black;” (default). You can use standard CSS specifications to change the border, width, etc. of a flashcard deck.

[h] Header.  Text that will appear in a bar at the top of a quiz box or flashcard deck.
[i] Introduction.   Introductory text/images that will appear on a quiz or flashcard deck before the first question or card.
[q] A question or flashcard front.

Options: [q labels=”right” topic=”[none]” unit=”[none]”]

labels.  In a labeled-diagram (drag-and-drop) quiz, where labels are positioned. “right” (default), “top”, “left”, “bottom”.

topic.  A summary category or categories for this question or card. At the end of a quiz or flashcard deck incorrectly-answered questions will be summarized by topic. Multiple topics for a question or card are separated by a semicolon. If a topic is entered for a question or card then a topic should be entered for every question or card in a quiz or flashcard deck.  Default: none.

unit.  A category for this question.  Progress (shown via a link in the triangle pull-down menu at the top right of each quiz) will be summarized by unit.  For questions drawn from a dataset, users may select among units for the questions they will do.  Default: none.

[a] Answer/flashcard back (flashcards only).
[c], [c*] Choices (quizzes only, except with [textentry] on flashcards). Alternative multiple-choice answers – asterisk indicates correct answer.
[f] Feedback for each choice.
[l] Label (quizzes only). Label that can be dragged to a target (“hot spot”) within a diagram or text.
[f*] Feedback given when a label is correctly placed. 
[fx] Feedback given when a label is incorrectly placed.
[textentry] (flashcards) Input text field. Text entered by user that is shown on the card back.
[textentry] (quizzes and flashcards, when followed by [c*]) Free-form word match field. Suggestions provided in response to characters entered.

Options: [textentry minlength=”3″ plural=”false” single_char=”false” suggest=”true” use_dict=”true” use_terms=”true”]

minlength. Length of entry when suggestions are first shown. 3 (default: suggestions are shown only when the user has typed three or more characters).

plural. Plural forms of suggestions will be shown. “false” (default) or “true”.

single_char. Single-character input: as soon as the user types a character either feedback is provided (quizzes) or the card is flipped (flashcards). “false” (default) or “true”.

suggest (quizzes only).  Whether word suggestions will be shown.  If suggest=”false” then no suggestions will be provided at all, and the user must type a correct choice (specified with [c*]) to get the question correct.  “true” (default) or “false”.

use_dict. English-word dictionary is a source for suggestions. “true” (default), “false”.

use_terms. Either default or substitute term lists are a source for suggestions. “true” (default) or “false”.

[hangman] Hangman-format input field.

Option: [hangman hints=”2″]

hints.  The maximum number of hint requests that a user can make.  One letter of the answer word is filled in for each hint request.

[x] Exit text/images. Content that will appear after the user completes a quiz or flashcard deck.
[restart] Restart quiz/flashcard-deck button. In exit text, specifies that a “Take this quiz again” button will appear.
[!] … [/!] or [!!] … [/!!], etc. Comment. Text that will not be visible to users.  Note: comments  cannot be nested.
[qwizdemo] … [/qwizdemo] or [qdeckdemo] … [/qdeckdemo] Demo shortcodes. Shortcodes, such as [qwiz], etc., will be presented to users as plain text rather than as quizzes or flashcard decks. Useful if you want to demonstrate how Qwizcards works (as on this page!).