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
  14 === 4.3 ===
  15 * The $showtitle parameter in the print_grade_page_head function located inside grade/lib.php has been deprecated and is not used anymore.
  16 * The deprecated `core_grades_create_gradecategory` external method has been removed, in addition to the accompanying
  17   `core_grades_external::create_gradecategory` methods
  18 * User, Group & Grade item JS classes have been added to easily enable the creation of combobox search components.
  19   Refer to the dev docs on details of how to implement this feature if desired.
  20 * basewidget.js has been deprecated and its uses replaced with the new JS classes mentioned above.
  21 * With the basewidget being deprecated all usages of it in core have now been migrated and the files that used it removed.
  22   The basewidget itself will go through the proper deprecation process and be removed in a future version.
  23 * The following webservices have had some optional parameters changed:
  24   - grade/classes/external/get_enrolled_users_for_selector
  25     - profileimage -> profileimageurl & profileimageurlsmall
  26     - return changed to use the core_user_external::user_description() method instead of a custom baked one.
  27   - grade/classes/external/get_groups_for_selector
  28     - Has been relocated to core_group_external::get_groups_for_selector()
  29     - groupimageurl is now available as an optional parameter to give the user an image either set or generated for the group.
  30 * The grade `itemname` property contained in the return structure of the following external methods is now PARAM_CLEANHTML:
  31   - `core_grades_get_gradeitems`
  32   - `gradereport_user_get_grade_items`
  33 * The grade_helper::get_lang_string() function has been deprecated. Please use get_string() instead.
  34
  35 === 4.1 ===
  36 * The $importactiveurl parameter in the constructor of the core_grades\output\import_action_bar class has been deprecated and is not used anymore.
  37 * The $exportactiveurl parameter in the constructor of the core_grades\output\export_action_bar class has been deprecated and is not used anymore.
  38 * The select_in_gradebook_navigation_selector() function in behat_grade.php has been deprecated. Please use
  39   behat_forms::i_set_the_field_to() instead.
  40
  41 === 4.0 ===
  42
  43 * The select_in_gradebook_tabs() function in behat_grade.php has been deprecated. Please use the function
  44   select_in_gradebook_navigation_selector() instead.
  45 * The setting $CFG->grade_navmethod setting has been completely removed because it's not required anymore. This setting
  46   was used to set the type of navigation (tabs or dropdown box) used in gradebook which is now replaced with tertiary
  47   navigation.
  48 * The print_grade_plugin_selector() function has been deprecated. This function was used to generate and output the
  49   dropdown box navigation in gradebook which is now replaced with tertiary navigation.
  50 * The grade_print_tabs() function has been deprecated. This function was used to generate and output the tabs navigation
  51   in gradebook which is now replaced with tertiary navigation.
  52 * There is a new callback inside of grade_get_plugin_info called extend_gradebook_plugininfo
  53   which allows for new tabs to be added to the gradebook.
  54
  55 === 3.7 ===
  56
  57 * The grade_cron() function has been removed. Please use grade_history_cleanup_task and grade_cron_task scheduled tasks instead.
  58
  59 === 3.6 ===
  60
  61 * The grade_plugin_return constructor now uses parameters from the
  62   request as defaults, which can be overridden by parameters supplied
  63   to the constructor. This may lead to a change in behaviour if only
  64   some of the possible parameters are supplied.
  65 * The grade_plugin_return class now tracks groupid as well as the
  66   type, plugin, courseid, userid and page parameters that were tracked
  67   previously. The groupid parameter will be set using
  68   groups_get_course_group for the relevant course if the group is
  69   otherwise unspecified.
  70 * The above changes mean that code using grade_plugin_return objects
  71   should generally no longer call groups_get_course_group directly,
  72   but should use the gpr->groupid parameter instead.
  73 * The grade_plugin_return constructor now accepts either course or
  74   courseid as a parameter to specify course.