WP_User

Методы

add_cap()

Метод add_cap() класса WP_User используется для добавления возможности (capability) пользователю и предоставления или отказа в доступе к этой возможности. Возможности в WordPress используются для определения различных уровней доступа и прав пользователей.

WP_User::add_cap( string $cap, bool $grant = true )

Метод add_cap() принимает два параметра: $cap — обязательный, строка, название возможности, и $grant — необязательный, логическое значение, указывающее, предоставить ли возможность пользователю (по умолчанию — true).

$cap — обязательный. Название возможности, которую необходимо добавить пользователю.

$grant — необязательный. Логическое значение, указывающее, предоставить ли возможность пользователю. По умолчанию установлено значение true, что означает предоставление возможности пользователю.

/**
 * Добавление возможности "edit_posts" пользователю с ID 5.
 * Предоставление доступа к возможности.
 */
$user = new WP_User( 5 );
$user->add_cap( 'edit_posts' );

В приведенном выше примере кода мы создаем объект WP_User для пользователя с ID 5 и добавляем ему возможность «edit_posts». Параметр $grant не указан, поэтому по умолчанию пользователю будет предоставлен доступ к возможности.

add_role()

Метод add_role() класса WP_User используется для добавления роли пользователю в WordPress.

Роли в WordPress определяют уровень доступа и права пользователя. При создании нового пользователя, ему автоматически присваивается роль «Subscriber». С помощью метода add_role() можно добавить пользователю дополнительные роли, которые позволят ему иметь больше или меньше прав, чем у обычного подписчика.

WP_User::add_role( string $role )

Метод add_role() принимает один обязательный параметр:

• $role (строка) — Название роли, которую нужно добавить пользователю.

$role (строка) — Обязательный параметр. Название роли, которую нужно добавить пользователю.

<?php
/**
 * Пример кода для добавления роли пользователю.
 *
 * @param string $role Название роли.
 */
$user = new WP_User( $user_id ); // Создаем объект WP_User для пользователя с указанным ID.
$user->add_role( 'editor' ); // Добавляем роль "Редактор" пользователю.
?>

exists()

Метод exists() класса WP_User используется для определения, существует ли пользователь в базе данных WordPress.

Метод проверяет, есть ли запись о пользователе в таблице wp_users базы данных. Если запись существует, метод возвращает значение true, в противном случае — false.

WP_User::exists(): bool

Метод exists() вызывается статически, без создания экземпляра класса WP_User. Он возвращает булево значение true или false.

Пример использования:

$user_exists = WP_User::exists();

В данном примере переменной $user_exists будет присвоено значение true или false в зависимости от того, существует ли пользователь в базе данных.

Метод exists() возвращает булево значение:

• true — если пользователь существует в базе данных
• false — если пользователь не существует в базе данных

for_blog()

Метод for_blog() класса WP_User устанавливает сайт, на котором будет выполняться операция. По умолчанию используется текущий сайт. Warning: This method has been deprecated. Use WP_User::for_site() instead.

WP_User::for_blog( int $blog_id = '' )

Метод for_blog() принимает один необязательный параметр $blog_id, который указывает идентификатор сайта. По умолчанию используется текущий сайт.

$blog_id int: Необязательный идентификатор сайта. По умолчанию используется текущий сайт.

<code>$user = new WP_User( $user_id );</code>
<code>$user->for_blog( $blog_id );</code>

В приведенном выше примере создается объект WP_User с указанным идентификатором пользователя $user_id. Затем вызывается метод for_blog(), чтобы установить сайт, на котором будет выполняться операция, используя идентификатор сайта $blog_id.

for_site()

Метод for_site() класса WP_User устанавливает сайт, на котором будет выполняться операция. По умолчанию используется текущий сайт.

WP_User::for_site( int $site_id = '' )

Метод for_site() принимает один необязательный параметр:

• $site_id (int) — Идентификатор сайта, для которого нужно инициализировать возможности пользователя. По умолчанию используется текущий сайт.

/**
 * Устанавливает сайт для пользователя.
 *
 * @param int $site_id Идентификатор сайта.
 */
