Reference

Please note that almost all of these options can be set using interactive menu choices available in the Qwizcards wizard (in the WordPress editor, click the “Q” icon, and then select “Qwizcards interactive editing wizard”).

[qwiz] … [/qwiz] A quiz.

Options: [qwiz align=”left” dataset=”” dataset_intro=”true” display_name=”” hide_forward_back=”false” hide_progress=”false” hide_qwizcards_icon=”false” qrecord_id=”” question_time_limit=”0″ questions_to_show=”” quiz_timer=”false” random=”false” repeat_incorrect=”true” reshow_after=”0″ spaced_repetition=”true” style=”border: 1px solid black;” summary=”true” 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.

hide_forward_back.  You can hide the “Go to previous question/Go to next question” controls (at the top left of the quiz).  “false” (default) or “true”.

hide_progress.  You can hide the “n correct … n to go” progress report  (at the top right of the quiz).  “false” (default) or “true”.

hide_qwizcards_icon.  You can hide the “Q” icon  (at the bottom left of the quiz).  “false” (default) or “true”.  Note: you can set a default option across your site in Dashboard > Settings > Qwizcards.

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.

question_time_limit. Time limit, in seconds, for user to answer eacb question.  A countdown clock is shown at the bottom right of the quiz.  If the user doesn’t answer a question within the limit, the question is marked “incorrect.” “0” (default: no time limit; clock not shown) or, for example, “30” (seconds).

questions_to_show. If set to a number less than the number of questions in this quiz, then a random subset of the quiz questions will be selected and made available to the user.  If the quiz is a dataset or uses questions from a dataset, then this number will be the default choice for “questions to practice.”  Default: all questions are shown.

quiz_timer.   A digital clock at the top right of the quiz shows the elapsed time spent on the quiz.  If the user is a member of a class, then a “leaderboard” showing “Fastest finish times” for that class is shown when the student finishes the quiz. “false” (default: no timer) or “true”.

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).

reshow_after. Incorrectly-answered questions will be shown again after this many more questions are attempted.  Default (“0”): incorrectly-answered questions are shown again only after all questions have been attempted.

spaced_repetition. For datasets, when dataset_intro=”false”, controls whether previously-answered questions will be repeated, or all questions will be shown.  “true” (default – questions previously-answered correctly may be shown again) or “false” (all questions are shown).

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.

summary.  Whether a score summary is presented when a user completes the quiz.  “true” (default: a summary is presented) or “false”.

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=”” card_time_limit=”0″  cards_to_show=”” click_flip=”true” dataset=”” dataset_intro=”true” deck_timer=”false” display_name=”” flip_direction=”random” gotit_active=”false” hide_flip=”false” hide_forward_back=”false” hide_gotit=”false” hide_progress=”false” hide_shuffle=”false” qrecord_id=”” random=”false” scroll=”false” reshow_after=”0″ show_first=”front” spaced_repetition=”true” style=”border: 1px solid black;” summary=”true”]

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

card_back.  The default card back “background” 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 (as a “background” behind any text or images that you place on the card back) by providing a URL.

card_time_limit. Time limit, in seconds, for user to click “Check answer” for eacb card.  A countdown clock is shown at the bottom right of the deck.  If the user doesn’t flip the card within the limit, “Got it” is disabled; the user must click “Need more practice.” “0” (default: no time limit; clock not shown) or, for example, “30” (seconds).

cards_to_show. If set to a number less than the number of cards in this deck, then a random subset of the deck cards will be selected and made available to the user.  If the deck is a dataset or uses cards from a dataset, then this number will be the default choice for “cards to practice.”  Default: all cards are shown.

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“.

deck_timer.   A digital clock at the top right of the flashcard deck shows the elapsed time spent on the deck. “false” (default: no timer) or “true”.

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.

flip_direction.  Normally cards flip either left-to-right or up-and-down – at random.  You can specify the direction: “left_right”, “up_down”, or (default) “random”.

gotit_active.  Allow users to skip cards without viewing the card back (the “Got it!” button is always enabled, and re-labeled as “Skip”).   “false” (default: “Got it!” is only enabled after the user has flipped the card) or “true”.

hide_flip.  You can hide the “Check answer” / “Flip back” button; users can only flip the card by clicking on it (do not set hide_flip=”true” and click_flip=”false” at the same time; users won’t be able to flip cards!).  “false” (default) or “true”.

hide_forward_back.  You can hide the “Go to previous card/Go to next card” controls (at the top left of each deck).  “false” (default) or “true”.

hide_gotit.  You can hide the “Got it!” button; the “Need more practice button” will become “Next card”.  This creates an “endless” flashcard deck – cards will always go to the “bottom of the deck.”  “false” (default) or “true”.

hide_progress.  You can hide the “cards to go/cards reviewed” progress report  (at the top right of the deck).  “false” (default) or “true”.

hide_qwizcards_icon.  You can hide the “Q” icon  (at the bottom left of the deck).  “false” (default) or “true”.  Note: you can set a default option across your site in Dashboard > Settings > Qwizcards.

hide_shuffle.  You can hide the “Shuffle button; cards will alway be shown in their original order (unless random=”true”).  “false” (default) or “true”.

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”.

