From: thepurpleblob Date: Wed, 9 Jul 2008 12:56:54 +0000 (+0000) Subject: MDL-14431 X-Git-Url: http://git.mjollnir.org/gw?a=commitdiff_plain;h=08b82a53f3ee261b4cbc9c0b9650a82fc48e77e7;p=moodle.git MDL-14431 Changing import/export help to be properly pluggable. --- diff --git a/lang/en_utf8/help/quiz/formataiken.html b/lang/en_utf8/help/quiz/formataiken.html index bb30fcc8ce..15110dfa4c 100644 --- a/lang/en_utf8/help/quiz/formataiken.html +++ b/lang/en_utf8/help/quiz/formataiken.html @@ -1,6 +1,7 @@ -

Importing "Aiken" format files

+

"Aiken" format files

-

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:

+

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?
diff --git a/lang/en_utf8/help/quiz/formatblackboard.html b/lang/en_utf8/help/quiz/formatblackboard.html
new file mode 100644
index 0000000000..6e94c4f1e7
--- /dev/null
+++ b/lang/en_utf8/help/quiz/formatblackboard.html
@@ -0,0 +1,12 @@
+

Blackboard (POOL) Files

+ +

This module can import questions saved in Blackboard's "POOL" type export +format. This is generally for Blackboard versions 5 and earlier although +many other quiz packages use this as their "Blackboard" export format.

+ +

+To use this first unpack the exported zip file and provide Moodle +with the appropriate .dat file. Do not try to import the zip file directly

+ +

Note that this version does not work with Blackboard +Version 6 and newer.

diff --git a/lang/en_utf8/help/quiz/formatblackboard_6.html b/lang/en_utf8/help/quiz/formatblackboard_6.html new file mode 100644 index 0000000000..0d2bdd74bf --- /dev/null +++ b/lang/en_utf8/help/quiz/formatblackboard_6.html @@ -0,0 +1,9 @@ +

Blackboard V6+ files

+ +

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.

+ +

Note that this format only imports the main data file from +the zip. Any other data (e.g. images) is ignored.

\ No newline at end of file diff --git a/lang/en_utf8/help/quiz/formatexamview.html b/lang/en_utf8/help/quiz/formatexamview.html new file mode 100644 index 0000000000..17d9cba7d5 --- /dev/null +++ b/lang/en_utf8/help/quiz/formatexamview.html @@ -0,0 +1,5 @@ +

Examview format

+ +

This format can import from Examview 4 XML files. Note that the older +versions of Examview are not supported. Examview no longer supports this +export format. You are advised the use BlackBoard format instead.

diff --git a/lang/en_utf8/help/quiz/formatgift.html b/lang/en_utf8/help/quiz/formatgift.html index 75ad58a018..427066ed25 100644 --- a/lang/en_utf8/help/quiz/formatgift.html +++ b/lang/en_utf8/help/quiz/formatgift.html @@ -1,10 +1,13 @@ -

Importing "GIFT" format files

-

GIFT is the most comprehensive import format available for importing - Moodle quiz questions from a text file. It supports Multiple-Choice, +

"GIFT" format files

+ +

GIFT is the most comprehensive import format available for importing and exporting + Moodle quiz questions from/to a text file. It supports Multiple-Choice, True-False, Short Answer, Matching and Numerical questions, as well as insertion of a _____ for the Missing Word format. Various question-types can be mixed in a single text file, and the format also supports line comments, question names, feedback and percentage-weight grades.

+ +

Optional questiontype plugins can extend this format

The text encoding of your text file must be utf-8 (unless you only use ascii characters). An example questions text file can be found here: gift/examples.txt.

diff --git a/lang/en_utf8/help/quiz/formathotpot.html b/lang/en_utf8/help/quiz/formathotpot.html new file mode 100644 index 0000000000..6ec99c3f38 --- /dev/null +++ b/lang/en_utf8/help/quiz/formathotpot.html @@ -0,0 +1,3 @@ +

Hot Potatoes Files

+ +

This format will import files created in Hot Potatoes.

\ No newline at end of file diff --git a/lang/en_utf8/help/quiz/formatlearnwise.html b/lang/en_utf8/help/quiz/formatlearnwise.html new file mode 100644 index 0000000000..aaf8978f9d --- /dev/null +++ b/lang/en_utf8/help/quiz/formatlearnwise.html @@ -0,0 +1,5 @@ +

Learnwise format

+ +

This format can import multiple choice questions saved in Learnwise's XML +format.

+ diff --git a/lang/en_utf8/help/quiz/formatmissingword.html b/lang/en_utf8/help/quiz/formatmissingword.html new file mode 100644 index 0000000000..6830d4d2ef --- /dev/null +++ b/lang/en_utf8/help/quiz/formatmissingword.html @@ -0,0 +1,21 @@ +

Missing Word Format

+ +

