MDL-38030 new core_user_get_users_by_field function deprecates core_u…

…ser_get_users_by_id
forouher · Apr 5, 2013 · 41f5285 · 41f5285
1 parent d8201d4
commit 41f5285
Show file tree

Hide file tree

Showing 2 changed files with 7 additions and 1 deletion.
diff --git a/lib/db/services.php b/lib/db/services.php
@@ -304,7 +304,7 @@
         'classname'   => 'core_user_external',
         'methodname'  => 'get_users_by_id',
         'classpath'   => 'user/externallib.php',
-        'description' => 'Get users by id.',
+        'description' => 'DEPRECATED: this deprecated function will be removed in a future version. This function has been replaced by core_user_get_users_by_field()',
         'type'        => 'read',
         'capabilities'=> 'moodle/user:viewdetails, moodle/user:viewhiddendetails, moodle/course:useremail, moodle/user:update',
     ),

diff --git a/user/externallib.php b/user/externallib.php
@@ -640,6 +640,8 @@ public static function get_users_returns() {
      *
      * @return external_function_parameters
      * @since Moodle 2.2
+     * @deprecated Moodle 2.5 MDL-38030 - Please do not call this function any more.
+     * @see core_user_external::get_users_by_field_parameters()
      */
     public static function get_users_by_id_parameters() {
         return new external_function_parameters(
@@ -658,6 +660,8 @@ public static function get_users_by_id_parameters() {
      * @param array $userids  array of user ids
      * @return array An array of arrays describing users
      * @since Moodle 2.2
+     * @deprecated Moodle 2.5 MDL-38030 - Please do not call this function any more.
+     * @see core_user_external::get_users_by_field()
      */
     public static function get_users_by_id($userids) {
         global $CFG, $USER, $DB;
@@ -708,6 +712,8 @@ public static function get_users_by_id($userids) {
      *
      * @return external_description
      * @since Moodle 2.2
+     * @deprecated Moodle 2.5 MDL-38030 - Please do not call this function any more.
+     * @see core_user_external::get_users_by_field_returns()
      */
     public static function get_users_by_id_returns() {
         $additionalfields = array (