badges/upgrade.txt

   1 This files describes API changes in /badges/*,
   2 information provided here is intended especially for developers.
   3
   4 === 4.3 ===
   5 * The following, deprecated since 3.11, have been removed and can no longer be used:
   6  - `badges/ajax.js`
   7  - `badges_check_backpack_accessibility`
   8  - `badges_setup_backpack_js`
   9  - `badges_local_backpack_js`
  10
  11 === 4.0 ===
  12 * Function print_badge_tabs has been deprecated in favour of manage_badge_action_bar instead
  13
  14 === 3.11 ===
  15 * $CFG->badges_site_backpack setting has been completely removed because it's not required anymore. From now, the primary
  16 site backpack will be the first one in the "Manage backpacks" list (so, the one with lower sortorder value).
  17 * Final deprecation for:
  18  - BADGE_BACKPACKURL constant has been removed.
  19  - badges/backpack.js file has been removed.
  20 * The following methods have been deprecated:
  21  - badges_check_backpack_accessibility()
  22  - badges_setup_backpack_js()
  23  - badges_local_backpack_js()
  24
  25 === 3.10 ===
  26 * Users can now specify a backpack that differs from the site backpack. In order to do this, connection details need to
  27 be set in 'Manage backpacks' with OR without auth details.
  28 * Introduced new functions in backpack_api
  29 ** 'import_badge_assertion' to facilitate cross domain badge imports.
  30 ** 'update_assertion' updates a previously defined/created assertion.
  31 * New badge lib functions introduced
  32 ** badges_save_external_backpack() - This method handles inserts/updates to the site wide backpacks' configuration details.
  33 ** badges_save_backpack_credentials() - This method handles inserts/updates any authentication details to connect to the backpacks created. This can either be site OR user backpack authentication details
  34 ** badges_get_user_backpack() - Gets a specific user's backpack. Defaults to current user's backpack if none provided.
  35 ** badges_get_site_primary_backpack() - Get the primary backpack set for the site as defined in $CFG->badges_site_backpack
  36 * badges_open_badges_backpack_api() - Now accepts a backpackid(badge_external_backpack id) to check whether the version of the provided backpack.
  37   This was introduced because now there is a difference between a site and user backpack. If null, defaults to site_backpack.
  38 * badges_get_site_backpack() - Accepts an additional $userid param if we want to get a specific user's backpack. Defaults to 0 if we are trying to get the site/admin level backpack
  39 * badges_external_get_mapping() - Accepts an additional argument to indicate which value it wants returned. Defaults to 'externalid' which contains the OBv2 badge URL
  40
  41 === 3.9 ===
  42 * BADGE_BACKPACKAPIURL and BADGE_BACKPACKWEBURL are deprecated and should not be used.
  43 * OBv2 has been set to the default value when the obversion is not defined.
  44
  45 === 3.7 ===
  46 * BADGE_BACKPACKURL is deprecated and should not be used.
  47 * Incorrect term "badge competencies" has been refactored to "alignments" everywhere.
  48
  49 === 3.6 ===
  50
  51 * 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.
  52
  53 === 2.7 ===
  54
  55 * get_completed_criteria_sql() - This method was added to award_criteria class and must be overriden
  56   in all criteria classes. This method returns an array consisting of SQL JOIN statement, WHERE conditions,
  57   and any parameters that might be required. The results are used in lib/badgeslib.php in review_all_criteria()
  58   to reduce to the minimum the number of users to review and award badges.
  59 * New optional parameter $filtered in review() allows to indicate that some expensive checks can be skipped
  60   if the list of users has been initially filtered based on met criteria.
  61 * New optional parameter $archive in delete() in badge class in badgeslib.php
  62   allows to indicate that a badge should be archived instead of fully deleted.
  63   If this parameter is set to FALSE, a badge will all its information, criteria,
  64   and awards will be removed from the database.
  65 * BADGE_BACKPACKURL constant has been moved from badges/lib/backpacklib.php to lib/badgeslib.php, and URI scheme
  66   name ('http://') has been removed.