Difference between revisions of "Word table format"

Jump to: navigation, search
(changes from 3.6 to 3.7)
 
(17 intermediate revisions by 3 users not shown)
Line 3: Line 3:
 
|entry = https://moodle.org/plugins/view.php?plugin=qformat_wordtable
 
|entry = https://moodle.org/plugins/view.php?plugin=qformat_wordtable
 
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10690
 
|tracker = http://tracker.moodle.org/browse/CONTRIB/component/10690
|discussion = https://moodle.org/mod/forum/discuss.php?d=146284
+
|discussion = https://moodle.org/mod/forum/discuss.php?d=121707
 
|maintainer = [[User:Eoin Campbell|Eoin Campbell]]
 
|maintainer = [[User:Eoin Campbell|Eoin Campbell]]
 
|float = right
 
|float = right
 
}}
 
}}
Moodle2Word is a Moodle 1.9 and 2.x add-on that allows question banks to be exported from Moodle into a Word file. The Word file can then be used to quickly review large numbers of questions (either online or in print), or to prepare paper tests (where the answers and feedback is hidden). Questions in the Word table format can also be imported into Moodle.
+
Moodle2Word is a Moodle plugin that allows question banks to be exported from Moodle into a Word file. The Word file can then be used to quickly review large numbers of questions (either online or in print), or to prepare paper tests (where the answers and feedback is hidden). Questions in the Word table format can also be imported back into Moodle.
  
 
==Features==
 
==Features==
  
* The tables contain all components of a question, including the stem, answer options, option-specific and general feedback, and weights.
+
* The tables contain all components of a question, including the stem, answer options, option-specific and general feedback, hints, tags, and any images.
* All the main question types except Calculated questions are supported.
+
* All the main question types except Numerical and Calculated questions are supported.
 +
 
 
* With the aid of commands in an external Word template, questions can be re-formatted to hide the answers etc, allowing the questions to be printed as a paper quiz.
 
* With the aid of commands in an external Word template, questions can be re-formatted to hide the answers etc, allowing the questions to be printed as a paper quiz.
* Questions can be edited in Word, and then imported back into Moodle.
+
* Questions can be edited in Word, and then imported back into Moodle. That means you can import the following:
* The Cloze question syntax is very simple, as it does not require any knowledge of the arcane Moodle syntax; instead, use bold for drop-down menu items, and italic for fill-in text fields.
+
** '''Matching''': Match 4 or more words or phrases.
 +
** '''Multiple-Choice''': Choose the 1 correct answer from 4 or more possible answers
 +
** '''Multiple-Answer''': Choose 1 or more correct answers from 4 or more possible answers.
 +
** '''Short Answer''': Free text answer.
 +
** '''Description''': Not a question, just a facility to add some text, usually instructions for a set of following questions.
 +
** '''Essay''': An essay question allows the entry of free text, which is not graded.
 +
** '''True/False''': Choose whether a statement is true or false.
 +
** '''Cloze''': Fill-in-the-blanks or Embedded answers question. Use bold to enter Multichoice items, italic to enter Short Answer items, and underline to enter Numerical items.
 +
* The Cloze question syntax for importing questions is very simple, as it does not require any knowledge of the arcane Moodle syntax; instead, use bold for drop-down menu items, and italic for fill-in text fields.
 +
* The plug-in supports import from and export to all languages, not just English.
 +
* Questions can be quickly previewed in Moodle, as you are creating them in Word.
 +
* Equations edited in Microsoft Equation Editor in Word are converted into [[ASCIIMathML|MathML]] in Moodle, and can be displayed using [[MathJax filter|MathJax]].
  
