MoodleDocs - User contributions [en]

GIFT format

2008-03-27T09:22:10Z

Scotru: /* See also */

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions in a text editor in a simple format. For large numbers of questions, GIFT is likely to provide the quickest way of bulk loading your questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] 

At least one blank line must be left between each question.

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

The file '''must''' be correctly encoded in [[UTF8]]. Beware of some of Microsoft's "fake" Unicode implementation which is not compatible and may result in strange characters appearing in your quizzes.

Here is a 2-column GIFT format reference sheet I created for a training:
*[http://buypct.com/gift_reference.pdf GIFT Reference Sheet]

===Hints and Tips===

* Use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1. Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.) In case you want no visible message displayed then enter a non-breaking space as feedback, so you'll have to put a # after the answer which may be ~3 and '''write & n b s p ; after that.(without spaces between these characters)'''
* If you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (for example in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* There are Word macros available for easily creating GIFT files. See [http://www.soberit.hut.fi/sprg/resources/moodle/GiftConverter.html].
* Here's an Excel spreadsheet for generating multiple choice GIFT files [http://moodle.org/mod/forum/discuss.php?d=45245] and a newer version that supports other question formats (be sure to scroll down to the most recent version) [http://moodle.org/mod/forum/discuss.php?d=66660].
* Here's an Open Office template for generating GIFT files. [http://moodle.org/mod/forum/discuss.php?d=20705&parent=168385]

==See also==

*[[Export questions]]
*[[Import questions]]
*[[Aiken Format]]
*[[Moodle XML format]]

[[Category:Questions]]

GIFT format

2008-03-27T09:21:29Z

Scotru: /* See also */

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions in a text editor in a simple format. For large numbers of questions, GIFT is likely to provide the quickest way of bulk loading your questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] 

At least one blank line must be left between each question.

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

The file '''must''' be correctly encoded in [[UTF8]]. Beware of some of Microsoft's "fake" Unicode implementation which is not compatible and may result in strange characters appearing in your quizzes.

Here is a 2-column GIFT format reference sheet I created for a training:
*[http://buypct.com/gift_reference.pdf GIFT Reference Sheet]

===Hints and Tips===

* Use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1. Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.) In case you want no visible message displayed then enter a non-breaking space as feedback, so you'll have to put a # after the answer which may be ~3 and '''write & n b s p ; after that.(without spaces between these characters)'''
* If you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (for example in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* There are Word macros available for easily creating GIFT files. See [http://www.soberit.hut.fi/sprg/resources/moodle/GiftConverter.html].
* Here's an Excel spreadsheet for generating multiple choice GIFT files [http://moodle.org/mod/forum/discuss.php?d=45245] and a newer version that supports other question formats (be sure to scroll down to the most recent version) [http://moodle.org/mod/forum/discuss.php?d=66660].
* Here's an Open Office template for generating GIFT files. [http://moodle.org/mod/forum/discuss.php?d=20705&parent=168385]

==See also==

*[[Export questions]]
*[[Import questions]]
*[[Aiken format]]
*[[Moodle XML format]]

[[Category:Questions]]

Moodle XML format

2008-03-27T09:21:02Z

Scotru: /* See also */

==A word about validity==

The XML parser assumes that the XML file is valid. If it is not you are very likely to get unexpected errors. If you are handcoding the XML file it is strongly recommended that you pass it through some sort of XML verifier before importing into Moodle. Note particularly that embedded HTML fragments should be within CDATA sections.

==Overall structure of XML file==

The file is enclosed by tags as follows.

<?xml version=1.0?>
<quiz>
.
.
.
</quiz>

Within the <quiz> tags are any number of <question> tags. One of these <question> tags can be a dummy question with a ''category'' type to specify a category for the import/export.

The file must be encoded in [[UTF8]]

Moodle XML import and export are balanced in functionality, so if you need to understand the format you can simply create some questions and export them to see what it looks like.

==Tags common to all question types==

A question is written as follows.

<question type="multichoice|truefalse|shortanswer|match|cloze|essay|numerical|description">
<questiontext format="html">
<text>What is the answer to this question?</text>
</questiontext>
.
.
.
</question>

"Format" selects the [[Formatting options]] for the question text. The options are '''moodle_auto_format''' (the default), '''html''', '''plain_text''' and '''markdown'''. The choice effects the way in which the text will be displayed.

Further tags, which usually include at least one <answer> tag, follow in the space marked with dots as child nodes to the <question> tag. The response-related tags are listed further down on this page. Various (optional?) tags are possible.

* penalty
* generalfeedback
* defaultgrade
* hidden

The <image> tag contains the url of any included image. Nested within the <image> tag may be an <image_base64> tag which contains the actual image data encoded in base64 [http://www.php.net/manual/en/function.base64-encode.php].

'''In the following question type examples the common parts of the question are not shown to improve clarity. It's a good idea to export some examples yourself to see a full example.'''