reshow_after. Cards marked “Need more practice” will be shown again after this many more cards have been viewed.  Default (“0”): cards marked “Need more practice” are shown again only after all cards have been viewed.

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”).

show_first. Which side of each card will be shown first.  For example, for English-French language flashcards, you can randomize whether the English or the French is presented initially.  “front” (default), “back”, or “random”.

spaced_repetition. For datasets, when dataset_intro=”false”, controls whether previously-viewed cards will be repeated, or all cards will be shown.  “true” (default – cards previously-marked “Got it!” may be shown again) or “false” (all cards are shown).

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.

summary.  Whether a summary of cards marked “Got it” versus those marked “Need more practice” is presented when a user completes the flashcard deck.  “true” (default: a summary is presented) or “false”.

[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.  Default: 3.

[x] Exit text/images. Content that will appear after the user completes a quiz or flashcard deck.
[restart] Restart quiz/flashcard-deck button. Within exit text, specifies that a button for “Take this quiz again” (quizzes) or “Review this flashcard stack again” (decks) will appear.

Re-do question button.  Within feedback (shortcode [f]) for a quiz question, specifies that a button for “Do this question again” will appear.

Option: [restart label=”Re-take this quiz”]

label.  Text that will appear in place of “Take this quiz again” (quizzes) or “Review this flashcard stack again” (decks) or “Do this question again” (quiz question feedback).

[qscores] Create a “Login/view scores”  link. This provides a shortcut to the “View scores” page for students.  If the student is already logged in, the link text will be “View scores“.
[no_click_flip] … [/no_click_flip] No card flip for an element or shortcode. If you want to include a button or link or an image that links to another page on a flashcard, but do NOT want the card to flip when the user clicks on the button or element, enclose it within a “no_click_flip” shortcode pair.
[!] … [/!] 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!).
[simply‑random] … [/simply‑random] Randomly choose “items” from a list. “Items” may be any page element – a paragraph, an image, a quiz, a flashcard deck, etc.  Chosen items appear in the displayed page; others are not shown.  The random choices change with every page load.   Items are delineated by [simply-random-item] shortcodes within the [simply-random] … [/simply-random] shortcode pairs.

Matching game flashcards provides a demo and sample page source with shortcodes.

Options: [simply-random draw_n=”1″ with_replacement=”false”]

draw_n.  The number of items to choose from the list.  If the number to choose is greater than the number of items in the list the choices will start over with a “fresh list.”  Default: 1.

with_replacement.  Normally, once an item is chosen it is not available to be chosen again.  If this option is set true, then each item is always available to be chosen.  Default: false.

[simply‑random-item] An item in the list between [simply-random] … [/simply-random] shortcode pairs. “Items” may be any page element – a paragraph, an image, a quiz, a flashcard deck, etc.

Options: [simply-random-item weight=”1″]

weight.  A relative weight – the relative chance of this item being chosen.   For example, if you have two items in your list, and you want the second item to appear very rarely (one time in one-hundred, say), then the weight on the second item should be approximately 0.01.  Default: 1; all items have an equal chance of being chosen.

[qlatex] … [/qlatex]

or

[qlatexinline] … [/qlatexinline]

Mathematics equation display with the LaTeX markup language.  With [qlatex] equations are formatted in “display” mode – equations are shown in a centered block independent of preceding and following text (see the example below).  With [qlatexinline] equations are displayed within text lines; \(\def\rcancel#1{{ {\color{red} \bcancel{\color{black} \ce{#1}}} }} E = mc^2\), for example.

LaTeX formatting in Qwizcards is done client-side (within the browser) using MathJax.  There are many extensions – such as \ce{…} for chemical equations – that all appear to work without any extra setup.  LaTeX is very capable, for example, \[ \ce{ \pu{ 95.2 \rcancel{g}} \rcancel{MgCl2} } \times \frac{\ce{ \pu{ 1 mol } MgCl2 }}{\ce{ \pu{ 95.2 \rcancel{g}} \rcancel{MgCl2} }} = \ce{ \pu{ {\color{blue}\bf{\fbox{?}}} mol } MgCl2 } \]but requires a good deal of patience and attention to detail!  See the MathJax extension list and additional documentation.

[qperiodic_table] … [/qperiodic_table] Link for pop-up periodic table widget.  The text inside the shortcodes becomes a link that, when clicked, pops up a clickable, movable, resizable periodic table of the elements.  For example: Pop-up periodic table
[qpopup] … [/qpopup]

(Coming in version 3.89)

Automatic one-time pop-up widget.  The text inside the shortcodes becomes the content of a popup-window that is shown the first time a user visits that page (with the same computer/browser — a “do-not-show-again” cookie is set for that page).  Note: the pop-up is not shown to logged-in users (students).

Options: [qpopup height=”auto” show=”5″ title=”Please join our mailing list” width=”500″]

height.  The height of the pop-up window, in pixels.  Default: auto (the height adjusts to the contents).

show.  The time, in seconds after the page loads, until the pop-up is shown. Default: 5.

title.  Text displayed in the header-bar of the pop-up.  Default: Please join our mailing list.

width.  The width of the pop-up window, in pixels.  Default: 500.