$user = new WP_User( $user_id );
$user->for_site( $site_id );

В приведенном выше примере кода мы создаем новый объект класса WP_User с помощью идентификатора пользователя $user_id. Затем мы используем метод for_site(), чтобы установить сайт для этого пользователя с помощью идентификатора сайта $site_id.

get()

Метод get() класса WP_User используется для получения значения свойства или мета-ключа пользователя.

WP_User::get( string $key ): mixed

Метод get() принимает один обязательный параметр — $key, который представляет собой строку и является идентификатором свойства или мета-ключа, значение которого нужно получить.

$key (string) — Обязательный. Идентификатор свойства или мета-ключа, значение которого нужно получить.

Метод get() возвращает значение свойства или мета-ключа пользователя. Тип возвращаемого значения может быть различным в зависимости от конкретного свойства или мета-ключа.

<?php
// Получение значения свойства "display_name" для текущего пользователя
$user = wp_get_current_user();
$display_name = $user->get( 'display_name' );
// Получение значения мета-ключа "phone_number" для текущего пользователя
$phone_number = $user->get( 'phone_number' );
?>

В приведенном примере кода мы используем метод get() для получения значения свойства «display_name» и мета-ключа «phone_number» для текущего пользователя. Значение свойства «display_name» будет присвоено переменной $display_name, а значение мета-ключа «phone_number» — переменной $phone_number.

get_caps_data()

Метод get_caps_data() класса WP_User используется для получения доступных данных о возможностях пользователя.

WP_User::get_caps_data()

Метод get_caps_data() вызывается статически, то есть без создания экземпляра класса WP_User. Он возвращает массив данных о возможностях пользователя.

Метод get_caps_data() возвращает массив данных о возможностях пользователя, где каждая возможность представлена в виде ключа, а значение указывает, имеет ли пользователь данную возможность. Например:

array(
    'edit_posts' => true,
    'delete_posts' => false
)

В данном примере пользователь имеет возможность редактировать записи, но не имеет возможности удалять их.

get_data_by()

Метод get_data_by() класса WP_User используется для получения данных пользователя по указанному полю и его значению. Он возвращает только основные поля пользователя.

WP_User::get_data_by( string $field, string|int $value ): object|false

Метод get_data_by() принимает два обязательных параметра: $field и $value. Параметр $field указывает поле, по которому будет выполнен поиск: ‘id’, ‘ID’, ‘slug’, ’email’ или ‘login’. Параметр $value содержит значение поля, по которому будет выполнен поиск.

$field (string) (обязательный): Поле для выполнения запроса: ‘id’, ‘ID’, ‘slug’, ’email’ или ‘login’.

$value (string|int) (обязательный): Значение поля.

Метод get_data_by() возвращает объект пользователя или false, если пользователь не найден.

<?php
/**
 * Пример использования метода get_data_by()
 *
 * Получение данных пользователя по его ID.
 */
$user = WP_User::get_data_by( 'id', 123 );
if ( $user ) {
    // Данные пользователя
    $user_id   = $user->ID;
    $user_name = $user->user_login;
    $user_email = $user->user_email;
} else {
    // Пользователь не найден
    echo 'Пользователь не найден';
}
?>

В этом примере мы используем метод get_data_by() для получения данных пользователя по его ID. Если пользователь найден, мы сохраняем его ID, логин и email в соответствующих переменных. Если пользователь не найден, выводится сообщение «Пользователь не найден».

get_role_caps()

Метод get_role_caps() класса WP_User используется для получения всех возможностей (capabilities) ролей пользователя и их объединения с индивидуальными возможностями пользователя.

Данный метод возвращает массив, где ключи представляют собой название возможности (capability), а булевые значения указывают, имеет ли пользователь эту возможность.

WP_User::get_role_caps();

Метод get_role_caps() вызывается статически, без создания экземпляра класса WP_User. Он возвращает массив возможностей пользователя.

Примечание: В данном коде необходимо заменить WP_User на имя объекта класса WP_User, с которым вы работаете.

Метод get_role_caps() возвращает массив, где ключи представляют собой название возможности (capability), а булевые значения указывают, имеет ли пользователь эту возможность.

