Merge branch 'MDL-69251-311' of https://github.com/snake/moodle into MOODLE_311_STABLE
[moodle.git] / availability / upgrade.txt
blobf3e06c3128f89e22237cbc36c99dd3f43d1230af
1 This files describes API changes in /availability/*.
3 The information here is intended only for developers.
5 === 3.11.4 ===
7 * There were existing restrictions on what condition plugins can do in the get_description
8   method (for example they mustn't call format_string), which were not well documented.
9   New functions description_cm_name(), description_format_string(), description_callback()
10   can be used so that condition plugins to behave correctly in all situations.
12 === 3.2 ===
14 * Condition plugins must replace the CSS selector "#fitem_id_availabilityconditionsjson" with ".availability-field".
15   This selector is often used in your plugin's yui/src/form/js/form.js file.
17 === 2.9 ===
19 * Condition plugins can now implement a new include_after_restore function to
20   indicate that they should be removed during the restore process. (This is
21   implemented so that group and grouping conditions are removed if groups are
22   not restored.)
24 === 2.8 ===
26 * There is a new API function in the info_module/info_section objects (and
27   related functions in internal API): get_user_list_sql. This returns SQL code
28   that does roughly the same as filter_user_list to return a list of users who
29   should be shown as having access to the module or section.
31 * Any third-party availability plugins which return true to
32   is_applied_to_user_lists (and therefore previously implemented
33   filter_user_list) should now also implement get_user_list_sql. If not
34   implemented, a debugging warning will occur when anybody calls
35   get_user_list_sql if the affected plugin is in use, and that user list will
36   not be filtered by the plugin.