MDL-59169 gradebook: Add groupid to gpr tracking & use
[moodle.git] / grade / upgrade.txt
index a313a20..eba33e9 100644 (file)
@@ -1,8 +1,19 @@
-This files describes API changes in /grade/*,
-information provided here is intended especially for developers.
+This file describes API changes in /grade/* ;
+Information provided here is intended especially for developers.
 
+=== 3.6 ===
 
-=== 2.7.0 ===
-* The class core_grade_external in grade/externallib.php has been renamed to core_grading_external.
-  grade/externallib.php is concerned with the grading API not the grades API.
-  The change was necessary to avoid a duplicate class name with core_grade_external in lib/grade/externallib.php.
+* The grade_plugin_return constructor now uses parameters from the
+  request as defaults, which can be overridden by parameters supplied
+  to the constructor. This may lead to a change in behaviour if only
+  some of the possible parameters are supplied.
+* The grade_plugin_return class now tracks groupid as well as the
+  type, plugin, courseid, userid and page parameters that were tracked
+  previously. The groupid parameter will be set using
+  groups_get_course_group for the relevant course if the group is
+  otherwise unspecified.
+* The above changes mean that code using grade_plugin_return objects
+  should generally no longer call groups_get_course_group directly,
+  but should use the gpr->groupid parameter instead.
+* The grade_plugin_return constructor now accepts either course or
+  courseid as a parameter to specify course.