get_site_id()

Метод get_site_id() класса WP_User возвращает идентификатор сайта, для которого в данный момент инициализированы возможности пользователя.

WP_User::get_site_id()

Метод get_site_id() вызывается статически, то есть без создания экземпляра класса WP_User. Он возвращает идентификатор сайта в виде целого числа.

Метод get_site_id() возвращает идентификатор сайта в виде целого числа (int). Этот идентификатор представляет собой уникальный номер сайта в системе WordPress.

has_cap()

Метод has_cap() класса WP_User используется для проверки, обладает ли пользователь указанной возможностью (capability).

WP_User::has_cap( string $cap, mixed $args ): bool

$cap (обязательный): Название возможности (capability).

$args (необязательный): Дополнительные параметры, обычно начинающиеся с идентификатора объекта.

Метод has_cap() возвращает значение типа bool: true, если пользователь обладает указанной возможностью, или false, если пользователь не обладает указанной возможностью. Если передан идентификатор объекта, метод возвращает true, если пользователь обладает указанной возможностью для этого объекта, или false, если пользователь не обладает указанной возможностью для этого объекта.

<?php
/**
 * Проверяет, обладает ли текущий пользователь возможностью 'edit_posts'
 * для объекта с идентификатором 123.
 *
 * @param string $cap Название возможности (capability).
 * @param mixed $args Дополнительные параметры, обычно начинающиеся с идентификатора объекта.
 *
 * @return bool Возвращает true, если пользователь обладает указанной возможностью для объекта,
 *              или false, если пользователь не обладает указанной возможностью для объекта.
 */
$user_can_edit = WP_User::has_cap( 'edit_posts', 123 );
?>

has_prop()

Метод has_prop() класса WP_User используется для определения, установлено ли свойство или мета-ключ.

WP_User::has_prop( string $key ): bool

Метод has_prop() принимает один обязательный параметр:

• $key (string) — Свойство или мета-ключ, которое нужно проверить.

Метод возвращает логическое значение true, если свойство или мета-ключ установлены, и false в противном случае.

<?php
// Создаем объект WP_User
$user = new WP_User( $user_id );
// Проверяем, установлено ли свойство "first_name"
if ( $user->has_prop( 'first_name' ) ) {
    echo 'Свойство "first_name" установлено.';
} else {
    echo 'Свойство "first_name" не установлено.';
}
?>

В приведенном выше примере мы создаем объект WP_User с помощью идентификатора пользователя $user_id. Затем мы используем метод has_prop(), чтобы проверить, установлено ли свойство «first_name» для данного пользователя. Если свойство установлено, выводится сообщение «Свойство ‘first_name’ установлено». В противном случае выводится сообщение «Свойство ‘first_name’ не установлено».

init()

Метод init() класса WP_User используется для установки свойств объекта, включая его возможности (capabilities).

WP_User::init( object $data, int $site_id = '' )

Метод init() принимает два параметра: $data (обязательный) и $site_id (необязательный).

• $data (обязательный) — Объект строки пользователя в базе данных.
• $site_id (необязательный) — Идентификатор сайта для инициализации. По умолчанию: пустая строка.

/**
 * Пример использования метода init().
 *
 * @param object $data     Объект строки пользователя в базе данных.
 * @param int    $site_id  Идентификатор сайта для инициализации. По умолчанию: пустая строка.
 */
$user_data = get_userdata( $user_id );
$user = new WP_User;
$user->init( $user_data );

level_reduction()

Метод level_reduction() класса WP_User используется для выбора максимального уровня, который имеет пользователь.

WP_User::level_reduction( int $max, string $item ): int

Метод level_reduction() принимает два обязательных параметра: $max (максимальный уровень пользователя) и $item (название возможности уровня). Возвращает целое число.

$max (тип: int, обязательный) — Максимальный уровень пользователя.

$item (тип: string, обязательный) — Название возможности уровня.

Метод level_reduction() возвращает максимальный уровень (тип: int).

<?php
/**
 * Пример использования метода level_reduction()
 *
 * @param int    $max  Максимальный уровень пользователя.
 * @param string $item Название возможности уровня.
 *
 * @return int Максимальный уровень.
 */
