Merge branch 'MDL-75910-311' of https://github.com/andrewnicols/moodle into MOODLE_31...
[moodle.git] / completion / upgrade.txt
blobedbc1ff7f1a4cd6c704c01860e45e8ebc3003717
1 This files describes API changes in /completion/* - completion,
2 information provided here is intended especially for developers.
4 === 3.11.4 ===
5 * The method \completion_criteria_completion::mark_complete() now has the optional $timecompleted parameter to specify when the
6   criteria was completed.
8 === 3.11 ===
9 * New Behat steps for activity completion in the behat_completion class:
10   - activity_completion_condition_displayed_as()
11     - Given the "<Completion condition>" completion condition of "<Activity name>" is displayed as "<Status>"
12   - activity_should_have_the_completion_condition()
13     - Given "<Activity name>" should have the "<Condition name>" completion condition
14   - manual_completion_button_displayed_as()
15     - Given the manual completion button of "<Activity name>" is displayed as "<Status>"
16   - the_manual_completion_button_for_activity_should_be_disabled()
17     - Given the manual completion button for "<Activity name>" should be disabled
18   - there_should_be_no_completion_for_activity()
19     - Given there should be no completion information shown for "<Activity name>"
20   - toggle_the_manual_completion_state()
21     - Given I toggle the manual completion state of "<Activity name>"
22   - overridden_manual_completion_button_displayed_as
23     - Given the manual completion button of "<Activity name>" overridden by "<User>" is displayed as "<Status>"
24   - overridden_activity_completion_condition_displayed_as
25     - Given the "<Completion condition>" completion condition of "<Activity name>" overridden by "<User>" is displayed as "<Status>"
26 * *_get_completion_state() callback functions have been deprecated and should no longer be used. Plugins that define custom
27   completion rules must implement the mod_[modname]\completion\custom_completion class that extends the
28   \core_completion\activity_custom_completion base class.
30 === 3.7 ===
31  * External function core_completion_external::get_activities_completion_status new returns the following additional field:
32    - valueused (indicates whether the completion state affects the availability of other content)
33  * On the course page, only users with the capability 'moodle/course:isincompletionreports' (students, by default) can now tick the
34    completion checkboxes. Teachers no longer get working checkboxes; tey see slightly different icons that indicate whether
35    completion is enabled for the activity. These are the same icons which have always been shown to teachers before when the
36    enabled the course editing mode.
38 === 2.9 ===
40 * A completed and failed activity counts as a completed activity for
41   course completion.