функция
Устаревший since 3.0.0
update_user_status()
Устаревшее.
Помечено устаревшим с версии 5.3.0.
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
update_user_status( int $id, string $pref, int $value, mixed $deprecated = null ): intОписание
Ранее использовалась в ядре для пометки пользователя как спама или «ham» (не спам) в режиме мультисайта.
См. alsowp_update_user()
Оригинал (английский)
Previously used in core to mark a user as spam or “ham” (not spam) in Multisite.
Параметры
$id
int
обязательный
Идентификатор пользователя.
$pref
string
обязательный
Столбец таблицы wp_users, в котором обновляется статус пользователя (предположительно user_status, spam или deleted).
$value
int
обязательный
Новый статус пользователя.
$deprecated
mixed
необязательный
= null
Не используется.
Возвращаемое значение
int
Исходный код
wp-includes/ms-deprecated.php:710
function update_user_status( $id, $pref, $value, $deprecated = null ) {
global $wpdb;
_deprecated_function( __FUNCTION__, '5.3.0', 'wp_update_user()' );
if ( null !== $deprecated ) {
_deprecated_argument( __FUNCTION__, '3.0.2' );
}
$wpdb->update( $wpdb->users, array( sanitize_key( $pref ) => $value ), array( 'ID' => $id ) );
$user = new WP_User( $id );
clean_user_cache( $user );
if ( 'spam' === $pref ) {
if ( $value == 1 ) {
/** This filter is documented in wp-includes/user.php */
do_action( 'make_spam_user', $id );
} else {
/** This filter is documented in wp-includes/user.php */
do_action( 'make_ham_user', $id );
}
}
return $value;
}История изменений
| Версия | Описание |
|---|---|
| 5.3.0 | Deprecated. Use wp_update_user() |
| 3.0.2 | Deprecated fourth argument. |
| 3.0.0 | Introduced. |
