Note: You are currently viewing documentation for Moodle 3.3. Up-to-date documentation for the latest stable version of Moodle is probably available here: Grades min max.

Grades min max

From MoodleDocs

Summary

When grading in Moodle, either in an activity or directly in the gradebook, you assign the student a score from a specified range. The Grades min max setting controls how the grade will be displayed if the maximum or minimum grades are changed after student has been graded.

The 2 options are:

1) "Min and max grades as specified in grade item settings" - The student's grade will be displayed out of the new range and this will affect their percentage.

2) "Initial min and max grades" - The student's grades are displayed with the range that was defined at the time the student was graded.

Example:

  • Assignment is created with maximum grade of 10
  • Sally Student receives a score of 5 out of 10 (50%)
  • The assignment maximum grade is changed to 20

If "Min and max grades used in calculation" is set to "Min and max grades as specified in grade item settings", Sally Student will have a score of 5 out of 20 (25%)

If "Min and max grades used in calculation" is set to "Initial min and max grades", Sally Student will have a score of 5 out of 10 (50%) until a teacher manually regrades Sally Student out of 20.

Information for sites upgrading from earlier versions of Moodle

The default behaviour is "Min and max grades as specified in grade item settings".

In Moodle 2.8.0 - 2.8.6 and 2.9.0 the behaviour was unintentionally changed to "Initial min and max grades".

In Moodle 2.8.7 and Moodle 2.9.1 it was restored to "Min and max grades as specified in grade item settings" and this setting was added to allow changing the behaviour. Some courses affected by the upgrade will display notices to alert them to the new setting.

How to find all courses that are affected

   SELECT * FROM mdl_config WHERE name LIKE 'show_min_max_grades_changed_%' ORDER BY name

That will return rows containing things like "show_min_max_grades_changed_211". That means that course 211 is affected. So, the URL to get to the gradebook for that course is .../grade/index.php?id=211 within your Moodle site. With a bit of clever search-and-replace, you can probably turn the output from the gradebook query into a set of URLs. For example the following is a more sophisicated version of this query that works well with the Ad-hoc database queries plugin.

   SELECT substr(cfg.name, 29) AS Course_id,
       course.shortname AS Course_shortname,
       CONCAT('%%WWWROOT%%', '/grade/report/grader/index.php', CHR(63), 'id=', substr(cfg.name, 29)) AS Grader_report_url
   
   FROM {config} cfg
   JOIN {course} course ON course.id = CAST(substr(name, 29) AS INT)
   
   WHERE name LIKE 'show_min_max_grades_changed_%'
   
   ORDER BY course.shortname

Who will see the warning message and button in the gradebook?

Only users with the moodle/grade:manage capability (by default teacher, manager and admin) will see the warning message and button.

How can I see what grades will change before I click the button?

The only way to do this is to have a copy of your live site where you can test. (Testing with a copy of your live site is recommended good practice.)

In that test copy you can use the report above to find all course gradebooks that are affected. Then, by using the Grade history report, you can see which grades change when you click the button, and confirm you are happy with the changes before doing the same on your live site.

See also

  • MDL-48618 Unexpected changes on grades after upgrade to Moodle 2.8