This format only supports multiple choice questions and +short answer question, depending on the number of answers. One +answer generates a short answer question, two or more answers +generate a multiple choice question. +Each answer is separated with a tilde (~), and the correct answer is +prefixed with an equals sign (=). Here is an example of a multiple +choice question:

+ +

As soon as we begin to explore our body parts as infants +we become students of {=anatomy and physiology ~reflexology +~science ~experiment}, and in a sense we remain students for life. +

+ +

Here is an example of a short answer question:

+ +

As soon as we begin to explore our body parts as infants + we become students of {=anatomy and physiology}, + and in a sense we remain students for life. +

\ No newline at end of file diff --git a/lang/en_utf8/help/quiz/formatmultianswer.html b/lang/en_utf8/help/quiz/formatmultianswer.html new file mode 100644 index 0000000000..f720b3c74e --- /dev/null +++ b/lang/en_utf8/help/quiz/formatmultianswer.html @@ -0,0 +1,7 @@ +

Embedded answers (Cloze)

+ +

This special purpose format imports just one type of question, the +Embedded Answers (also known as Cloze) format. +

+ +

More info about the "Cloze" format

\ No newline at end of file diff --git a/lang/en_utf8/help/quiz/formatxml.html b/lang/en_utf8/help/quiz/formatxml.html index f72619de49..6efac8a226 100644 --- a/lang/en_utf8/help/quiz/formatxml.html +++ b/lang/en_utf8/help/quiz/formatxml.html @@ -1,4 +1,12 @@ -

Importing "Moodle XML" format files

+

"Moodle XML" format

+ +

This Moodle specific format imports quiz questions that have previously been +exported in the same format. The format is straightforward and is best demonstrated +by exporting a category in the Moodle XML format. The XML format is capabable of +importing image files. +

+ +

Optional questiontype plugins can extend this format.

Category Switching

diff --git a/lang/en_utf8/help/quiz/import.html b/lang/en_utf8/help/quiz/import.html index 676b53a931..5b5387cf79 100644 --- a/lang/en_utf8/help/quiz/import.html +++ b/lang/en_utf8/help/quiz/import.html @@ -15,116 +15,9 @@ XML based import formats will be handled automatically provided your Moodle server is running PHP 5.

-

A number of file formats are supported:

- - -

GIFT format

- -

GIFT is the most comprehensive import format available for importing - Moodle quiz questions from a text file. It was designed to be an easy - method for teachers writing questions as a text file. It supports Multiple-Choice, - True-False, Short Answer, Matching and Numerical questions, as well as insertion - of a _____ for the "missing word" format. Various question-types can be - mixed in a single text file, and the format also supports line comments, question names, - feedback and percentage-weight grades. Below are some examples:

-
-Who's buried in Grant's tomb?{~Grant ~Jefferson =no one}
-
-Grant is {~buried =entombed ~living} in Grant's tomb.
-
-Grant is buried in Grant's tomb.{FALSE}
-
-Who's buried in Grant's tomb?{=no one =nobody}
-
-When was Ulysses S. Grant born?{#1822}
-
- -

More info about the "GIFT" format

- - -

Aiken Format

- -

This is a simple format for importing multiple choice questions from a text file.

-

More info about the "Aiken" format

- - -

Moodle XML format

- -

This Moodle specific format imports quiz questions that have previously been -exported in the same format. The format is straightforward and is best demonstrated -by exporting a category in the Moodle XML format. The XML format is capabable of -importing image files. -

-

More info about the "Moodle XML" format

- - -

Missing Word

- -

This format only supports multiple choice questions and -short answer question, depending on the number of answers. One -answer generates a short answer question, two or more answers -generate a multiple choice question. -Each answer is separated with a tilde (~), and the correct answer is -prefixed with an equals sign (=). Here is an example of a multiple -choice question:

- -

As soon as we begin to explore our body parts as infants -we become students of {=anatomy and physiology ~reflexology -~science ~experiment}, and in a sense we remain students for life. -

- -

Here is an example of a short answer question:

- -

As soon as we begin to explore our body parts as infants - we become students of {=anatomy and physiology}, - and in a sense we remain students for life. -

- - -

Blackboard

- -

This module can import questions saved in Blackboard's "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.

- - -

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 module can import questions saved in WebCT's text-based format.

- -

More info about the "WebCT" format

- - -

Embedded answers (Cloze)

- -

This special purpose format imports just one type of question, the -Embedded Answers (also known as Cloze) format. -

- -

More info about the "Cloze" format

- - -

Learnwise format

- -

This format can import multiple choice questions saved in Learnwise's XML -format.

- - -

Examview format

- -

This format can import from Examview 4 XML files. Note that the older -versions of Examview are not supported.

+

A number of file formats are supported. See in the individual help files +and the Moodle Docs +for details.

Import and Export formats are a pluggable resource. Other optional formats may be available in the