$level = WP_User::level_reduction( $max, $item );
?>

remove_all_caps()

Метод remove_all_caps() класса WP_User используется для удаления всех возможностей (capabilities) у пользователя.

Метод удаляет все возможности, присвоенные пользователю, и возвращает его к базовому уровню без каких-либо дополнительных прав.

WP_User::remove_all_caps();

Вызов метода remove_all_caps() без аргументов применяется к текущему пользователю и удаляет все его возможности.

Метод не принимает никаких аргументов и не возвращает значения.

remove_cap()

Метод remove_cap() класса WP_User используется для удаления возможности (capability) у пользователя.

WP_User::remove_cap( string $cap )

Метод remove_cap() принимает один обязательный параметр:

• $cap (строка) — Название возможности, которую необходимо удалить.

<?php
/**
 * Удаление возможности 'edit_posts' у пользователя с ID 5.
 */
$user_id = 5;
$capability = 'edit_posts';
$user = new WP_User( $user_id );
$user->remove_cap( $capability );
?>

В приведенном выше примере кода мы создаем объект WP_User для пользователя с ID 5. Затем мы используем метод remove_cap() для удаления возможности ‘edit_posts’ у этого пользователя.

Метод remove_cap() полезен, когда необходимо удалить определенные возможности у пользователя, чтобы ограничить его доступ к определенным функциям или действиям в WordPress.

remove_role()

Метод remove_role() класса WP_User используется для удаления роли пользователя.

Роль пользователя представляет собой набор разрешений, определяющих, какие действия пользователь может выполнять на сайте WordPress. Каждый пользователь может иметь одну или несколько ролей.

Метод remove_role() удаляет указанную роль у пользователя. После удаления роли, пользователь теряет все разрешения, связанные с этой ролью.

WP_User::remove_role( string $role )

Метод remove_role() принимает один обязательный параметр:

• $role (string) — Название роли, которую нужно удалить у пользователя.

Пример использования:

$user = new WP_User( $user_id ); // Создание объекта WP_User для пользователя с указанным ID
$user->remove_role( 'editor' ); // Удаление роли 'editor' у пользователя

Метод remove_role() принимает следующий параметр:

• $role (string) — Обязательный параметр. Название роли, которую нужно удалить у пользователя.

Параметр $role должен быть строкой, содержащей название роли, которую нужно удалить у пользователя.

/**
 * Удаление роли 'editor' у пользователя с ID 123.
 *
 * @param string $role Название роли.
 */
$user = new WP_User( 123 ); // Создание объекта WP_User для пользователя с ID 123
$user->remove_role( 'editor' ); // Удаление роли 'editor' у пользователя

set_role()

Метод set_role() класса WP_User используется для установки роли пользователя в WordPress. Он позволяет изменить роль пользователя на указанную.

WP_User::set_role( string $role )

Метод set_role() принимает один обязательный параметр:

• $role (строка) — Название роли, на которую нужно изменить пользователя.

Метод не возвращает значения.

$role (строка) — Обязательный параметр. Название роли, на которую нужно изменить пользователя.

/**
 * Пример использования метода set_role()
 *
 * Изменяет роль пользователя на 'editor'.
 *
 * @param WP_User $user Объект пользователя.
 */
$user = wp_get_current_user();
$user->set_role( 'editor' );

to_array()

Метод to_array() класса WP_User возвращает представление объекта пользователя в виде массива.

WP_User::to_array(): array

Метод to_array() является статическим, поэтому он вызывается непосредственно из класса WP_User. Он не принимает никаких аргументов.

Метод возвращает массив, содержащий информацию о пользователе, включая его ID, имя пользователя, электронную почту и другие данные.

Метод to_array() возвращает массив, представляющий объект пользователя.

translate_level_to_cap()

Метод translate_level_to_cap() класса WP_User используется для преобразования числового уровня доступа в имя возможности (capability) для данного уровня.

WP_User::translate_level_to_cap( int $level ): string

Метод translate_level_to_cap() принимает один обязательный параметр:

