Merge branch 'MDL-66115_37' of https://github.com/dvdcastro/moodle into MOODLE_37_STABLE
[moodle.git] / calendar / upgrade.txt
blob48b9ac2b0eda773c8e72b4cbc5e8f409541ba85d
1 This files describes API changes in /calendar/* ,
2 information provided here is intended especially for developers.
4 === 3.6 ===
5 * calendar_get_default_courses() function now has optional $userid parameter.
6 * calendar_set_filters() function now has optional $user parameter.
7 * The core_calendar\local\event\container class now provides two new helper methods for getting and setting the requesting user:
8   set_requesting_user() and get_requesting_user().
9 * The following functions have been finally deprecated and can not be used anymore:
10   * calendar_preferences_button()
11 * added core_calendar_get_valid_event_timestart_range callback for course events when the update_event_start_day function is used
12   in the local api.
14 === 3.5 ===
15 * core_calendar_external::get_calendar_events now returns the categoryid for category events.
17 === 3.4 ===
18 * calendar_get_mini, and calendar_get_upcoming have been deprecated. Please update to use the new exporters and renderers.
19 * added core_calendar_get_valid_event_timestart_range and core_calendar_event_timestart_updated callbacks for module events
20   when the update_event_start_day function is used in the local api.
22 === 3.3 ===
23 * calendar_event_hook() has been removed. Developers should be using the Moodle events system to achieve this behaviour,
24   rather than using a hacky calendar specific implementation.
25 * calendar_wday_name() is deprecated and no longer used in core.
26 * calendar_get_block_upcoming() is deprecated, please use block_calendar_upcoming::get_upcoming_content() instead.
27 * calendar_print_month_selector() is deprecated and no longer used in core.
28 * calendar_cron() is deprecated and should not be used. Please use the core\task\calendar_cron_task instead.
30 === 3.2 ===
31 * calendar_preferences_button() is now deprecated. Calendar preferences have been moved to the user preferences page.
33 === 2.9 ===
34 default values changes in code:
35 * core_calendar_external::get_calendar_events_parameters() 'timeend' default option changed; now, by default,
36   all events are returned, not only the past ones.
37 * calendar types need to be updated to be compatible with standard PHP date/time code
39 === 2.5 ===
40 required changes in code:
41 * calendar_add_icalendar_event() now requires a valid subscriptionid
42 * calendar_process_subscription_row() throws exception for invalid subscriptionid
43 * calendar_update_subscription_events() now throws a dml_exception instead of moodle_exception for bad subscriptions
44 * calendar_get_mini() function now has optional $placement and $courseid paramaters.
46 optional - no changes needed:
47 * calendar_update_subscription() should now be used to update Ical subscriptions.
49 === 2.4 ===
51 required changes in code:
53 * calendar_get_popup() function now just returns id, instead of the string "id=$id"