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