From e2245b62d42d2ea48f77c1a851663137bb3515fe Mon Sep 17 00:00:00 2001 From: Tim Hunt Date: Thu, 14 Mar 2013 15:49:33 +0000 Subject: [PATCH] MDL-47494 ddmarker: Bump version number. --- question/type/ddmarker/README.md | 102 ++++++++++++++++------------- question/type/ddmarker/version.php | 8 +-- 2 files changed, 61 insertions(+), 49 deletions(-) diff --git a/question/type/ddmarker/README.md b/question/type/ddmarker/README.md index 29cddfa6509..3c6b690e6cc 100644 --- a/question/type/ddmarker/README.md +++ b/question/type/ddmarker/README.md @@ -1,41 +1,35 @@ Drag-and-drop markers question type ----------------------------------- -You can use markers with text labels as drag items onto rectangular, and in -Moodle 2.2+ version circular and polygon defined drop zones on a background image. +You can use markers with text labels as drag items onto rectangular, circular or +polygon drop zones on a background image. This question type requires that gapselect question type https://github.com/moodleou/moodle-qtype_ddimageortext/ and https://github.com/moodleou/moodle-qtype_gapselect/ to be installed in order to work. -This question type was written by Jamie Pratt (http://jamiep.org/). +This question type was written by Jamie Pratt (http://jamiep.org/) for the Open +University. -This question type is compatible with Moodle 2.1+ (MOODLE_21_STABLE branch) or -2.2+ (master branch). +This question type is compatible with Moodle 2.3+ (master branch). ###Installation ####Installation Using Git -To install using git for a 2.2+ Moodle installation, type this command in the +To install using git for a 2.3+ Moodle installation, type this command in the root of your Moodle install: git clone git://github.com/moodleou/moodle-qtype_ddmarker.git question/type/ddmarker -To install using git for a 2.1+ Moodle installation, type this command in the -root of your Moodle install: - -git clone -b MOODLE_21_STABLE git://github.com/moodleou/moodle-qtype_ddmarker.git question/type/ddmarker - Then add question/type/ddmarker to your git ignore. ####Installation From Downloaded zip file -Alternatively, download the zip from : +Alternatively, download the zip from: -* Moodle 2.2+ - https://github.com/moodleou/moodle-qtype_ddmarker/zipball/master -* Moodle 2.1+ - https://github.com/moodleou/moodle-qtype_ddmarker/zipball/MOODLE_21_STABLE +* Moodle 2.3+ - https://github.com/moodleou/moodle-qtype_ddmarker/zipball/master unzip it into the question/type folder, and then rename the new folder to ddmarker. @@ -52,16 +46,16 @@ There are two ways to convert your imagetarget questions to ddmarker question ty Conversion will happen automatically when you upgrade for Moodle 2.0. -It is recommended you follow the following steps : +It is recommended you follow the following steps: -Upgrade your site to Moodle 2.0. This involves : +Upgrade your site to Moodle 2.0. This involves: * Upgrade the code base to Moodle 2.0 * Remove the imagetarget question type code from question/type/imagetarget/ * Go to your http://{moodleroot}/admin/ to trigger the upgrade of the db -At this point your imagetarget questions won't work and will show up as 'missing type' but once that upgrade is -done change your Moodle code to Moodle 2.2+ +At this point your imagetarget questions won't work and will show up as +'missing type' but once that upgrade is done change your Moodle code to Moodle 2.2+ * install the ddmarker question type code in question type ddmarker. * then go to your http://{moodleroot}/admin/ to trigger the upgrade of the db @@ -70,13 +64,16 @@ This will convert all your imagetarget questions to ddmarker automatically. ####Manual Conversion -You can also use a manual script to convert imagetarget questions to ddmarker after upgrading to Moodle 2.1 or greater. +You can also use a manual script to convert imagetarget questions to ddmarker +after upgrading to Moodle 2.1 or greater. * Log in as admin. -* You will find a script in the admin menu under plugins/question types/ to convert your imagetarget questions to ddmarker. +* You will find a script in the admin menu under plugins/question types/ to +convert your imagetarget questions to ddmarker. (This just converts your questions themselves.) -* In order to convert your question attempt data to be used with the ddmarker question type and Moodle 2.1 or greater you need to -find the 'question engine upgrade helper' which will appear at the root of the admin menu. Use this script to : +* In order to convert your question attempt data to be used with the ddmarker +question type and Moodle 2.1 or greater you need to find the 'question engine +upgrade helper' which will appear at the root of the admin menu. Use this script to: * _Reset the upgrade of all attempt data._ * _Run the attempt data upgrade again._ @@ -84,48 +81,63 @@ find the 'question engine upgrade helper' which will appear at the root of the a ####Background image shrinkage -The ddmarker question type will shrink the background image of your questions to be within a maximum size and width while at the -time preserving aspect ratio of the image. The default max width is 600 pixels and height 400 pixels. +The ddmarker question type will shrink the background image of your questions to +be within a maximum size and width while at the time preserving aspect ratio of +the image. The default max width is 600 pixels and height 400 pixels. The ddmarker question type does this whenever you edit a question and save it again. -Unfortunately when you open up a question to edit it this means that if the image is to big it will be shrunk but at present the -position of your drop zones are not moved to compensate for this shrinkage. There won't be a problem until you try to edit and save -a question but when you open it in the editor the drop zones will not be in the correct position. If you save the question they +Unfortunately when you open up a question to edit it this means that if the +image is to big it will be shrunk but at present the position of your drop zones +are not moved to compensate for this shrinkage. There won't be a problem until +you try to edit and save a question but when you open it in the editor the drop +zones will not be in the correct position. If you save the question they they will then be saved in the wrong position. ####Work around for background image shrinkage -Either : +Either: * do not edit questions which have sizes above the allowed max. -* or you can change the allowed maximum size of images there are two constant at the top of question/type/ddmarker/questiontype.php -that define the size limits. +* or you can change the allowed maximum size of images there are two constant at +the top of question/type/ddmarker/questiontype.php that define the size limits. -The limit is just there to shrink outrageously large images down to a reasonable size automatically. You could set the value of the -constants defining the max size to a very large value to effectively disable the image size constraints all together. +The limit is just there to shrink outrageously large images down to a reasonable +size automatically. You could set the value of the constants defining the max +size to a very large value to effectively disable the image size constraints all +together. ####Lack of drag label in imagetarget questions -Normally each draggable marker in the ddmarker question type has a text label. There are no labels for the imagetarget markers -though, I needed to pick something that will work in any language as the label for the single imagetarget draggable marker -so I picked 'X'. +Normally each draggable marker in the ddmarker question type has a text label. +There are no labels for the imagetarget markers though, I needed to pick +something that will work in any language as the label for the single imagetarget +draggable marker so I picked 'X'. ####Work around for lack of drag label in imagetarget questions -Your teachers can edit this label after the question has been created. And they might also like to take advantage of the ability in -the ddmarker question type to be able to specify the correct drop zones for more than one drag marker onto the same image, -giving each drag marker a different label. +Your teachers can edit this label after the question has been created. And they +might also like to take advantage of the ability in the ddmarker question type +to be able to specify the correct drop zones for more than one drag marker onto +the same image, giving each drag marker a different label. -You can change the default drag marker label which you can find defined in a constant at the top of question/type/ddmarker/lib.php +You can change the default drag marker label which you can find defined in a +constant at the top of question/type/ddmarker/lib.php ####No automatic feedback telling the user whether they got the question right, partially right or wrong. -In the imagetarget question you get a text message telling the user whether they got the question correct, partially correct or -wrong. In many of the new question types in Moodle 2.1 onwards the teacher is expected to enter the message that the user will -see in the question definition. This is called 'combined feedback' and by default it is blank. So questions that have been -converted from per 2.1 Moodle, from imagetarget question types that used to give some feedback to the user will no longer do so. +In the imagetarget question you get a text message telling the user whether they +got the question correct, partially correct or wrong. In many of the new +question types in Moodle 2.1 onwards the teacher is expected to enter the +message that the user will see in the question definition. This is called +'combined feedback' and by default it is blank. So questions that have been +converted from per 2.1 Moodle, from imagetarget question types that used to +give some feedback to the user will no longer do so. -####Work around for lack of automatic feedback telling the user whether they got the question right, partially right or wrong. +####Work around for lack of automatic feedback telling the user whether they got -You can use this plug in https://github.com/jamiepratt/moodle-admin_tool_questionaddfeedback to bulk add feedback to questions. +the question right, partially right or wrong. + +You can use this plug in +https://github.com/jamiepratt/moodle-admin_tool_questionaddfeedback to bulk add +feedback to questions. diff --git a/question/type/ddmarker/version.php b/question/type/ddmarker/version.php index 110978875ee..8148c6a3865 100644 --- a/question/type/ddmarker/version.php +++ b/question/type/ddmarker/version.php @@ -26,14 +26,14 @@ defined('MOODLE_INTERNAL') || die(); -$plugin->version = 2012081600; +$plugin->version = 2013031400; $plugin->requires = 2012062500; $plugin->cron = 0; $plugin->component = 'qtype_ddmarker'; $plugin->maturity = MATURITY_STABLE; -$plugin->release = '1.1 for Moodle 2.3+'; +$plugin->release = '1.2 for Moodle 2.3+'; $plugin->dependencies = array( - 'qtype_gapselect' => 2011020100, - 'qtype_ddimageortext' => 2011020100, + 'qtype_gapselect' => 2013031400, + 'qtype_ddimageortext' => 2013031400, );