author | ymh <ymh.work@gmail.com> |
Tue, 27 Sep 2022 16:37:53 +0200 | |
changeset 19 | 3d72ae0968f4 |
parent 16 | a86126ab1dd4 |
child 22 | 8c2e4d02f4ef |
permissions | -rw-r--r-- |
0 | 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 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
25 |
* @deprecated 3.0.0 Use wp_set_current_user() |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
26 |
* @see wp_set_current_user() |
0 | 27 |
* |
28 |
* @param int|null $id User ID. |
|
29 |
* @param string $name Optional. The user's username |
|
5 | 30 |
* @return WP_User returns wp_set_current_user() |
0 | 31 |
*/ |
32 |
function set_current_user($id, $name = '') { |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
33 |
_deprecated_function( __FUNCTION__, '3.0.0', 'wp_set_current_user()' ); |
0 | 34 |
return wp_set_current_user($id, $name); |
35 |
} |
|
36 |
endif; |
|
37 |
||
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
38 |
if ( !function_exists('get_currentuserinfo') ) : |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
39 |
/** |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
40 |
* Populate global variables with information about the currently logged in user. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
41 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
42 |
* @since 0.71 |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
43 |
* @deprecated 4.5.0 Use wp_get_current_user() |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
44 |
* @see wp_get_current_user() |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
45 |
* |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
46 |
* @return bool|WP_User False on XMLRPC Request and invalid auth cookie, WP_User instance otherwise. |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
47 |
*/ |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
48 |
function get_currentuserinfo() { |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
49 |
_deprecated_function( __FUNCTION__, '4.5.0', 'wp_get_current_user()' ); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
50 |
|
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
51 |
return _wp_get_current_user(); |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
52 |
} |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
53 |
endif; |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
54 |
|
0 | 55 |
if ( !function_exists('get_userdatabylogin') ) : |
56 |
/** |
|
57 |
* Retrieve user info by login name. |
|
58 |
* |
|
59 |
* @since 0.71 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
60 |
* @deprecated 3.3.0 Use get_user_by() |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
61 |
* @see get_user_by() |
0 | 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) { |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
67 |
_deprecated_function( __FUNCTION__, '3.3.0', "get_user_by('login')" ); |
0 | 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 |
* |
|
5 | 76 |
* @since 2.5.0 |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
77 |
* @deprecated 3.3.0 Use get_user_by() |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
78 |
* @see get_user_by() |
0 | 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) { |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
84 |
_deprecated_function( __FUNCTION__, '3.3.0', "get_user_by('email')" ); |
0 | 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 |
* |
|
5 | 93 |
* @since 1.5.0 |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
94 |
* @deprecated 2.5.0 Use wp_set_auth_cookie() |
0 | 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) { |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
105 |
_deprecated_function( __FUNCTION__, '2.5.0', 'wp_set_auth_cookie()' ); |
0 | 106 |
$user = get_user_by('login', $username); |
107 |
wp_set_auth_cookie($user->ID, $remember); |
|
108 |
} |
|
109 |
else : |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
110 |
_deprecated_function( 'wp_setcookie', '2.5.0', 'wp_set_auth_cookie()' ); |
0 | 111 |
endif; |
112 |
||
113 |
if ( !function_exists('wp_clearcookie') ) : |
|
114 |
/** |
|
115 |
* Clears the authentication cookie, logging the user out. This function is deprecated. |
|
116 |
* |
|
5 | 117 |
* @since 1.5.0 |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
118 |
* @deprecated 2.5.0 Use wp_clear_auth_cookie() |
0 | 119 |
* @see wp_clear_auth_cookie() |
120 |
*/ |
|
121 |
function wp_clearcookie() { |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
122 |
_deprecated_function( __FUNCTION__, '2.5.0', 'wp_clear_auth_cookie()' ); |
0 | 123 |
wp_clear_auth_cookie(); |
124 |
} |
|
125 |
else : |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
126 |
_deprecated_function( 'wp_clearcookie', '2.5.0', 'wp_clear_auth_cookie()' ); |
0 | 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 |
|
5 | 137 |
* @deprecated 2.5.0 |
0 | 138 |
* |
139 |
* @return bool Always returns false |
|
140 |
*/ |
|
141 |
function wp_get_cookie_login() { |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
142 |
_deprecated_function( __FUNCTION__, '2.5.0' ); |
0 | 143 |
return false; |
144 |
} |
|
145 |
else : |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
146 |
_deprecated_function( 'wp_get_cookie_login', '2.5.0' ); |
0 | 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 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
161 |
* @deprecated 2.5.0 Use wp_signon() |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
162 |
* @see wp_signon() |
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
163 |
* |
0 | 164 |
* @global string $error Error when false is returned |
165 |
* |
|
5 | 166 |
* @param string $username User's username |
167 |
* @param string $password User's password |
|
168 |
* @param string $deprecated Not used |
|
16 | 169 |
* @return bool True on successful check, false on login failure. |
0 | 170 |
*/ |
171 |
function wp_login($username, $password, $deprecated = '') { |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
172 |
_deprecated_function( __FUNCTION__, '2.5.0', 'wp_signon()' ); |
0 | 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 : |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
184 |
_deprecated_function( 'wp_login', '2.5.0', 'wp_signon()' ); |
0 | 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 |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
195 |
* |
5 | 196 |
* @link https://wordpress.org/plugins/atom-publishing-protocol/ |
0 | 197 |
*/ |
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
198 |
if ( ! class_exists( 'wp_atom_server', false ) ) { |
0 | 199 |
class wp_atom_server { |
200 |
public function __call( $name, $arguments ) { |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
201 |
_deprecated_function( __CLASS__ . '::' . $name, '3.5.0', 'the Atom Publishing Protocol plugin' ); |
0 | 202 |
} |
203 |
||
204 |
public static function __callStatic( $name, $arguments ) { |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
205 |
_deprecated_function( __CLASS__ . '::' . $name, '3.5.0', 'the Atom Publishing Protocol plugin' ); |
0 | 206 |
} |
207 |
} |
|
7
cf61fcea0001
resynchronize code repo with production
ymh <ymh.work@gmail.com>
parents:
5
diff
changeset
|
208 |
} |