Enter list of vocabulary terms:
This script generates vocabulary matching questions in GIFT format to import into Moodle. Vocabulary terms from which you wish to create questions must be entered into the text area above. If you have, e.g., a list of terms and definitions from an Excel spreadsheet, you may copy and paste them.
Terms must be entered one per line, with the term and corresponding definition on the same line separated by a tab. There should be no other tabs in the input, unless there are alternate terms for the same definition. For example:
If you include alternate terms for the same definition, each time the definition is used, one of the alternate terms will be selected at random to be included in the question. Note that text will wrap in the text area, but you should not have any line breaks in the definition.
Optionally, you may include feedback for each term, which will be displayed in accordance with the quiz and question settings when you use the questions in Moodle. For matching questions in Moodle, the feedback for all the terms is shown at the end of the question.
There are a number of options you can set, including the question text, the number of terms and distractors for each question, or the separator characters used in the input. Click the help button next to each option input for more information.
Note, though terms used as distractors may be used in more than one question, each definition will be used in at most one question. If the number of definitions in each question does not divide evenly into the total number of definitions entered, some terms will not be used. To make sure all the definitions appear at least once, you can generate multiple sets of questions.
After entering all the vocabulary terms and setting the options as desired, click Generate Questions. The input list will be "shuffled"-- that is, the order of the terms will be randomized, and the Moodle formatted questions will appear at the bottom of the page. The script will select the formatted questions, but you must and copy them, e.g., by pressing Cntrl-C, then paste them into a text editor (e.g., Notepad). You must then save the output as a file to import into Moodle.
Revise question text if desired.
The same question text is used for all questions each time this script is used to generate questions. If you wish, you may edit the question text in the text area below.
|Enter first question number for question title:|
Sequential question numbers are included in the question title. If you want a different starting number, enter it in the text box above. If you do not want sequence numbers in the question titles, leave the starting question number text box blank.
Note, when this script is loaded into your browser, the starting number is initialized to 1. When you generate questions, it is updated to the next number following the last question number generated.
|Enter text to include in question title:
Check to put title text after vocabulary terms in title. (Default is before)
Check to exclude vocabulary terms from title. (Included by default)
Question title text
You can specify text to include in the title of each matching question. Question titles can facilitate identification of questions for editing, inclusion in quizzes, etc. When GIFT formatted questions are imported into Moodle, titles are optionally enclosed in pairs of double colons. If no title is included, Moodle uses the question test as the title. Since the same question text is used for all the questions generated by this script, a title is recommended.
There is no limit on the length of the title, but in many contexts within Moodle, the title is truncated, so a long title is not particularly useful. By default, this script generates a title from a sequential question number (see above) along with a list of the terms included in the question. Note that if you enter alternate terms for the same definition, the term in the title may be different from the one in the question, since the term in the question title is always the one listed first, but the one in the question is selected at random from all the available alternatives. If you do not want the terms to appear in the question title, uncheck the associated box.
If you do include additional title text, you can specify whether it should appear before or after the terms. Note that this script will trim leading and trailing spaces from any question title text you enter.
|Enter number of definitions per question:|
Definitions per question
You can specify how many vocabulary terms to include in each matching question. Moodle requires at least three (3) terms per question. You may specify a larger number, but if you enter a number larger than the total number of terms, no output will be generated.
|Enter number of extra terms (distractors) per question:|
You can optionally specify how many "distractors"-- additional terms with no corresponding definitions-- to include in each question. The terms used as distractors will appear in the list of terms to match when the question is displayed in Moodle, but will not be a correct answer for any of the definitions. This script selects as distractors the terms from the shuffled input list following those used in the question with their definitions. Note, if the total number of definitions and distractors exceeds the total number of terms entered, some terms may be used both as correct answers and as distractors. The script does not check for this condition.
|Enter separator between terms and definitions, if other than tab:|
You can specify a different character, such as a comma, to use as the seperator between alternate terms and the definition in the input. Whatever character you specify must not be used anywhere else in the input (except in feedback), or it will be interpreted as as a seperator.
Depending on which browser and editing tool you use, you may not be able to enter tab characters directly in to the vocabulary list text area. This may be one reason to specify an alternate separator character, but you may be able to enter tabs by copying a single tab to the system clipboard, then pasting it as needed into the text area. You can also create the input list separately in a text editor, then copy and paste it all at once.
|Enter feedback separator, or leave blank if no feedback:|
Although Moodle docs indicate that matching questions do not support feedback, and feedback cannot be specified for individual terms in the online question editor, it does appear possible to include overall feedback for the whole question. This script collates the feedback specified for each term used in the question (with definition only-- not distractors) as feedback for the whole question.
By default, the pound sign (#) is used to indicate feedback both in this script and in the Moodle GIFT format (at least for matching questions). You can specify a different character, but if you are using the pound sign elswhere in your input, it may not import correctly. Also note that you can not use the same character to set off feedback and as a separator between terms and definitions (unless you specify feedback for every term.