Merge branch 'MDL-67062-master' of git://github.com/sarjona/moodle
[moodle.git] / badges / upgrade.txt
blobef6f89241fa2ed238167fafd0708eff5e707bea3
1 This files describes API changes in /badges/*,
2 information provided here is intended especially for developers.
3 === 3.7 ===
4 * BADGE_BACKPACKURL is deprecated and should not be used.
5 * Incorrect term "badge competencies" has been refactored to "alignments" everywhere.
7 === 3.6 ===
9 * The WebService core_badges_get_user_badges now returns more information for each badge: notification, nextcron, email, version, language, imageauthorname, imageauthoremail, imageauthorurl, imagecaption, endorsement, competencies and relatedbadges.
11 === 2.7 ===
13 * get_completed_criteria_sql() - This method was added to award_criteria class and must be overriden
14   in all criteria classes. This method returns an array consisting of SQL JOIN statement, WHERE conditions,
15   and any parameters that might be required. The results are used in lib/badgeslib.php in review_all_criteria()
16   to reduce to the minimum the number of users to review and award badges.
17 * New optional parameter $filtered in review() allows to indicate that some expensive checks can be skipped
18   if the list of users has been initially filtered based on met criteria.
19 * New optional parameter $archive in delete() in badge class in badgeslib.php
20   allows to indicate that a badge should be archived instead of fully deleted.
21   If this parameter is set to FALSE, a badge will all its information, criteria,
22   and awards will be removed from the database.
23 * BADGE_BACKPACKURL constant has been moved from badges/lib/backpacklib.php to lib/badgeslib.php, and URI scheme
24   name ('http://') has been removed.