diff --git a/mod/workshop/eval/best/lang/en/workshopeval_best.php b/mod/workshop/eval/best/lang/en/workshopeval_best.php index eac4b8b3f7d..2bc5a3ad000 100644 --- a/mod/workshop/eval/best/lang/en/workshopeval_best.php +++ b/mod/workshop/eval/best/lang/en/workshopeval_best.php @@ -24,6 +24,7 @@ */ $string['comparison'] = 'Comparison of assessments'; +$string['comparison_help'] = 'This is a factor that influences the grades for assessments calculated during the grading evaluation. If it is set to strict, then the assessment must be very similar to the best one to get a high grade. If it is set to lax, then the calculation is more benevolent to the differences in the assessments. Experiment with using various levels to get the figures you like most.'; $string['comparisonlevel1'] = 'very strict'; $string['comparisonlevel3'] = 'strict'; $string['comparisonlevel5'] = 'fair'; diff --git a/mod/workshop/eval/best/settings_form.php b/mod/workshop/eval/best/settings_form.php index fe0af1c0d8d..f66f34188a4 100644 --- a/mod/workshop/eval/best/settings_form.php +++ b/mod/workshop/eval/best/settings_form.php @@ -40,7 +40,7 @@ class workshop_best_evaluation_settings_form extends moodleform { $label = get_string('evaluationmethod', 'workshop'); $mform->addElement('static', 'methodname', $label, get_string('pluginname', 'workshopeval_best')); - $mform->setHelpButton('methodname', array('method', $label, 'workshopeval_best')); + $mform->addHelpButton('methodname', 'evaluationmethod', 'workshop'); $options = array(); for ($i = 9; $i >= 1; $i = $i-2) { @@ -48,7 +48,7 @@ class workshop_best_evaluation_settings_form extends moodleform { } $label = get_string('comparison', 'workshopeval_best'); $mform->addElement('select', 'comparison', $label, $options); - $mform->setHelpButton('comparison', array('comparison', $label, 'workshopeval_best')); + $mform->addHelpButton('comparison', 'comparison', 'workshopeval_best'); $mform->setDefault('comparison', $plugindefaults->comparison); $mform->addElement('submit', 'submit', get_string('aggregategrades', 'workshop')); diff --git a/mod/workshop/lang/en/workshop.php b/mod/workshop/lang/en/workshop.php index 4b8349edd85..baac8d84182 100644 --- a/mod/workshop/lang/en/workshop.php +++ b/mod/workshop/lang/en/workshop.php @@ -74,6 +74,7 @@ $string['err_removegrademappings'] = 'Unable to remove the unused grade mappings $string['evaluategradeswait'] = 'Please wait until the assessments are evaluated and the grades are calculated'; $string['evaluation'] = 'Grading evaluation'; $string['evaluationmethod'] = 'Grading evaluation method'; +$string['evaluationmethod_help'] = 'The method how grades for assessments are calculated for each reviewer.'; $string['example'] = 'Example submission'; $string['exampleadd'] = 'Add example submission'; $string['exampleassess'] = 'Assess example submission'; @@ -106,6 +107,7 @@ $string['gradeitemsubmission'] = '{$a->workshopname} (submission)'; $string['gradeover'] = 'Override grade for submission'; $string['gradereceivedfrom'] = '<'; $string['gradinggrade'] = 'Grade for assessment'; +$string['gradinggrade_help'] = 'Maximum grade that a participant may be given for assessing other\'s work. It tries to meassure the reliability and the quality of the assessment. It is calculated as a mean of particular grades for assessment (also known as grading grades). That grades are calculated automatically by grading evaluation subplugin.'; $string['gradinggradecalculated'] = 'Calculated grade for assessment'; $string['gradinggradeof'] = 'Grade for assessment (of {$a})'; $string['gradinggradeover'] = 'Override grade for assessment'; @@ -117,7 +119,8 @@ $string['instructauthors'] = 'Instructions for submitting'; $string['instructreviewers'] = 'Instructions for assessing'; $string['introduction'] = 'Introduction'; $string['latesubmissions'] = 'Late submissions'; -$string['latesubmissionsdesc'] = 'Allow submitting the work after the deadline'; +$string['latesubmissions_desc'] = 'Allow submitting the work after the deadline'; +$string['latesubmissions_help'] = 'If late submissions are allowed then workshop participants can submit their work even after the deadline for submitting. Late submission can\'t be edited after it has been saved. This allows the participants who have not manage to submit their work in time (because they were ill, for example) to continue the workshop activity. Note that a submission can be allocated to a reviewer for assessment even if the reviewer has not submitted his/her own work.'; $string['maxbytes'] = 'Maximum file size'; $string['messageclose'] = '(X)'; $string['modulename'] = 'Workshop'; @@ -154,23 +157,25 @@ $string['someuserswosubmission'] = 'There are some users who have not submitted $string['sortasc'] = 'Ascending sort'; $string['sortdesc'] = 'Descending sort'; $string['strategy'] = 'Grading strategy'; +$string['strategy_help'] = 'Grading strategy defines how the assessment form can look like and how the grade for submission is calculated based on the assessment.'; $string['strategyhaschanged'] = 'The workshop grading strategy has changed since the form was opened for editing.'; $string['submission'] = 'Submission'; $string['submissionattachment'] = 'Attachment'; $string['submissioncontent'] = 'Submission content'; $string['submissionend'] = 'Submitting not allowed after'; $string['submissiongrade'] = 'Grade for submission'; +$string['submissiongrade_help'] = 'Maximum grade that the authors may get for their submission. The grade for submission is calculated as a weighted mean of all assessments of the given submission, done by peers and/or teachers.'; $string['submissiongradeof'] = 'Grade for submission (of {$a})'; $string['submissionsettings'] = 'Submission settings'; $string['submissionstart'] = 'Submitting not allowed before'; $string['submissiontitle'] = 'Title'; $string['switchingphase'] = 'Switching phase'; $string['switchphase'] = 'Switch phase'; -$string['switchphase10info'] = 'You are going to switch the Workshop into the Setup phase. (TODO: explain what the participants and moderators will do in the new phase)'; -$string['switchphase20info'] = 'You are going to switch the Workshop into the Submission phase. (TODO: explain what the participants and moderators will do in the new phase)'; -$string['switchphase30info'] = 'You are going to switch the Workshop into the Assessment phase. (TODO: explain what the participants and moderators will do in the new phase)'; -$string['switchphase40info'] = 'You are going to switch the Workshop into the Grading evaluation phase. (TODO: explain what the participants and moderators will do in the new phase)'; -$string['switchphase50info'] = 'You are going to close the Workshop. (TODO: explain what the participants and moderators will do in the new phase)'; +$string['switchphase10info'] = 'You are going to switch the Workshop into the Setup phase. During this phase, workshop participants can\'t modify either their submissions or assessments. Teachers can use this phase to change workshop settings, modify grading strategy of tweak assessment forms.'; +$string['switchphase20info'] = 'You are going to switch the Workshop into the Submission phase. Workshop participants can submit their work during this phase. If you have set submitting deadlines in the workshop configuration, they will be respected in this phase. Teachers can watch the submitting progress and allocate submissions for a peer review.'; +$string['switchphase30info'] = 'You are going to switch the Workshop into the Assessment phase. In this phase, reviewers are able to assess the submissions that have been allocated to them for assessment.'; +$string['switchphase40info'] = 'You are going to switch the Workshop into the Grading evaluation phase. Workshop participants can\'t either modify their assessments or amend submissions. Teachers are able to use grading evaluation tools to calculate final grades and provide feedback for reviewers.'; +$string['switchphase50info'] = 'You are going to close the Workshop. This pushes the calculated grades into the course gradebook. Workshop participants can see their work and assessments. Published submissions as made available.'; $string['taskassesspeers'] = 'Assess peers'; $string['taskassesspeersdetails'] = 'total: {$a->total}
pending: {$a->todo}'; $string['taskassessself'] = 'Assess yourself'; @@ -180,13 +185,16 @@ $string['taskintro'] = 'Set the workshop introduction'; $string['tasksubmit'] = 'Submit your work'; $string['undersetup'] = 'The workshop is currently under setup. Please wait until it is switched to the next phase.'; $string['useexamples'] = 'Use examples'; -$string['useexamplesdesc'] = 'Users practise evaluating on example submissions'; +$string['useexamples_desc'] = 'Users practise evaluating on example submissions'; +$string['useexamples_help'] = 'Workshop participants can practise the assessment procedure on example submissions, provided by teacher. For example, there can be a sample of one good submission and one weak submission provided together with an assessment. This step may help understanding the assessment criteria.'; $string['usepeerassessment'] = 'Use peer assessment'; -$string['usepeerassessmentdesc'] = 'Users perform peer assessment of others\' work'; +$string['usepeerassessment_desc'] = 'Users perform peer assessment of others\' work'; +$string['usepeerassessment_help'] = 'If the peer assessment support is off, workshop participants are not expected to assess their peers\' work. They do not receive any grade for assessment (grading grade) and their grade for submission is based on teacher\'s assessment only.'; $string['userdatecreated'] = 'submitted on {$a}'; $string['userdatemodified'] = 'modified on {$a}'; $string['useselfassessment'] = 'Use self assessment'; -$string['useselfassessmentdesc'] = 'Users perform self assessment of their own work'; +$string['useselfassessment_desc'] = 'Users perform self assessment of their own work'; +$string['useselfassessment_help'] = 'Whether users are allowed to assess their own work. Note that you must still allocate the submissions to their authors explicitely, using some allocation plugin.'; $string['withoutsubmission'] = 'Reviewer without own submission'; $string['workshopadministration'] = 'Workshop administration'; $string['workshop:allocate'] = 'Allocate submissions for review'; diff --git a/mod/workshop/mod_form.php b/mod/workshop/mod_form.php index 8c83601f632..d937fd334da 100644 --- a/mod/workshop/mod_form.php +++ b/mod/workshop/mod_form.php @@ -59,7 +59,6 @@ class mod_workshop_mod_form extends moodleform_mod { } $mform->addRule('name', null, 'required', null, 'client'); $mform->addRule('name', get_string('maximumchars', '', 255), 'maxlength', 255, 'client'); - $mform->setHelpButton('name', array('workshopname', $label, 'workshop')); // Introduction $this->add_intro_editor(false, get_string('introduction', 'workshop')); @@ -68,19 +67,19 @@ class mod_workshop_mod_form extends moodleform_mod { $mform->addElement('header', 'workshopfeatures', get_string('workshopfeatures', 'workshop')); $label = get_string('useexamples', 'workshop'); - $text = get_string('useexamplesdesc', 'workshop'); + $text = get_string('useexamples_desc', 'workshop'); $mform->addElement('checkbox', 'useexamples', $label, $text); - $mform->setHelpButton('useexamples', array('useexamples', $label, 'workshop')); + $mform->addHelpButton('useexamples', 'useexamples', 'workshop'); $label = get_string('usepeerassessment', 'workshop'); - $text = get_string('usepeerassessmentdesc', 'workshop'); + $text = get_string('usepeerassessment_desc', 'workshop'); $mform->addElement('checkbox', 'usepeerassessment', $label, $text); - $mform->setHelpButton('usepeerassessment', array('usepeerassessment', $label, 'workshop')); + $mform->addHelpButton('usepeerassessment', 'usepeerassessment', 'workshop'); $label = get_string('useselfassessment', 'workshop'); - $text = get_string('useselfassessmentdesc', 'workshop'); + $text = get_string('useselfassessment_desc', 'workshop'); $mform->addElement('checkbox', 'useselfassessment', $label, $text); - $mform->setHelpButton('useselfassessment', array('useselfassessment', $label, 'workshop')); + $mform->addHelpButton('useselfassessment', 'useselfassessment', 'workshop'); // Grading settings ----------------------------------------------------------- $mform->addElement('header', 'gradingsettings', get_string('gradingsettings', 'workshop')); @@ -90,17 +89,17 @@ class mod_workshop_mod_form extends moodleform_mod { $label = get_string('submissiongrade', 'workshop'); $mform->addElement('select', 'grade', $label, $grades); $mform->setDefault('grade', $workshopconfig->grade); - $mform->setHelpButton('grade', array('grade', $label, 'workshop')); + $mform->addHelpButton('grade', 'submissiongrade', 'workshop'); $label = get_string('gradinggrade', 'workshop'); $mform->addElement('select', 'gradinggrade', $label , $grades); $mform->setDefault('gradinggrade', $workshopconfig->gradinggrade); - $mform->setHelpButton('gradinggrade', array('gradinggrade', $label, 'workshop')); + $mform->addHelpButton('gradinggrade', 'gradinggrade', 'workshop'); $label = get_string('strategy', 'workshop'); $mform->addElement('select', 'strategy', $label, workshop::available_strategies_list()); $mform->setDefault('strategy', $workshopconfig->strategy); - $mform->setHelpButton('strategy', array('strategy', $label, 'workshop')); + $mform->addHelpButton('strategy', 'strategy', 'workshop'); $options = array(); for ($i=5; $i>=0; $i--) { @@ -108,7 +107,6 @@ class mod_workshop_mod_form extends moodleform_mod { } $label = get_string('gradedecimals', 'workshop'); $mform->addElement('select', 'gradedecimals', $label, $options); - $mform->setHelpButton('gradedecimals', array('gradedecimals', $label, 'workshop')); $mform->setAdvanced('gradedecimals'); $mform->setDefault('gradedecimals', $workshopconfig->gradedecimals); @@ -126,18 +124,16 @@ class mod_workshop_mod_form extends moodleform_mod { $label = get_string('nattachments', 'workshop'); $mform->addElement('select', 'nattachments', $label, $options); $mform->setDefault('nattachments', 1); - $mform->setHelpButton('nattachments', array('nattachments', $label, 'workshop')); $options = get_max_upload_sizes($CFG->maxbytes, $COURSE->maxbytes); $options[0] = get_string('courseuploadlimit') . ' ('.display_size($COURSE->maxbytes).')'; - $mform->addElement('select', 'maxbytes', get_string('maximumsize', 'assignment'), $options); + $mform->addElement('select', 'maxbytes', get_string('maxbytes', 'workshop'), $options); $mform->setDefault('maxbytes', $workshopconfig->maxbytes); - $mform->setHelpButton('maxbytes', array('maxbytes', $label, 'workshop')); $label = get_string('latesubmissions', 'workshop'); - $text = get_string('latesubmissionsdesc', 'workshop'); + $text = get_string('latesubmissions_desc', 'workshop'); $mform->addElement('checkbox', 'latesubmissions', $label, $text); - $mform->setHelpButton('latesubmissions', array('latesubmissions', $label, 'workshop')); + $mform->addHelpButton('latesubmissions', 'latesubmissions', 'workshop'); $mform->setAdvanced('latesubmissions'); // Assessment settings -------------------------------------------------------- @@ -151,7 +147,6 @@ class mod_workshop_mod_form extends moodleform_mod { $options = workshop::available_example_modes_list(); $mform->addElement('select', 'examplesmode', $label, $options); $mform->setDefault('examplesmode', $workshopconfig->examplesmode); - $mform->setHelpButton('examplesmode', array('examplesmode', $label, 'workshop')); $mform->disabledIf('examplesmode', 'useexamples'); $mform->setAdvanced('examplesmode'); @@ -160,22 +155,18 @@ class mod_workshop_mod_form extends moodleform_mod { $label = get_string('submissionstart', 'workshop'); $mform->addElement('date_time_selector', 'submissionstart', $label, array('optional' => true)); - $mform->setHelpButton('submissionstart', array('submissionstart', $label, 'workshop')); $mform->setAdvanced('submissionstart'); $label = get_string('submissionend', 'workshop'); $mform->addElement('date_time_selector', 'submissionend', $label, array('optional' => true)); - $mform->setHelpButton('submissionend', array('submissionend', $label, 'workshop')); $mform->setAdvanced('submissionend'); $label = get_string('assessmentstart', 'workshop'); $mform->addElement('date_time_selector', 'assessmentstart', $label, array('optional' => true)); - $mform->setHelpButton('assessmentstart', array('assessmentstart', $label, 'workshop')); $mform->setAdvanced('assessmentstart'); $label = get_string('assessmentend', 'workshop'); $mform->addElement('date_time_selector', 'assessmentend', $label, array('optional' => true)); - $mform->setHelpButton('assessmentend', array('assessmentend', $label, 'workshop')); $mform->setAdvanced('assessmentend'); // Common module settinga, Restrict availability, Activity completion etc. ----