• $level (int) — Числовой уровень доступа, от 1 до 10.

$level (int) — Обязательный параметр. Числовой уровень доступа, от 1 до 10.

Метод translate_level_to_cap() возвращает строку — имя возможности (capability) для данного уровня.

/**
 * Пример использования метода translate_level_to_cap()
 */
$level = 5; // Уровень доступа
$capability = WP_User::translate_level_to_cap( $level ); // Преобразование уровня в имя возможности
echo $capability; // Вывод имени возможности

В данном примере мы устанавливаем переменную $level равной 5, что соответствует определенному уровню доступа. Затем мы вызываем метод translate_level_to_cap() класса WP_User и передаем в него значение переменной $level. Метод возвращает имя возможности (capability) для данного уровня, которое сохраняется в переменной $capability. Наконец, мы выводим имя возможности на экран с помощью функции echo.

update_user_level_from_caps()

Метод update_user_level_from_caps() класса WP_User используется для обновления максимального уровня пользователя на основе его прав доступа.

Метод обновляет максимальный уровень пользователя, основываясь на его правах доступа, которые определены в его роли. Уровень пользователя используется для определения его возможностей и прав в системе WordPress.

WP_User::update_user_level_from_caps();

Метод update_user_level_from_caps() не принимает никаких аргументов.

Данный метод вызывается для объекта класса WP_User, представляющего пользователя WordPress, и обновляет его максимальный уровень на основе его прав доступа.

Метод не возвращает никакого значения.

_init_caps()

Метод _init_caps() класса WP_User устанавливает свойства объекта WP_User для работы с правами доступа. Этот метод устарел и рекомендуется использовать метод for_site() класса WP_User вместо него.

WP_User::_init_caps( string $cap_key = '' )

$cap_key (строка) (необязательно) — Ключ возможности. По умолчанию: пустая строка.

<?php
/**
 * Пример использования метода _init_caps()
 *
 * @param string $cap_key Ключ возможности.
 */
$user = new WP_User();
$user->_init_caps( 'edit_posts' );
?>

__call()

Метод «__call()» является частью класса «WP_User» и используется для сделать приватные/защищенные методы доступными для обратной совместимости.

WP_User::__call( string $name, array $arguments ): mixed|false

Метод «__call()» вызывается при попытке вызова несуществующего метода класса «WP_User». Он принимает два параметра: $name (строка) — имя метода, который нужно вызвать, и $arguments (массив) — аргументы, которые нужно передать при вызове метода.

$name (string) — Обязательный. Имя метода, который нужно вызвать.

$arguments (array) — Обязательный. Аргументы, которые нужно передать при вызове метода.

Метод «__call()» возвращает значение, возвращаемое вызываемым методом. Если метод не найден, возвращается значение false.

<?php
$user = new WP_User( $user_id ); // Создаем объект класса WP_User
$method_name = 'get_user_email'; // Имя метода, который нужно вызвать
$method_arguments = array( $user_id ); // Аргументы, которые нужно передать при вызове метода
$result = $user->__call( $method_name, $method_arguments ); // Вызываем метод "__call()" объекта $user
if ( $result ) {
    echo 'Email пользователя: ' . $result;
} else {
    echo 'Ошибка при вызове метода';
}
?>

В данном примере мы создаем объект класса WP_User с помощью конструктора и передаем ему идентификатор пользователя. Затем мы определяем имя метода, который нужно вызвать, и массив аргументов для этого метода. Далее мы вызываем метод «__call()» объекта $user, передавая ему имя метода и аргументы. Если метод существует и успешно выполняется, то в переменной $result будет содержаться его результат. Мы проверяем, что $result не является false, и выводим значение email пользователя. Если метод не найден или произошла ошибка при вызове, выводится соответствующее сообщение.

__construct()

Метод «__construct()» является конструктором класса «WP_User» и используется для создания объекта WP_User. Он вызывается автоматически при создании нового экземпляра класса WP_User. Конструктор принимает несколько параметров, которые определяют свойства нового объекта WP_User, такие как идентификатор пользователя, имя пользователя и идентификатор сайта.