==Installation==
+
==Troubleshooting==
===Pre-requisites===
+
The question import facility requires the Microsoft Word file to specify what language the 'labels' used in question tables are in, for example, "Default mark", "General feedback", etc. This is specified in a custom document property called '''moodleLanguage''' in the Word file. If you export questions from Moodle into Word, or if you create questions using the Word templates ''moodleQuestion.dotx'' and ''moodleQuestionStartup.dotm'' available from [http://www.Moodle2Word.net/ www.Moodle2Word.net], then this property is automatically set in the file. If you don't, then the following message  is displayed when you try to import a Word file.
 +
<code>
 +
No questions imported because the language of the labels in the Word file does not match your current Moodle interface language. "en_us" != "en" </code>
 +
To resolve this issue, add the property manually as follows. In Word, use the File > Info > Properties > Advanced properties command (see screenshot below) to add the property manually.
  
* You will need Moodle Administrator rights to fully install the plug-in.  
+
<gallery>WordFileProperties.png|File > Info > Properties > Advanced properties</gallery>
* You also need write access to the /question/format folder in your Moodle installation.
 
* Check that your Moodle installation supports XSLT (for exporting) and CURL (for importing). Log in as Administrator, go to Site Administration -> Server -> PHP info, and view the PHP configuration. Look for the package details for 'curl' and for 'xsl'. If they are not present, then you will need to re-configure PHP and re-start the server.
 
* To enable XSLT and/or CURL on your server, open your PHP configuration file (e.g. d:\winmoodle2\server\php\php.ini) and uncomment the lines containing "extension=php_xsl.dll" and "extension=php_curl.dll" by removing the semi-colon before them, if present.
 
  
===Instructions===
+
In the Properties dialog box, go to the Custom properties tab group. Enter "moodleLanguage" in the '''Name''' field and "en" (or your preferred language) in the '''Value''' field, then click the 'Add' button and the 'OK' button". The required property is now added, and Moodle will import the file OK.
 
+
<gallery>
# Unzip the [https://github.com/ecampbell/moodle-question_format_wordtable/zipball/MOODLE_20_STABLE PHP source code file (Moodle 2.1 - 2.6)] or [https://github.com/ecampbell/moodle-question_format_wordtable/zipball/MOODLE_19_STABLE (Moodle 1.9)] in the question/format/ folder of your Moodle server. It will place the PHP code in the folder ecampbell-moodle-question_format_wordtable-xxxxxx.
+
WordFileCustomProperties.png|Custom property for Moodle language value
# Rename the folder to 'wordtable'.
+
</gallery>
# Use the Moodle Question Export page to export a Word file. You should see a new item in the File format list, 'wordtable'. Select this item, and choose any question category containing some questions.
 
# You should see the list of question names, and be prompted to save or open a Word file, or else you should click on the link at the bottom of the page.
 
# If you see the error message "You need the XSLT library installed in PHP to save this Word file" (xsltunavailable in non-English installations), then your Moodle configuration is not configured to support exporting to Word format, and you will need to update it. See [https://moodle.org/mod/forum/discuss.php?d=187209 this forum thread]
 
# Regardless of whether the export to Word facility works, use the web-based facility to import a Word file. You should see a new item in the File format list, 'wordtable'. Select this item, and choose any Word file, it doesn't matter what format.
 
# You will be redirected to the registration page, and prompted to register your installation. Most fields are filled in automatically, but you must choose a password.
 
# Submit the form, and you should see a "Registration successful" message in a few moments. You will then be redirected back to the question import page.
 
# Install the [http://www.moodle2word.net/course/view.php?id=2 appropriate Word template (guest login required)] on your PC, and create a question file. Use the question import form to upload and convert the Word file.
 
# If all goes well, your questions should be imported into your course. If not, send me an email at help@moodle2word.net and I will try to help you out.
 
# After you complete the registration process successfully, you will be able to import questions in Word tables into Moodle.
 
  
 
==See also==
 
==See also==
Line 43: Line 46:
 
* Downloads: the plugin is available in the Moodle Plugins Directory from [http://moodle.org/plugins/view.php?plugin=qformat_wordtable  Moodle2Word Word table import/export].
 
* Downloads: the plugin is available in the Moodle Plugins Directory from [http://moodle.org/plugins/view.php?plugin=qformat_wordtable  Moodle2Word Word table import/export].
 
* Discussions: [http://moodle.org/mod/forum/view.php?f=121 Quiz module], [https://moodle.org/mod/forum/discuss.php?d=146284 Export Quiz]
 
* Discussions: [http://moodle.org/mod/forum/view.php?f=121 Quiz module], [https://moodle.org/mod/forum/discuss.php?d=146284 Export Quiz]
 +
* More information, demo screencasts, Word templates, etc.: [http://www.Moodle2Word.net www.Moodle2Word.net].
 +
* This [https://moodle.org/mod/forum/discuss.php?d=346212 forum thread] about another option that's a little more experimental, but doesn't rely on macros (it's based on the same code as the Macro version.
  
 
[[Category:Contributed code]]
 
[[Category:Contributed code]]
 
[[Category:Quiz]]
 
[[Category:Quiz]]
 
[[Category:Questions]]
 
[[Category:Questions]]
 +
[[Category:Mathematics]]
 +
 +
[[es:Formato tabla Word]]

Latest revision as of 06:28, 23 May 2019

Word table format
Type Question format, Microsoft Word table format
Set N/A
Downloads https://moodle.org/plugins/view.php?plugin=qformat_wordtable
Issues http://tracker.moodle.org/browse/CONTRIB/component/10690
Discussion https://moodle.org/mod/forum/discuss.php?d=121707
Maintainer(s) Eoin Campbell

Moodle2Word is a Moodle plugin that allows question banks to be exported from Moodle into a Word file. The Word file can then be used to quickly review large numbers of questions (either online or in print), or to prepare paper tests (where the answers and feedback is hidden). Questions in the Word table format can also be imported back into Moodle.

Features

  • The tables contain all components of a question, including the stem, answer options, option-specific and general feedback, hints, tags, and any images.
  • All the main question types except Numerical and Calculated questions are supported.
  • With the aid of commands in an external Word template, questions can be re-formatted to hide the answers etc, allowing the questions to be printed as a paper quiz.
  • Questions can be edited in Word, and then imported back into Moodle. That means you can import the following:
    • Matching: Match 4 or more words or phrases.
    • Multiple-Choice: Choose the 1 correct answer from 4 or more possible answers
    • Multiple-Answer: Choose 1 or more correct answers from 4 or more possible answers.
    • Short Answer: Free text answer.
    • Description: Not a question, just a facility to add some text, usually instructions for a set of following questions.
    • Essay: An essay question allows the entry of free text, which is not graded.
    • True/False: Choose whether a statement is true or false.
    • Cloze: Fill-in-the-blanks or Embedded answers question. Use bold to enter Multichoice items, italic to enter Short Answer items, and underline to enter Numerical items.
  • The Cloze question syntax for importing questions is very simple, as it does not require any knowledge of the arcane Moodle syntax; instead, use bold for drop-down menu items, and italic for fill-in text fields.
  • The plug-in supports import from and export to all languages, not just English.
  • Questions can be quickly previewed in Moodle, as you are creating them in Word.
  • Equations edited in Microsoft Equation Editor in Word are converted into MathML in Moodle, and can be displayed using MathJax.

Troubleshooting

The question import facility requires the Microsoft Word file to specify what language the 'labels' used in question tables are in, for example, "Default mark", "General feedback", etc. This is specified in a custom document property called moodleLanguage in the Word file. If you export questions from Moodle into Word, or if you create questions using the Word templates moodleQuestion.dotx and moodleQuestionStartup.dotm available from www.Moodle2Word.net, then this property is automatically set in the file. If you don't, then the following message is displayed when you try to import a Word file.

No questions imported because the language of the labels in the Word file does not match your current Moodle interface language. "en_us" != "en" 

To resolve this issue, add the property manually as follows. In Word, use the File > Info > Properties > Advanced properties command (see screenshot below) to add the property manually.

In the Properties dialog box, go to the Custom properties tab group. Enter "moodleLanguage" in the Name field and "en" (or your preferred language) in the Value field, then click the 'Add' button and the 'OK' button". The required property is now added, and Moodle will import the file OK.

See also