update_user_status() WP 3.0.0

Обновляет статус пользователя в базе данных. Для мультисайтов.

Используется в ядре, в режиме мультисайт, чтобы поместить пользователя в спам: ставиться метка spam или ham.

Возвращает

Число. Переданное в $value значение.

Использование

update_user_status( $id, $pref, $value, $deprecated );

$id(число) (обязательный)

ID пользователя.

$pref(строка) (обязательный)

Колонка в таблице wp_users для обновления статуса пользователя (предположительно user_status, spam, or deleted).

$value(число) (обязательный)

Новый статус пользователя.

$deprecated(null)

Устарел с версии 3.0.2.
По умолчанию: null

Примеры

#1 Переместить пользователя в спам (spam)

Работает только для мультисайтов.

$user_id = 394;

update_user_status( $user_id, 'spam', 1 );

#2 Переместить пользователя как "ham"

$user_id = 394;

update_user_status( $user_id, 'spam', 0 );

Заметки

• Global. wpdb. $wpdb WordPress database abstraction object.

Список изменений

Код update user status: wp-admin/includes/ms.php ^{WP 5.2.4}

<?php
function update_user_status( $id, $pref, $value, $deprecated = null ) {
	global $wpdb;

	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 ( $pref == 'spam' ) {
		if ( $value == 1 ) {
			/**
			 * Fires after the user is marked as a SPAM user.
			 *
			 * @since 3.0.0
			 *
			 * @param int $id ID of the user marked as SPAM.
			 */
			do_action( 'make_spam_user', $id );
		} else {
			/**
			 * Fires after the user is marked as a HAM user. Opposite of SPAM.
			 *
			 * @since 3.0.0
			 *
			 * @param int $id ID of the user marked as HAM.
			 */
			do_action( 'make_ham_user', $id );
		}
	}

	return $value;
}

Cвязанные функции

Из метки: statuses (статус записи коммента юзера)

Еще из метки: Пользователи (_user)

Еще из раздела: Мультисайт