wp-includes/pluggable-deprecated.php

   1 <?php
   2 /**
   3  * Deprecated pluggable functions from past WordPress versions. You shouldn't use these
   4  * functions and look for the alternatives instead. The functions will be removed in a
   5  * later version.
   6  *
   7  * Deprecated warnings are also thrown if one of these functions is being defined by a plugin.
   8  *
   9  * @package WordPress
  10  * @subpackage Deprecated
  11  * @see pluggable.php
  12  */
  13
  14 /*
  15  * Deprecated functions come here to die.
  16  */
  17
  18 if ( !function_exists('set_current_user') ) :
  19 /**
  20  * Changes the current user by ID or name.
  21  *
  22  * Set $id to null and specify a name if you do not know a user's ID.
  23  *
  24  * @since 2.0.1
  25  * @deprecated 3.0.0 Use wp_set_current_user()
  26  * @see wp_set_current_user()
  27  *
  28  * @param int|null $id User ID.
  29  * @param string $name Optional. The user's username
  30  * @return WP_User returns wp_set_current_user()
  31  */
  32 function set_current_user($id, $name = '') {
  33         _deprecated_function( __FUNCTION__, '3.0', 'wp_set_current_user()' );
  34         return wp_set_current_user($id, $name);
  35 }
  36 endif;
  37
  38 if ( !function_exists('get_currentuserinfo') ) :
  39 /**
  40  * Populate global variables with information about the currently logged in user.
  41  *
  42  * @since 0.71
  43  * @deprecated 4.5.0 Use wp_get_current_user()
  44  * @see wp_get_current_user()
  45  *
  46  * @return bool|WP_User False on XMLRPC Request and invalid auth cookie, WP_User instance otherwise.
  47  */
  48 function get_currentuserinfo() {
  49         _deprecated_function( __FUNCTION__, '4.5', 'wp_get_current_user()' );
  50
  51         return _wp_get_current_user();
  52 }
  53 endif;
  54
  55 if ( !function_exists('get_userdatabylogin') ) :
  56 /**
  57  * Retrieve user info by login name.
  58  *
  59  * @since 0.71
  60  * @deprecated 3.3.0 Use get_user_by()
  61  * @see get_user_by()
  62  *
  63  * @param string $user_login User's username
  64  * @return bool|object False on failure, User DB row object
  65  */
  66 function get_userdatabylogin($user_login) {
  67         _deprecated_function( __FUNCTION__, '3.3', "get_user_by('login')" );
  68         return get_user_by('login', $user_login);
  69 }
  70 endif;
  71
  72 if ( !function_exists('get_user_by_email') ) :
  73 /**
  74  * Retrieve user info by email.
  75  *
  76  * @since 2.5.0
  77  * @deprecated 3.3.0 Use get_user_by()
  78  * @see get_user_by()
  79  *
  80  * @param string $email User's email address
  81  * @return bool|object False on failure, User DB row object
  82  */
  83 function get_user_by_email($email) {
  84         _deprecated_function( __FUNCTION__, '3.3', "get_user_by('email')" );
  85         return get_user_by('email', $email);
  86 }
  87 endif;
  88
  89 if ( !function_exists('wp_setcookie') ) :
  90 /**
  91  * Sets a cookie for a user who just logged in. This function is deprecated.
  92  *
  93  * @since 1.5.0
  94  * @deprecated 2.5.0 Use wp_set_auth_cookie()
  95  * @see wp_set_auth_cookie()
  96  *
  97  * @param string $username The user's username
  98  * @param string $password Optional. The user's password
  99  * @param bool $already_md5 Optional. Whether the password has already been through MD5
 100  * @param string $home Optional. Will be used instead of COOKIEPATH if set
 101  * @param string $siteurl Optional. Will be used instead of SITECOOKIEPATH if set
 102  * @param bool $remember Optional. Remember that the user is logged in
 103  */
 104 function wp_setcookie($username, $password = '', $already_md5 = false, $home = '', $siteurl = '', $remember = false) {
 105         _deprecated_function( __FUNCTION__, '2.5', 'wp_set_auth_cookie()' );
 106         $user = get_user_by('login', $username);
 107         wp_set_auth_cookie($user->ID, $remember);
 108 }
 109 else :
 110         _deprecated_function( 'wp_setcookie', '2.5', 'wp_set_auth_cookie()' );
 111 endif;
 112
 113 if ( !function_exists('wp_clearcookie') ) :
 114 /**
 115  * Clears the authentication cookie, logging the user out. This function is deprecated.
 116  *
 117  * @since 1.5.0
 118  * @deprecated 2.5.0 Use wp_clear_auth_cookie()
 119  * @see wp_clear_auth_cookie()
 120  */
 121 function wp_clearcookie() {
 122         _deprecated_function( __FUNCTION__, '2.5', 'wp_clear_auth_cookie()' );
 123         wp_clear_auth_cookie();
 124 }
 125 else :
 126         _deprecated_function( 'wp_clearcookie', '2.5', 'wp_clear_auth_cookie()' );
 127 endif;
 128
 129 if ( !function_exists('wp_get_cookie_login') ):
 130 /**
 131  * Gets the user cookie login. This function is deprecated.
 132  *
 133  * This function is deprecated and should no longer be extended as it won't be
 134  * used anywhere in WordPress. Also, plugins shouldn't use it either.
 135  *
 136  * @since 2.0.3
 137  * @deprecated 2.5.0
 138  *
 139  * @return bool Always returns false
 140  */
 141 function wp_get_cookie_login() {
 142         _deprecated_function( __FUNCTION__, '2.5' );
 143         return false;
 144 }
 145 else :
 146         _deprecated_function( 'wp_get_cookie_login', '2.5' );
 147 endif;
 148
 149 if ( !function_exists('wp_login') ) :
 150 /**
 151  * Checks a users login information and logs them in if it checks out. This function is deprecated.
 152  *
 153  * Use the global $error to get the reason why the login failed. If the username
 154  * is blank, no error will be set, so assume blank username on that case.
 155  *
 156  * Plugins extending this function should also provide the global $error and set
 157  * what the error is, so that those checking the global for why there was a
 158  * failure can utilize it later.
 159  *
 160  * @since 1.2.2
 161  * @deprecated 2.5.0 Use wp_signon()
 162  * @see wp_signon()
 163  *
 164  * @global string $error Error when false is returned
 165  *
 166  * @param string $username   User's username
 167  * @param string $password   User's password
 168  * @param string $deprecated Not used
 169  * @return bool False on login failure, true on successful check
 170  */
 171 function wp_login($username, $password, $deprecated = '') {
 172         _deprecated_function( __FUNCTION__, '2.5', 'wp_signon()' );
 173         global $error;
 174
 175         $user = wp_authenticate($username, $password);
 176
 177         if ( ! is_wp_error($user) )
 178                 return true;
 179
 180         $error = $user->get_error_message();
 181         return false;
 182 }
 183 else :
 184         _deprecated_function( 'wp_login', '2.5', 'wp_signon()' );
 185 endif;
 186
 187 /**
 188  * WordPress AtomPub API implementation.
 189  *
 190  * Originally stored in wp-app.php, and later wp-includes/class-wp-atom-server.php.
 191  * It is kept here in case a plugin directly referred to the class.
 192  *
 193  * @since 2.2.0
 194  * @deprecated 3.5.0
 195  *
 196  * @link https://wordpress.org/plugins/atom-publishing-protocol/
 197  */
 198 if ( ! class_exists( 'wp_atom_server', false ) ) {
 199         class wp_atom_server {
 200                 public function __call( $name, $arguments ) {
 201                         _deprecated_function( __CLASS__ . '::' . $name, '3.5', 'the Atom Publishing Protocol plugin' );
 202                 }
 203
 204                 public static function __callStatic( $name, $arguments ) {
 205                         _deprecated_function( __CLASS__ . '::' . $name, '3.5', 'the Atom Publishing Protocol plugin' );
 206                 }
 207         }
 208 }