WP_User::__construct( int|string|stdClass|WP_User $id, string $name = '', int $site_id = '' )

Конструктор класса WP_User принимает следующие параметры:

• $id (обязательный) — Идентификатор пользователя, объект WP_User или объект пользователя из базы данных.
• $name (необязательный) — Имя пользователя.
• $site_id (необязательный) — Идентификатор сайта. По умолчанию: текущий сайт.

/**
 * Создание нового объекта WP_User с использованием конструктора.
 */
// Создание объекта WP_User с идентификатором пользователя 123.
$user = new WP_User( 123 );
// Создание объекта WP_User с именем пользователя "john".
$user = new WP_User( '', 'john' );
// Создание объекта WP_User с идентификатором пользователя 123 и именем пользователя "john".
$user = new WP_User( 123, 'john' );
// Создание объекта WP_User с объектом WP_User.
$existing_user = new WP_User( $user_object );
// Создание объекта WP_User с объектом пользователя из базы данных.
$user_data = get_user_by( 'email', 'user@example.com' );
$user = new WP_User( $user_data );

• $id (int|string|stdClass|WP_User) — Идентификатор пользователя, объект WP_User или объект пользователя из базы данных. Обязательный параметр.
• $name (string) — Имя пользователя. Необязательный параметр. По умолчанию: пустая строка.
• $site_id (int) — Идентификатор сайта. Необязательный параметр. По умолчанию: пустая строка.

__get()

Метод «__get()» является магическим методом, используемым для доступа к пользовательским полям (custom fields) объекта WP_User. Он позволяет получить значение определенного пользовательского мета-ключа (user meta key).

WP_User::__get( string $key ): mixed

Метод «__get()» принимает один обязательный параметр:

• $key (string) — Обязательный. Ключ пользовательского мета-поля, значение которого требуется получить.

$key (string) — Обязательный. Ключ пользовательского мета-поля, значение которого требуется получить.

Метод «__get()» возвращает значение указанного пользовательского мета-ключа (если он установлен). Если $key равен ‘id’, то будет возвращен идентификатор пользователя (user ID).

<?php
/**
 * Пример использования метода "__get()" класса "WP_User"
 */
// Создаем объект WP_User для пользователя с ID 123
$user = new WP_User( 123 );
// Получаем значение пользовательского мета-ключа 'first_name'
$first_name = $user->__get( 'first_name' );
// Получаем значение пользовательского мета-ключа 'last_name'
$last_name = $user->__get( 'last_name' );
// Получаем идентификатор пользователя
$user_id = $user->__get( 'id' );
// Выводим полученные значения
echo 'First Name: ' . $first_name . '<br>';
echo 'Last Name: ' . $last_name . '<br>';
echo 'User ID: ' . $user_id;
?>

В данном примере мы создаем объект WP_User для пользователя с ID 123. Затем мы используем метод «__get()» для получения значения пользовательских мета-ключей ‘first_name’ и ‘last_name’. Мы также получаем идентификатор пользователя с помощью метода «__get()» и ключа ‘id’. Наконец, мы выводим полученные значения на экран.

__isset()

Метод «__isset()» является магическим методом, используемым для проверки существования определенного пользовательского поля. Он принадлежит классу «WP_User», который является основным классом для реализации объекта WP_User.

WP_User::__isset( string $key ): bool

Метод «__isset()» принимает один обязательный параметр:

• $key: строка, обязательный. Ключ метаданных пользователя, для которого нужно проверить наличие значения.

Метод «__isset()» принимает следующий параметр:

• $key: строка, обязательный. Ключ метаданных пользователя, для которого нужно проверить наличие значения.

Метод «__isset()» возвращает булево значение:

• bool: Возвращает true, если указанный ключ метаданных пользователя установлен, и false в противном случае.

<?php
/**
 * Проверяет, установлено ли значение метаданных пользователя для указанного ключа.
 *
 * @param string $key Ключ метаданных пользователя.
 * @return bool Возвращает true, если указанный ключ метаданных пользователя установлен, и false в противном случае.
 */
