Allow grade recovery during re-enrollment to be site-configurable

Ive added a second commit to tighten up a string but otherwise this looks great. The master branch diff URL was https://github.com/mackensen/moodle/compare/master...MDL-31158

This could be considered a new feature so probably only wants to go into master.

Made some changes to the testing instructions. Now Im after a peer review.

looks good Andrew

Submitting for integration. Im not sure if this is a new feature that should thus only go into head or if it can go into 2.2 and 2.1 stable.

The main moodle.git repository has just been updated with latest weekly modifications. You may wish to rebase your PULL branches to simplify history and avoid any possible merge conflicts. This would also make integrator's life easier next week.

TIA and ciao

Hi Andrew + Helen,

The code for this issue is spot on the only thing I am not sure about are the two new strings.
Would the two of you mind having a think about this and seeing what you think.

Helen the changes Andrew has here introduce a new setting that allows the admin to change a default that controls the restoring of grades when a user is enrolled.
Before this setting Moodle did not restore a users grades if possible when enrolling them in a course.
With this setting you can change that default so that it will restore grades if possible during enrolment.
When a teacher enrols a user they can of course still choose to change whether the grades are restored or not, this is purely a default.

The strings at the moment..
The name of the setting: "Recover grades"
The description: "Recover student grades by default when re-enrolling a student."

I wonder about something like the following:
Name: "Recover grades default"
Desc: "If enabled by default Moodle will attempt to recover a users grades when they are re-enrolled in a course. This can still be changed at the time of enrolment as it only alters the default"

Cheers
Sam

your suggestion for the setting name is good. Your suggestion for the description however is super wordy and confusing.

I would however suggest we tweak for clarity "By default, recover student grades when re-enrolling a student in a course."

I don't think we need to explain that it can be changed. Its expected behaviour that a default can be changed. Its a default, not a forced option. If it cannot be changed then it is not a default

Hi Sam and Andrew,

Thanks for asking my opinion on these new language strings

I assume that the new setting will be added to admin/settings.php?section=enrolsettingsmanual (Settings > Site administration > Plugins > Enrolments > Manual enrolments) - right?

I looked there to check existing strings so that our new strings can follow the same style. I noticed the word 'default' is already used a lot on the page, so it's probably not necessary to use it in both new strings.

Thus, my suggestions for the strings are:

$string['recovergradesdefault'] = 'Recover grades default';

(agreeing with you both!)

$string['recovergradesdefault_help'] = 'Recover grades when re-enrolling a user in a course.';

using Andrew's suggestion and replacing 'student' with 'user' to match the style of other strings.

Alternatively we could go for:

$string['recovergradesdefault_help'] = 'Recover old grades when re-enrolling a user in a course.';

including the word 'old' as it's used in the course UI 'Recover user's old grades if possible'.

Awesome thanks for the thoughts Helen.
Andrew could you please amend the strings and ping me when done so that I can integrate this

Cheers
Sam

Awesome thanks Andrew this has been integrated now.
Noting it was only integrated on master as this is a new feature.

Cheers
Sam

Tested in master. Everything works wells. Test passed.

Some changes to Moodle should be milestones in the project by themselves.

This is not the case and your fix is not so important, but your collaboration is highly appreciated, thanks!

Closing as fixed, ciao

Thanks Andrew for this new setting. Documentation for it can now be found in the 2.3 docs wiki:

• http://docs.moodle.org/23/en/Grade_settings#Recover_grades_default
• http://docs.moodle.org/23/en/Enrolled_users#Enrolling_users