==Multiple choice==

MC questions have one <answer> tag for each choice. Each choice can carry feedback and score weighting (by using the fraction attribute). In addition, an MC question has the following tags:

* single ''(values: true/false)''
* shuffleanswers ''(values: 1/0)''
* correctfeedback
* partiallycorrectfeedback
* incorrectfeedback
* answernumbering (allowed values: 'abc', 'ABC' or '123')

The <single> tag is used to distinguish single response (radio button) and multiple response (checkbox) variants.

<question type="multichoice">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="0">
<text>A distractor</text>
<feedback><text>Ooops!</text></feedback>
</answer>
<answer fraction="0">
<text>Another distractor</text>
<feedback><text>Ooops!</text></feedback>
</answer>
<shuffleanswers>1</shuffleanswers>
<single>true</single>
<answernumbering>abc</answernumbering>

== True/false ==

Two answer tags are given, one which is true, and one which is false. The fraction attribute of the answer tag identifies which option is correct (100) and which is false (0). Feedback is supported. The following example shows the format when true is the correct answer and false is wrong.

<question type="truefalse">
<answer fraction="100">
<text>true</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction=0>
<text>false</text>
<feedback><text>Ooops!</text></feedback>
</answer>

== Short answer ==

The short answer question type supports alternative correct responses, each with its own weighting and feedback. The Moodle XML format uses one <answer> tag for each of the alternative correct answers.

The <usecase> tag toggles case-sensitivity with the values 1/0.

<question type="shortanswer">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>

<question type="shortanswer">
<answer fraction="100">
<text>The correct answer</text>
<feedback><text>Correct!</text></feedback>
</answer>
<answer fraction="100">
<text>An alternative answer</text>
<feedback><text>Correct!</text></feedback>
</answer>

== Numerical response ==

The following is a simplified version of the Moodle XML format for numerical responses.

<question type="numerical">
<answer fraction="100">
<text>23</text>
<feedback><text>Feedback</text></feedback>
</answer>

Moodle also supports a <tolerance> tag (how accurate must the number be?) and one or more <unit> tags. Unit tags have names and multipliers. E.g. if the main answer is in kilometres, an additional answer could be the equivalent in metres with a multiplier of 1000.

'''Note:''' prior to 1.7.2 the fraction was expressed as a value between 0 and 1 in a <fraction> element and the answer value was '''not''' enclosed in <text> tags. This format of the numerical question type is deprecated but will still be correctly imported if found (for now).

== Matching ==

Pair matching responses use the <shuffleanswers> tag to determine whether the order of the items should be randomized.
Each pair is contained inside a <subquestion> tag. The first item of each pair is contained with a <text> tag, while the second has an <answer> tag around it as well. Feedback and score weighting is not supported by Moodle for this response type.

<question type="match">
<subquestion>
<text>This is the 1st item in the 1st pair.</text>
<answer>
<text>This is the 2nd item in the 1st pair.</text>
</answer>
</subquestion>
<subquestion>
<text>This is the 1st item in the 2nd pair.</text>
<answer>
<text>This is the 2nd item in the 2nd pair.</text>
</answer>
</subquestion>
<shuffleanswers>true</shuffleanswers>

== Essay ==

An example of the essay type question...

<question type="essay">
<answer fraction="0">
<text></text>
</answer>
</question>

There isn't an answer and there isn't a grade in this case.

'''Note:''' prior to 1.7.2 the fraction was expressed as a value between 0 and 1 in a <fraction> element and the answer value was '''not''' enclosed in <text> tags. This format of the essay question type is deprecated but will still be correctly imported if found (for now).

== Other question types ==

=== Cloze ===

It is supported, and depends on a special format for the <questiontext> tag.

=== Description response type===

This response type has no further tags other than those contained in the question header (such as <questiontext>).

=== Random matching ===

Moodle has a question type which consists of taking short answer questions in the same quiz and displaying them as a pair matching exercise. However Moodle is neither able to export nor import this question type.

==Hints and Tips==
Here's a Word Template for generating Moodle XML [http://finemetronome.com/moodle/].

==See also==

*[[Export questions]]
*[[Import questions]]
*[[GIFT format]]
*[[Aiken format]]

[[Category:Questions]]

Moodle XML format

2008-03-27T09:20:34Z

Scotru: /* See also */

GIFT format

2008-03-27T09:19:22Z

Scotru: /* See also */

GIFT format

2008-03-27T09:15:50Z

Scotru: /* Hints and Tips */

GIFT format

2008-03-27T09:13:31Z

Scotru: /* Hints and Tips */

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions in a text editor in a simple format. For large numbers of questions, GIFT is likely to provide the quickest way of bulk loading your questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] 

At least one blank line must be left between each question.

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

