grade/upgrade.txt

   1 This file describes API changes in /grade/* ;
   2 Information provided here is intended especially for developers.
   3
   4 === 4.4 ===
   5 * The grade_structure::get_element_icon() function has been deprecated. Please use grade_helper::get_element_icon() instead.
   6 * The grade_structure::get_element_type_string() function has been deprecated. Please use grade_helper::get_element_type_string() instead.
   7 * The grade_structure::get_element_header() function has been deprecated. Please use grade_helper::get_element_header() instead.
   8 * The grade_structure::get_activity_link() functions has been deprecated. Please use grade_helper::get_activity_link() instead.
   9 * Some changes to how print_grade_page_head() sets the page title:
  10   * If a non-empty `$heading` parameter is passed, it will be used as the page title's unique identifying information.
  11   * Add support for grade report plugins that define an `editingmode_title` lang string. If the grade report plugin defines this
  12     language string, it will be used for the page title's unique identifying information when editing mode is turned on.
  13 * The function gradeimport_csv_load_data::insert_grade_record() now has extra parameter $gradeitem to carry over the grade item related info
  14   for validation.
  15 * The function get_gradable_users() in grade/lib.php has extra param now to retrieve only active enrolments.
  16 * A new webservice core_grades_get_gradable_users has been added to retrieve gradable users for a course.
  17
  18 === 4.3 ===
  19 * The $showtitle parameter in the print_grade_page_head function located inside grade/lib.php has been deprecated and is not used anymore.
  20 * The deprecated `core_grades_create_gradecategory` external method has been removed, in addition to the accompanying
  21   `core_grades_external::create_gradecategory` methods
  22 * User, Group & Grade item JS classes have been added to easily enable the creation of combobox search components.
  23   Refer to the dev docs on details of how to implement this feature if desired.
  24 * basewidget.js has been deprecated and its uses replaced with the new JS classes mentioned above.
  25 * With the basewidget being deprecated all usages of it in core have now been migrated and the files that used it removed.
  26   The basewidget itself will go through the proper deprecation process and be removed in a future version.
  27 * The following webservices have had some optional parameters changed:
  28   - grade/classes/external/get_enrolled_users_for_selector
  29     - profileimage -> profileimageurl & profileimageurlsmall
  30     - return changed to use the core_user_external::user_description() method instead of a custom baked one.
  31   - grade/classes/external/get_groups_for_selector
  32     - Has been relocated to core_group_external::get_groups_for_selector()
  33     - groupimageurl is now available as an optional parameter to give the user an image either set or generated for the group.
  34 * The grade `itemname` property contained in the return structure of the following external methods is now PARAM_CLEANHTML:
  35   - `core_grades_get_gradeitems`
  36   - `gradereport_user_get_grade_items`
  37 * The grade_helper::get_lang_string() function has been deprecated. Please use get_string() instead.
  38
  39 === 4.1 ===
  40 * The $importactiveurl parameter in the constructor of the core_grades\output\import_action_bar class has been deprecated and is not used anymore.
  41 * The $exportactiveurl parameter in the constructor of the core_grades\output\export_action_bar class has been deprecated and is not used anymore.
  42 * The select_in_gradebook_navigation_selector() function in behat_grade.php has been deprecated. Please use
  43   behat_forms::i_set_the_field_to() instead.
  44
  45 === 4.0 ===
  46
  47 * The select_in_gradebook_tabs() function in behat_grade.php has been deprecated. Please use the function
  48   select_in_gradebook_navigation_selector() instead.
  49 * The setting $CFG->grade_navmethod setting has been completely removed because it's not required anymore. This setting
  50   was used to set the type of navigation (tabs or dropdown box) used in gradebook which is now replaced with tertiary
  51   navigation.
  52 * The print_grade_plugin_selector() function has been deprecated. This function was used to generate and output the
  53   dropdown box navigation in gradebook which is now replaced with tertiary navigation.
  54 * The grade_print_tabs() function has been deprecated. This function was used to generate and output the tabs navigation
  55   in gradebook which is now replaced with tertiary navigation.
  56 * There is a new callback inside of grade_get_plugin_info called extend_gradebook_plugininfo
  57   which allows for new tabs to be added to the gradebook.
  58
  59 === 3.7 ===
  60
  61 * The grade_cron() function has been removed. Please use grade_history_cleanup_task and grade_cron_task scheduled tasks instead.
  62
  63 === 3.6 ===
  64
  65 * The grade_plugin_return constructor now uses parameters from the
  66   request as defaults, which can be overridden by parameters supplied
  67   to the constructor. This may lead to a change in behaviour if only
  68   some of the possible parameters are supplied.
  69 * The grade_plugin_return class now tracks groupid as well as the
  70   type, plugin, courseid, userid and page parameters that were tracked
  71   previously. The groupid parameter will be set using
  72   groups_get_course_group for the relevant course if the group is
  73   otherwise unspecified.
  74 * The above changes mean that code using grade_plugin_return objects
  75   should generally no longer call groups_get_course_group directly,
  76   but should use the gpr->groupid parameter instead.
  77 * The grade_plugin_return constructor now accepts either course or
  78   courseid as a parameter to specify course.