$user = wp_get_current_user();
if ( $user->__isset( 'first_name' ) ) {
    echo 'Значение метаданных пользователя для ключа "first_name" установлено.';
} else {
    echo 'Значение метаданных пользователя для ключа "first_name" не установлено.';
}
?>

__set()

Метод «__set()» является магическим методом, который используется для установки пользовательских полей пользователя. Он позволяет устанавливать значения пользовательских метаданных для объекта WP_User.

WP_User::__set( string $key, mixed $value )

Метод «__set()» принимает два параметра: $key (обязательный) и $value (обязательный). $key представляет собой ключ метаданных пользователя, а $value — значение, которое нужно установить для этого ключа.

$key (string) — Обязательный. Ключ пользовательской метаданных пользователя.

$value (mixed) — Обязательный. Значение, которое нужно установить для указанного ключа.

<?php
// Создаем объект WP_User
$user = new WP_User( $user_id );
// Устанавливаем значение метаданных для ключа 'custom_field'
$user->__set( 'custom_field', 'Custom Value' );
?>

В приведенном выше примере мы создаем объект WP_User с помощью идентификатора пользователя $user_id. Затем мы используем метод «__set()» для установки значения ‘Custom Value’ для ключа ‘custom_field’ в пользовательских метаданных.

__unset()

Метод «__unset()» является магическим методом класса «WP_User» и используется для удаления определенного пользовательского поля. Он позволяет удалить пользовательское поле, которое было ранее установлено для объекта WP_User.

WP_User::__unset( string $key )

Метод «__unset()» принимает один обязательный параметр:

• $key (string) — Обязательный. Ключ пользовательского поля, которое нужно удалить.

<?php
/**
 * Пример использования метода "__unset()" класса "WP_User"
 *
 * @param string $key Ключ пользовательского поля, которое нужно удалить.
 */
$user = new WP_User( $user_id );
$user->__unset( 'custom_field' );
?>

В приведенном выше примере кода метод «__unset()» вызывается для объекта WP_User с указанием ключа пользовательского поля, которое нужно удалить.

$key (string) — Обязательный. Ключ пользовательского поля, которое нужно удалить.

Параметр $key должен быть строкой и представлять собой ключ пользовательского поля, которое нужно удалить.

$user_id = 1; // ID пользователя
$user = new WP_User( $user_id );

$user_id = 1; // ID пользователя
$user = new WP_User( $user_id );
$display_name = $user->display_name;

$user_id = 1; // ID пользователя
$user = new WP_User( $user_id );
$role = 'editor'; // Название роли
$user->add_role( $role );

$user_id = 1; // ID пользователя
$user = new WP_User( $user_id );
$role = 'editor'; // Название роли
$user->remove_role( $role );

$user_id = 1; // ID пользователя
$user = new WP_User( $user_id );
$capability = 'edit_posts'; // Название возможности
$has_capability = $user->has_cap( $capability );

$role = 'editor';
$display_name = 'Editor';
$capabilities = array(
    'edit_posts' => true,
    'publish_posts' => true,
    'edit_others_posts' => true,
    // и другие возможности
);
$wp_user = new WP_User( $user_id );
$wp_user->add_role( $role, $display_name, $capabilities );

$role = 'editor';
$wp_user = new WP_User( $user_id );
$wp_user->remove_role( $role );

$capability = 'edit_others_posts';
$wp_user = new WP_User( $user_id );
$wp_user->add_cap( $capability );

$user = new WP_User( $user_id );
$user->remove_cap( 'edit_posts' );

$user = new WP_User( $user_id );
if ( $user->has_cap( 'edit_posts' ) ) {
    echo 'Пользователь может редактировать записи.';
} else {
    echo 'Пользователь не может редактировать записи.';
}

$user = new WP_User( $user_id );
$roles = $user->get_roles();
foreach ( $roles as $role_name => $role_object ) {
    echo 'Роль: ' . $role_name . '<br>';
    echo 'Описание: ' . $role_object->get('name') . '<br>';
}

$user = new WP_User( $user_id );
$site_id = $user->get_site_id();

$user = new WP_User( $user_id );
$value = $user->get( 'property_name' );

$user = new WP_User( $user_id );
$user->update_user_level_from_caps();