Skip to content

Commit

Permalink
Update notes
Browse files Browse the repository at this point in the history
  • Loading branch information
ecampbell committed Aug 4, 2015
1 parent b9d14a6 commit 4710653
Show file tree
Hide file tree
Showing 2 changed files with 65 additions and 16 deletions.
48 changes: 45 additions & 3 deletions CHANGES.md
Original file line number Diff line number Diff line change
@@ -1,9 +1,8 @@
Release notes
-------------
# Change log

Date Version Comment
2015/08/04 3.2.1 Grab extra memory to allow very large Word files to be imported,
fix Essay and All-or-Nothing question type issues, etc.
fix Essay and All-or-Nothing question type issues
2015/08/01 3.2.0 Support All-or-Nothing Multiple Choice import and export
2015/07/27 3.1.11 Support question export for all built-in question types
2015/07/25 3.1.10 Support question import in Lessons
Expand All @@ -22,3 +21,46 @@ Date Version Comment
2015/02/20 3.0.0 Support import of Word 2010 (.docx) documents, remove all question import limits,
and use of an external conversion server.
Also add support for tables and lists inside item components.

2014/10/08 2.10.1 Fix bug in handling of image filenames containing spaces.
2014/08/12 2.10 Support case-sensitivity and selection style and orientation in Cloze Short Answer / Multiple choice subquestions.
Support specification of default mark in Cloze questions. Fix merging of paragraphs.
2014/07/10 2.9.2 Fix syntax error in db/install.php
2014/07/10 2.9.1 Fix error in registration process set-up, which prevented registration to set 10-question limit.

2014/06/17 2.9 Use default username and password for importing Word files to make Registration optional.
Handle named numeric entities (e.g.  ) by converting them to numeric entities
instead (i.e.  ) to avoid XSLT processing errors.

2014/05/12 2.8.5 Handle invalid 'complete="true"' attribute in images, fix loop through all CDATA
sections, keep tr elements when cleaning HTML manually.

2014/05/07 2.8.4 Fix error in image handling in Moodle 1.9, add work-around to cope with XSLT
idiosyncrasies that insert namespace declaration on wrong element, breaking the
Word export facility. Fix mishandling of Hints in Short Answer export.

2014/05/04 2.8.3 Improve image handling to properly export any images used inside feedback text.

2014/05/03 2.8.2 Handle images with names that include spaces or other non-alphanumeric characters.

2014/05/02 2.8.1 CONTRIB-5028: clean up HTML markup better (using strip_tags) if the PHP tidy
extension is not installed.

2014/04/28 2.8 Use the PHP tidy extension to ensure that any HTML inside CDATA sections is well-formed
XHTML, otherwise Word export fails.

2014/02/27 2.7.1 Add Word export support for RTL languages such as Arabic and Hebrew.

2014/02/03 2.7 Add Word export support for languages other than English, using labels in the language
of the users' current interface language selection. Also support new Moodle 2.x
question features such as Hints and Tags.

2014/01/03 2.6 Add support for including any images used in questions exported into a Word file, in a
two-stage process that also requires using a command in the Moodle2Word Word template to
embed the encoded images into the file.

2013/12/20 2.5 Improve handling of CDATA text that includes HTML markup, and the Moodle 1.9 question
textancillary image element.

2013/03/15 2.4 Improve handling of Cloze question formatting when exporting to Word format.

33 changes: 20 additions & 13 deletions README.txt
Original file line number Diff line number Diff line change
@@ -1,25 +1,32 @@
Word Table Overview
-------------------

# Description
Moodle2Word is a plugin that allows quiz questions 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 are hidden).

Moodle2Word also supports importing questions from structured tables in Word directly into the Moodle question database.
The tables support all the question components (stem, answer options, option-specific and general feedback, hints, tags
and question meta-data such as penalties grades and other options), as well as embedded images.
All the main question types except Numerical and Calculated questions are supported.
Unregistered sites can import up to 5 questions, and registered sites 10.
To remove these limits an annual subscription is required.
Moodle2Word also supports importing questions from structured tables in Word directly into the Moodle question bank.
The tables support all the question components (stem, answer options, option-specific and general feedback,
hints, tags and question meta-data such as penalties grades and other options), as well as embedded images.
All the main question types except Numerical and Calculated questions are fully supported.
Numerical and Calculated questions are exported, but cannot be imported.

The Cloze question syntax is particularly useful, 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.

# Language support
Exported questions are labelled in the language of the current Moodle user interface, and the spell-check language is
also set to the correct language.
Similarly, questions can be imported in the same language, not just English.
Both left-to-right and right-to-left languages (such as Arabic and Hebrew) are supported.

# Supporting Word templates
Word templates to support the plugin can be downloaded from the demonstration website
www.Moodle2Word.net, and are available for Word 2002/XP, 2003, 2007 and 2010 (Windows),
www.Moodle2Word.net, and are available for Word 2003, 2007, 2010 and 2013 (Windows),
and Word 2004 and 2011 (MacOSX). The Windows templates also support a simple question preview facility,
as well as uploading questions from within Word.

Exported questions contain metadata labelled in the language of the user, and the text is in paragraphs
with the spell-check language also set to the same language has the user has chosen for their Moodle interface.
Both left-to-right and right-to-left languages (such as Arabic and Hebrew) are supported.
If questions contain images, then you need to install the Word template in order to be able to convert
the images in exported questions into embedded images in Word, as they are not automatically visible.

The Word templates are available in most major languages, including English, Spanish and Chinese.
Templates for other languages can be easily added, so feel free to ask.

0 comments on commit 4710653

Please sign in to comment.