The file '''must''' be correctly encoded in [[UTF8]]. Beware of some of Microsoft's "fake" Unicode implementation which is not compatible and may result in strange characters appearing in your quizzes.

Here is a 2-column GIFT format reference sheet I created for a training:
*[http://buypct.com/gift_reference.pdf GIFT Reference Sheet]

===Hints and Tips===

* Use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1. Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.) In case you want no visible message displayed then enter a non-breaking space as feedback, so you'll have to put a # after the answer which may be ~3 and '''write & n b s p ; after that.(without spaces between these characters)'''
* If you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (for example in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* There are Word macros available for easily creating GIFT files. See [http://www.soberit.hut.fi/sprg/resources/moodle/GiftConverter.html].
* Here's an Excel spreadsheet for generating multiple choice GIFT files [http://moodle.org/mod/forum/discuss.php?d=45245].
* Here's an Open Office template for generating GIFT files. [http://moodle.org/mod/forum/discuss.php?d=20705&parent=168385]

==See also==

*[[Export questions]]
[[Category:Questions]]

GIFT format

2008-03-27T09:11:01Z

Scotru: /* Hints and Tips */

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions in a text editor in a simple format. For large numbers of questions, GIFT is likely to provide the quickest way of bulk loading your questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] 

At least one blank line must be left between each question.

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

The file '''must''' be correctly encoded in [[UTF8]]. Beware of some of Microsoft's "fake" Unicode implementation which is not compatible and may result in strange characters appearing in your quizzes.

Here is a 2-column GIFT format reference sheet I created for a training:
*[http://buypct.com/gift_reference.pdf GIFT Reference Sheet]

===Hints and Tips===

* Use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1. Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.) In case you want no visible message displayed then enter a non-breaking space as feedback, so you'll have to put a # after the answer which may be ~3 and '''write & n b s p ; after that.(without spaces between these characters)'''
* If you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (for example in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* There are Word macros available for easily creating GIFT files. See [http://www.soberit.hut.fi/sprg/resources/moodle/GiftConverter.html].
* Here's an Excel spreadsheet for generating multiple choice GIFT files [http://moodle.org/mod/forum/discuss.php?d=45245].

==See also==

*[[Export questions]]
[[Category:Questions]]

GIFT format

2008-03-27T09:10:46Z

Scotru: /* Hints and Tips */

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions in a text editor in a simple format. For large numbers of questions, GIFT is likely to provide the quickest way of bulk loading your questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] 

At least one blank line must be left between each question.

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

The file '''must''' be correctly encoded in [[UTF8]]. Beware of some of Microsoft's "fake" Unicode implementation which is not compatible and may result in strange characters appearing in your quizzes.

Here is a 2-column GIFT format reference sheet I created for a training:
*[http://buypct.com/gift_reference.pdf GIFT Reference Sheet]

===Hints and Tips===

* Use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1. Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.) In case you want no visible message displayed then enter a non-breaking space as feedback, so you'll have to put a # after the answer which may be ~3 and '''write & n b s p ; after that.(without spaces between these characters)'''
* If you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (for example in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* There are Word macros available for easily creating GIFT files. See [http://www.soberit.hut.fi/sprg/resources/moodle/GiftConverter.html].
* Here's an Excel spreadsheet for generating multiple choice GIFT files
[http://moodle.org/mod/forum/discuss.php?d=45245].

==See also==

*[[Export questions]]
[[Category:Questions]]

WebCT format

2008-03-27T09:04:34Z

Scotru:

The WebCT import filter is in development and does not support all of the WebCT question types.

At the time of writing this, only Multiple Choice and Short answer questions are supported.

Here are some examples of these questions in a text file:

<pre>
# Start of question: Short Answer Question
:TYPE:S:
:TITLE:Short Answer Question
:QUESTION:H
What is the name of the WebCT Learning Hub?
 
:IMAGE:dotcomLogoc.gif
:ANSWERS:1
:CASE:0
:ANSWER1:WebCT.com:100:0:20:0
:FEEDBACK1:H
Be sure to visit the Learning Hub\: www.WebCT.com
:CAT:Default
# End of question: Short Answer Question

# Start of question: Multiple Choice Question
:TYPE:MC:1:0:C
:TITLE:Multiple Choice Question
:FEEDBACK
Darwin invented the theory of evolution and created Darwinism.
:QUESTION:H
Where is the Darwin Research Center?
:IMAGE:
:LAYOUT:vertical
:ANSWER1:0:H
Menlo Park, California
:REASON1:H
Sorry!
:ANSWER2:0:H
Vancouver, Canada
:REASON2:H
Sorry!
:ANSWER3:100:H
Galapagos Islands, Ecuador
:REASON3:H
Correct Answer!
:ANSWER4:0:H
London, England
:REASON4:H
Sorry!
:ANSWER5:0:H
Sidney, Australia
:REASON5:H
Sorry!
:CAT:Default
# End of question: Multiple Choice Question

</pre>

Import questions

2008-03-27T09:04:01Z

Scotru: /* Question formats */

{{Questions}}

Moodle provides a number of different formats to import questions into question banks. Some enable imports to be made from proprietary quiz software, others provide questions to be imported from human-readable text files and others provide Moodle specific formats to enable transfer of questions between quiz banks.

In the case of the text formats (in particular GIFT), once you get to know a format, it may be easier to simply type the questions into a text file than to use the web interface. You can just keep typing instead of waiting for new web pages to load for each question.

The available formats vary with the version of Moodle and if it is a quiz or lesson module.

== Question formats ==

*[[GIFT]] - Moodle 'proprietary' text format for import and export. Reasonably comprehensive.
*[[Moodle XML]] - Moodle 'proprietary' xml format for import and export. Very comprehensive.
*[[Aiken]] - This format is an easy way of writing multiple-choice questions for import.
*Missing Word -If you’re going to write a lot of missing word multiple choice questions, the missing word format is an easy way to create them.
*AON - This format is the same as the missing word format, except it creates matching questions from the multiple choice questions. Please note that from Moodle 1.8 it will no longer be part of the standard Moodle.
*Blackboard - From Moodle 1.7 onwards, if you're converting from Blackboard to Moodle, you can export your course and then import the question pools into Moodle using the Blackboard "POOL" type export format. It relies on XML functions being compiled into your PHP. Note that you must first unpack the exported zip file and provide Moodle with the appropriate .dat file. Note that this version does not work with Blackboard Version 6 and newer. (Use this format for ExamView 5 or 6)
*Blackboard V6+ - This module can import questions saved in Blackboard's export format. It provides limited support for Blackboard Version 6 and 7. It relies on XML functions being compiled into your PHP. You must upload the zip file exported from Blackboard.
*[[WebCT format]] - This format supports importing multiple choice and short answers questions from WebCT's text format.
*Course Test Manager - This format enables you to import questions from the Course Test Manager from Course Technology.
*Embedded Answers (Cloze) - This format is a multiple question, multiple answer question with embedded answers. They can be a bit tricky to develop, but they are a unique way of asking questions.
* Importing from Examview - ExamView 4 supported an XML export format that Moodle can import. If you are using a newer version of ExamView, you should export using Blackboard, extract the zip archive ExamView creates, then import in Moodle using Blackboard format (do not use 6+ format for moodle import, even though exam view calls this a Blackboard6+ file--it isn't). You can choose one of the ".dat" files from the ExamView archive to import. Note that images are not currently imported. See http://www.rose-prism.org/moodle/mod/resource/view.php?id=6788 and http://www.rose-prism.org/moodle/mod/forum/discuss.php?d=1451

== Character encoding ==

Prior to Moodle 1.6 the question file was assumed to be encoded in the same way as the language being used within the Moodle site. With Moodle 1.6 and onwards it is assumed that the imported file is encoded in UTF8. If it is not an external tool must be used to change the encoding. Note that if only basic 'latin' characters are used, then the coding issue can generally be ignored. Be particularly careful when creating questions using Microsoft Word. For reasons best known to themselves, Microsoft used their own encoding for some characters and this is likely to break the import.

==See also==

*The help file available from the help button next to the import file button gives a lot of detail about each format.
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=51316 escaping problem in gift import?] forum discussion
*[[Converting files to UTF-8]]

[[fr:Importer des questions]]

Import questions

2008-03-27T09:01:51Z

Scotru: /* Question formats */

{{Questions}}

Moodle provides a number of different formats to import questions into question banks. Some enable imports to be made from proprietary quiz software, others provide questions to be imported from human-readable text files and others provide Moodle specific formats to enable transfer of questions between quiz banks.

In the case of the text formats (in particular GIFT), once you get to know a format, it may be easier to simply type the questions into a text file than to use the web interface. You can just keep typing instead of waiting for new web pages to load for each question.

The available formats vary with the version of Moodle and if it is a quiz or lesson module.

== Question formats ==

*[[GIFT]] - Moodle 'proprietary' text format for import and export. Reasonably comprehensive.
*[[Moodle XML]] - Moodle 'proprietary' xml format for import and export. Very comprehensive.
*[[Aiken]] - This format is an easy way of writing multiple-choice questions for import.
*Missing Word -If you’re going to write a lot of missing word multiple choice questions, the missing word format is an easy way to create them.
*AON - This format is the same as the missing word format, except it creates matching questions from the multiple choice questions. Please note that from Moodle 1.8 it will no longer be part of the standard Moodle.
*Blackboard - From Moodle 1.7 onwards, if you're converting from Blackboard to Moodle, you can export your course and then import the question pools into Moodle using the Blackboard "POOL" type export format. It relies on XML functions being compiled into your PHP. Note that you must first unpack the exported zip file and provide Moodle with the appropriate .dat file. Note that this version does not work with Blackboard Version 6 and newer. (Use this format for ExamView 5 or 6)
*Blackboard V6+ - This module can import questions saved in Blackboard's export format. It provides limited support for Blackboard Version 6 and 7. It relies on XML functions being compiled into your PHP. You must upload the zip file exported from Blackboard.
*WebCT - This format supports importing multiple choice and short answers questions from WebCT's text format.
*Course Test Manager - This format enables you to import questions from the Course Test Manager from Course Technology.
*Embedded Answers (Cloze) - This format is a multiple question, multiple answer question with embedded answers. They can be a bit tricky to develop, but they are a unique way of asking questions.
* Importing from Examview - ExamView 4 supported an XML export format that Moodle can import. If you are using a newer version of ExamView, you should export using Blackboard, extract the zip archive ExamView creates, then import in Moodle using Blackboard format (do not use 6+ format for moodle import, even though exam view calls this a Blackboard6+ file--it isn't). You can choose one of the ".dat" files from the ExamView archive to import. Note that images are not currently imported. See http://www.rose-prism.org/moodle/mod/resource/view.php?id=6788 and http://www.rose-prism.org/moodle/mod/forum/discuss.php?d=1451

== Character encoding ==

Prior to Moodle 1.6 the question file was assumed to be encoded in the same way as the language being used within the Moodle site. With Moodle 1.6 and onwards it is assumed that the imported file is encoded in UTF8. If it is not an external tool must be used to change the encoding. Note that if only basic 'latin' characters are used, then the coding issue can generally be ignored. Be particularly careful when creating questions using Microsoft Word. For reasons best known to themselves, Microsoft used their own encoding for some characters and this is likely to break the import.

==See also==

*The help file available from the help button next to the import file button gives a lot of detail about each format.
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=51316 escaping problem in gift import?] forum discussion
*[[Converting files to UTF-8]]

[[fr:Importer des questions]]

Aiken format

2008-03-27T08:57:45Z

Scotru:

The Aiken format is a very simple way of creating multiple choice questions using a clear human-readable format. The question must be all on one line. Each answer must start with a single-letter character, followed by a period '.' or a bracket ')', then a space. The answer line must immediately follow, starting with "ANSWER:" and then giving the appropriate letter. Here is an example of the format:

<pre>What is the correct answer to this question?
A. Is it this one?
B. Maybe this answer?
C. Possibly this one?
D. Must be this one!
ANSWER: D

Which LMS has the most quiz import formats?
A) Moodle
B) ATutor
C) Claroline
D) Blackboard
E) WebCT
F) Ilias
ANSWER: A</pre>

===Hints and Tips===

* Add your hints and tips here

==See also==

*[[Import questions]]
*[[GIFT]]

[[Category:Questions]]

Aiken

2008-03-27T08:57:27Z

Scotru:

#Redirect [[Aiken Format]]

Aiken

2008-03-27T08:56:57Z

Scotru:

[[#Redirect:Aiken Format]]

Aiken

2008-03-27T08:55:50Z

Scotru: /* See also */

Aiken

2008-03-27T08:54:48Z

Scotru:

The Aiken format is a very simple way of creating multiple choice questions using a clear human-readable format. The question must be all on one line. Each answer must start with a single-letter character, followed by a period '.' or a bracket ')', then a space. The answer line must immediately follow, starting with "ANSWER:" and then giving the appropriate letter. Here is an example of the format:

<pre>What is the correct answer to this question?
A. Is it this one?
B. Maybe this answer?
C. Possibly this one?
D. Must be this one!
ANSWER: D

Which LMS has the most quiz import formats?
A) Moodle
B) ATutor
C) Claroline
D) Blackboard
E) WebCT
F) Ilias
ANSWER: A</pre>

===Hints and Tips===

* Add your hints and tips here

==See also==

*[[Export questions]]
[[Category:Questions]]
*[[GIFT]]

Aiken

2008-03-27T08:53:00Z

Scotru: /* "Aiken" format */

Aiken

2008-03-27T08:51:11Z

Scotru:

== "Aiken" format ==

The Aiken format is a very simple way of creating multiple choice questions using a clear human-readable format. Here is an example of the format:

<nowiki>What is the correct answer to this question?
A. Is it this one?
B. Maybe this answer?
C. Possibly this one?
D. Must be this one!
ANSWER: D</nowiki>

<nowiki>Which LMS has the most quiz import formats?
A) Moodle
B) ATutor
C) Claroline
D) Blackboard
E) WebCT
F) Ilias
ANSWER: A</nowiki>

The question must be all on one line.

Each answer must start with a single-letter character, followed by a period '.' or a bracket ')', then a space.

The answer line must immediately follow, starting with "ANSWER:" and then giving the appropriate letter.

Aiken

2008-03-27T08:50:13Z

Scotru:

"Aiken" format
===================
The Aiken format is a very simple way of creating multiple choice questions using a clear human-readable format. Here is an example of the format:

What is the correct answer to this question?
A. Is it this one?
B. Maybe this answer?
C. Possibly this one?
D. Must be this one!
ANSWER: D

Which LMS has the most quiz import formats?
A) Moodle
B) ATutor
C) Claroline
D) Blackboard
E) WebCT
F) Ilias
ANSWER: A

The question must be all on one line.

Each answer must start with a single-letter character, followed by a period '.' or a bracket ')', then a space.

The answer line must immediately follow, starting with "ANSWER:" and then giving the appropriate letter.

Import questions

2008-03-27T08:48:40Z

Scotru: /* Question formats */

{{Questions}}

Moodle provides a number of different formats to import questions into question banks. Some enable imports to be made from proprietary quiz software, others provide questions to be imported from human-readable text files and others provide Moodle specific formats to enable transfer of questions between quiz banks.

In the case of the text formats (in particular GIFT), once you get to know a format, it may be easier to simply type the questions into a text file than to use the web interface. You can just keep typing instead of waiting for new web pages to load for each question.

The available formats vary with the version of Moodle and if it is a quiz or lesson module.

== Question formats ==

*[[GIFT]] - Moodle 'proprietary' text format for import and export. Reasonably comprehensive.
*[[Moodle XML]] - Moodle 'proprietary' xml format for import and export. Very comprehensive.
*[[Aiken]] - This format is an easy way of writing multiple-choice questions for import.
*Missing Word -If you’re going to write a lot of missing word multiple choice questions, the missing word format is an easy way to create them.
*AON - This format is the same as the missing word format, except it creates matching questions from the multiple choice questions. Please note that from Moodle 1.8 it will no longer be part of the standard Moodle.
*Blackboard - From Moodle 1.7 onwards, if you're converting from Blackboard to Moodle, you can export your course and then import the question pools into Moodle using the Blackboard format.
*WebCT - In Moodle 1.7 this format supports importing multiple choice and short answers questions from WebCT.
*Course Test Manager - This format enables you to import questions from the Course Test Manager from Course Technology.
*Embedded Answers (Cloze) - This format is a multiple question, multiple answer question with embedded answers. They can be a bit tricky to develop, but they are a unique way of asking questions.
* Importing from Examview - ExamView 4 supported an XML export format that Moodle can import. If you are using a newer version of ExamView, you should export using Blackboard, extract the zip archive ExamView creates, then import in Moodle using Blackboard format (do not use 6+ format for moodle import, even though exam view calls this a Blackboard6+ file--it isn't). You can choose one of the ".dat" files from the ExamView archive to import. Note that images are not currently imported. See http://www.rose-prism.org/moodle/mod/resource/view.php?id=6788 and http://www.rose-prism.org/moodle/mod/forum/discuss.php?d=1451

== Character encoding ==

Prior to Moodle 1.6 the question file was assumed to be encoded in the same way as the language being used within the Moodle site. With Moodle 1.6 and onwards it is assumed that the imported file is encoded in UTF8. If it is not an external tool must be used to change the encoding. Note that if only basic 'latin' characters are used, then the coding issue can generally be ignored. Be particularly careful when creating questions using Microsoft Word. For reasons best known to themselves, Microsoft used their own encoding for some characters and this is likely to break the import.

==See also==

*The help file available from the help button next to the import file button gives a lot of detail about each format.
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=51316 escaping problem in gift import?] forum discussion
*[[Converting files to UTF-8]]

[[fr:Importer des questions]]

GIFT format

2008-03-27T08:35:55Z

Scotru:

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions in a text editor in a simple format. For large numbers of questions, GIFT is likely to provide the quickest way of bulk loading your questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] 

At least one blank line must be left between each question.

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

The file '''must''' be correctly encoded in [[UTF8]]. Beware of some of Microsoft's "fake" Unicode implementation which is not compatible and may result in strange characters appearing in your quizzes.

Here is a 2-column GIFT format reference sheet I created for a training:
*[http://buypct.com/gift_reference.pdf GIFT Reference Sheet]

===Hints and Tips===

* Use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1. Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.) In case you want no visible message displayed then enter a non-breaking space as feedback, so you'll have to put a # after the answer which may be ~3 and '''write & n b s p ; after that.(without spaces between these characters)'''
* If you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (for example in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* There are Word macros available for easily creating GIFT files. See [http://www.soberit.hut.fi/sprg/resources/moodle/GiftConverter.html].

==See also==

*[[Export questions]]
[[Category:Questions]]

GIFT format

2008-03-27T08:35:19Z

Scotru:

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions in a text editor in a simple format. For large numbers of questions, GIFT is likely to provide the quickest way of bulk loading your questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] 

At least one blank line must be left between each question.

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

The file '''must''' be correctly encoded in [[UTF8]]. Beware of some of Microsoft's "fake" Unicode implementation which is not compatible and may result in strange characters appearing in your quizzes.

Here is a 2-column GIFT format reference sheet I created for a training: --[[User:Rudy Scott|Rudy Scott]] 03:35, 27 March 2008 (CDT)
*[http://buypct.com/gift_reference.pdf GIFT Reference Sheet]

===Hints and Tips===

* Use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1. Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.) In case you want no visible message displayed then enter a non-breaking space as feedback, so you'll have to put a # after the answer which may be ~3 and '''write & n b s p ; after that.(without spaces between these characters)'''
* If you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (for example in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* There are Word macros available for easily creating GIFT files. See [http://www.soberit.hut.fi/sprg/resources/moodle/GiftConverter.html].

==See also==

*[[Export questions]]
[[Category:Questions]]

GIFT format

2008-03-27T08:28:55Z

Scotru:

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions in a text editor in a simple format. For large numbers of questions, GIFT is likely to provide the quickest way of bulk loading your questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] 

At least one blank line must be left between each question.

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

The file '''must''' be correctly encoded in [[UTF8]]. Beware of some of Microsoft's "fake" Unicode implementation which is not compatible and may result in strange characters appearing in your quizzes.

===Hints and Tips===

* Use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1. Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.) In case you want no visible message displayed then enter a non-breaking space as feedback, so you'll have to put a # after the answer which may be ~3 and '''write & n b s p ; after that.(without spaces between these characters)'''
* If you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (for example in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* There are Word macros available for easily creating GIFT files. See [http://www.soberit.hut.fi/sprg/resources/moodle/GiftConverter.html].

==See also==

*[[Export questions]]
*[[GIFT Reference]]
[[Category:Questions]]

GIFT format

2008-03-27T08:28:40Z

Scotru:

With GIFT format you can write multiple-choice, true-false, short answer, matching and numerical questions in a text editor in a simple format. For large numbers of questions, GIFT is likely to provide the quickest way of bulk loading your questions.
[[Image:Gift.jpg|frame|left|screen shot from quiz help file documentation]] 

At least one blank line must be left between each question.

Here is an [http://moodle.org/file.php/5/moddata/forum/121/236161/GIFT-examples.zip GIFT example] for quiz-import, easy to copy and change ...

The file '''must''' be correctly encoded in [[UTF8]]. Beware of some of Microsoft's "fake" Unicode implementation which is not compatible and may result in strange characters appearing in your quizzes.

===Hints and Tips===

* Use the ::title:: at the beginning of every question to organize this for you (01 - testquestion), otherwise it would be difficult to find the right question for changes, moodle will take the beginning of every question as internal title.
* In the Lesson module, in a question page, correct answers jump by default to Next page and incorrect answers jump to This page (i.e. student has to "try again"). When importing from a GIFT format file, this is exactly the mechanism which is used.
* If you want a student to be taken directly from one question to the next irrespective of their answer being correct or incorrect: in the Lesson Settings, set Maximum number of attempts: to 1. Please note, however, that a message "correct / incorrect" will still be displayed to the student upon answering each question. If you do not want this (default) feedback message to be displayed then enter your own feedback message (i.e. "continue", "---", etc.) In case you want no visible message displayed then enter a non-breaking space as feedback, so you'll have to put a # after the answer which may be ~3 and '''write & n b s p ; after that.(without spaces between these characters)'''
* If you want to use curly braces, { or }, or equal sign, =, or # or ~ in a GIFT file (for example in a math question including TeX expressions) you must "escape" them by preceding them with a \ directly in front of each { or } or =. It is possible to use a replace program/macro/editor filter to do this conversion before importing to Moodle.
* There are Word macros available for easily creating GIFT files. See [http://www.soberit.hut.fi/sprg/resources/moodle/GiftConverter.html].

==See also==

*[[Export questions]]
[[GIFT Reference]]
[[Category:Questions]]

Import questions

2008-03-27T06:05:06Z

Scotru: /* Question formats */

{{Questions}}

Moodle provides a number of different formats to import questions into question banks. Some enable imports to be made from proprietary quiz software, others provide questions to be imported from human-readable text files and others provide Moodle specific formats to enable transfer of questions between quiz banks.

In the case of the text formats (in particular GIFT), once you get to know a format, it may be easier to simply type the questions into a text file than to use the web interface. You can just keep typing instead of waiting for new web pages to load for each question.

The available formats vary with the version of Moodle and if it is a quiz or lesson module.

== Question formats ==

*[[GIFT]] - Moodle 'proprietary' text format for import and export. Reasonably comprehensive.
*[[Moodle XML]] - Moodle 'proprietary' xml format for import and export. Very comprehensive.
*Aiken - This format is an easy way of writing multiple-choice questions for import.
*Missing Word -If you’re going to write a lot of missing word multiple choice questions, the missing word format is an easy way to create them.
*AON - This format is the same as the missing word format, except it creates matching questions from the multiple choice questions. Please note that from Moodle 1.8 it will no longer be part of the standard Moodle.
*Blackboard - From Moodle 1.7 onwards, if you're converting from Blackboard to Moodle, you can export your course and then import the question pools into Moodle using the Blackboard format.
*WebCT - In Moodle 1.7 this format supports importing multiple choice and short answers questions from WebCT.
*Course Test Manager - This format enables you to import questions from the Course Test Manager from Course Technology.
*Embedded Answers (Cloze) - This format is a multiple question, multiple answer question with embedded answers. They can be a bit tricky to develop, but they are a unique way of asking questions.
* Importing from Examview - ExamView 4 supported an XML export format that Moodle can import. If you are using a newer version of ExamView, you should export using Blackboard, extract the zip archive ExamView creates, then import in Moodle using Blackboard format (do not use 6+ format for moodle import, even though exam view calls this a Blackboard6+ file--it isn't). You can choose one of the ".dat" files from the ExamView archive to import. Note that images are not currently imported. See http://www.rose-prism.org/moodle/mod/resource/view.php?id=6788 and http://www.rose-prism.org/moodle/mod/forum/discuss.php?d=1451

== Character encoding ==

Prior to Moodle 1.6 the question file was assumed to be encoded in the same way as the language being used within the Moodle site. With Moodle 1.6 and onwards it is assumed that the imported file is encoded in UTF8. If it is not an external tool must be used to change the encoding. Note that if only basic 'latin' characters are used, then the coding issue can generally be ignored. Be particularly careful when creating questions using Microsoft Word. For reasons best known to themselves, Microsoft used their own encoding for some characters and this is likely to break the import.

==See also==

*The help file available from the help button next to the import file button gives a lot of detail about each format.
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=51316 escaping problem in gift import?] forum discussion
*[[Converting files to UTF-8]]

[[fr:Importer des questions]]

Import questions

2008-03-27T06:03:29Z

Scotru:

{{Questions}}

Moodle provides a number of different formats to import questions into question banks. Some enable imports to be made from proprietary quiz software, others provide questions to be imported from human-readable text files and others provide Moodle specific formats to enable transfer of questions between quiz banks.

In the case of the text formats (in particular GIFT), once you get to know a format, it may be easier to simply type the questions into a text file than to use the web interface. You can just keep typing instead of waiting for new web pages to load for each question.

The available formats vary with the version of Moodle and if it is a quiz or lesson module.

== Question formats ==

*[[GIFT]] - Moodle 'proprietary' text format for import and export. Reasonably comprehensive.
*[[Moodle XML]] - Moodle 'proprietary' xml format for import and export. Very comprehensive.
*Aiken - This format is an easy way of writing multiple-choice questions for import.
*Missing Word -If you’re going to write a lot of missing word multiple choice questions, the missing word format is an easy way to create them.
*AON - This format is the same as the missing word format, except it creates matching questions from the multiple choice questions. Please note that from Moodle 1.8 it will no longer be part of the standard Moodle.
*Blackboard - From Moodle 1.7 onwards, if you're converting from Blackboard to Moodle, you can export your course and then import the question pools into Moodle using the Blackboard format.
*WebCT - In Moodle 1.7 this format supports importing multiple choice and short answers questions from WebCT.
*Course Test Manager - This format enables you to import questions from the Course Test Manager from Course Technology.
*Embedded Answers (Cloze) - This format is a multiple question, multiple answer question with embedded answers. They can be a bit tricky to develop, but they are a unique way of asking questions.
* Importing from Examview - ExamView 4.1 supported an XML export format that Moodle can import. If you are using a newer version of ExamView, you should export using Blackboard, extract the zip archive, then import a .dat file using Blackboard format (do not use 6+ format for moodle import, even though exam view calls this a Blackboard6+ file--it isn't. Note that images are not currently imported.

See http://www.rose-prism.org/moodle/mod/resource/view.php?id=6788 and http://www.rose-prism.org/moodle/mod/forum/discuss.php?d=1451

== Character encoding ==

Prior to Moodle 1.6 the question file was assumed to be encoded in the same way as the language being used within the Moodle site. With Moodle 1.6 and onwards it is assumed that the imported file is encoded in UTF8. If it is not an external tool must be used to change the encoding. Note that if only basic 'latin' characters are used, then the coding issue can generally be ignored. Be particularly careful when creating questions using Microsoft Word. For reasons best known to themselves, Microsoft used their own encoding for some characters and this is likely to break the import.

==See also==

*The help file available from the help button next to the import file button gives a lot of detail about each format.
*Using Moodle [http://moodle.org/mod/forum/discuss.php?d=51316 escaping problem in gift import?] forum discussion
*[[Converting files to UTF-8]]

[[fr:Importer des questions]]