enrol/upgrade.txt

   1 This files describes API changes in /enrol/* - plugins,
   2 information provided here is intended especially for developers.
   3
   4 === 3.6 ===
   5
   6 * External function core_enrol_external::get_users_courses now return more information to avoid multiple queries to build the
   7   user dashboard:
   8   - displayname: Course display name for lists.
   9   - marker: Course section active marker.
  10   - completed: Whether the given user completed the course or not.
  11   - lastaccess: Last time the user accessed the course.
  12   - overviewfiles: Course overview files.
  13
  14 === 3.5 ===
  15
  16 * Default sorting in enrol_get_my_courses(), enrol_get_all_users_courses() and enrol_get_users_courses() now respects
  17   the site setting "navsortmycoursessort" and should be consistently used when displaying the courses in the UI.
  18
  19 === 3.4 ===
  20
  21 * render_course_enrolment_users_table method has been removed from the renderer. The enrolled users page is now
  22   combined with the participants page. /enrol/users.php no longer exists.
  23
  24 === 3.3 ===
  25
  26 * External function core_enrol_external::get_users_courses now return the user progress, start and the end course dates.
  27
  28 === 3.2 ===
  29
  30 * External function core_enrol_external::get_users_courses now return the category id as an additional optional field.
  31
  32 === 3.1 ===
  33
  34 * core_enrol_external::get_enrolled_users now supports two additional parameters for ordering: sortby and sortdirection.
  35 * Enrolment plugins UI have been consolidated. Plugins can implement use_standard_editing_ui() function
  36   and add edit_instance_form() and edit_instance_validation() methods instead of providing their own edit.php and form.
  37   They can then rely on the default implementation of get_action_icons and get_course_navigation. In future this will
  38   mean they can be called by webservices/user upload tools because they can validate their data.
  39
  40 === 3.0 ===
  41
  42 * Added new events enrol_instance_created, enrol_instance_updated and
  43   enrol_instance_deleted . Always trigger them when changing records in the
  44   DB table 'enrol'.
  45 * Constant CACHE_COURSE_CONTACTS_TTL was deleted.
  46 * External function core_enrol_external::get_enrolled_users now returns only the viewable participants if the course has groups enabled and no groupid is passed.
  47
  48 === 2.9 ===
  49
  50 * External function core_enrol_external::get_users_courses now returns additional optional fields:
  51    - summary: Course summary.
  52    - summaryformat: Course summary format.
  53    - format: Course format.
  54    - showgrades: True if grades are shown, otherwise false.
  55    - lang: Forced course language.
  56    - enablecompletion: Control or not via completion and activity settings.
  57
  58 === 2.8 ===
  59
  60 * enrol_plugin::instance_deleteable() is deprecated and has been replaced by enrol_plugin::can_delete_instance()
  61 * enrol_plugin::can_hide_show_instance() is a new function to control who can hide/show enrolment instances.
  62   Returns true by default but plugins must implement their own logic.
  63
  64 === 2.6 ===
  65
  66 * Enrolment plugin which supports self enrolment should implement can_self_enrol()
  67 * Enrolment plugin should implement get_enrol_info() to expose instance information
  68   with webservice or external interface.
  69 * Webservice core_enrol_get_enrolled_users_with_capability was incorrectly specifing
  70   float as the return type for user id. int is the actual returned type and is now
  71   reported as such.
  72
  73 === 2.5 ===
  74
  75 * plugins may use general enrol/editenrolment.php page to let users edit
  76   enrolments manually
  77 * new support for grade recovery in enrol_plugin::enrol_user() method
  78
  79 === 2.4 ===
  80
  81 required changes in code:
  82 * use role_get_name() or role_fix_names() if you need any role names, using role.name
  83   directly from database is not correct any more
  84 * new restore support: ENROL_RESTORE_EXACT, ENROL_RESTORE_NOUSERS
  85   and ENROL_RESTORE_CLASS were removed, implement new restore_* plugin methods instead
  86
  87 other changes and new features:
  88 * course enrolment manager now works with disabled plugins too
  89 * new support for protected group membership linked to enrol instance
  90 * new support for expiry notifications - see enrol_plugin::send_expiry_notifications() method
  91
  92
  93 === 2.2 ===
  94
  95 required changes in code:
  96 * load_temp_role() is deprecated, use load_temp_course_role() instead, temp role not loaded
  97 * remove_temp_role() is deprecated, use remove_temp_course_roles() instead
  98 * 'user_unenrol_modified' event was renamed to 'user_enrol_modified'
  99
 100
 101 === 2.0 ===
 102
 103 required changes in code:
 104 * enrolment plugins need to be rewritten to use new API - see inline phpdocs and official plugins