add_user_meta

Добавляет метаданные к указанному пользователю.

Для добавления метаданных пользователя можно также использовать функцию update_user_meta(). Она добавит поле, если его не существует. Отличие этой функции в том, что в ней можно не указывать $unique (оставить его false), что позволит добавить несколько полей с одинаковым ключом.

Метаданные пользователя, это аналог произвольных полей у постов. Хранятся они в таблице wp_usermeta. Чтобы лучше понимать что это за метаданные, к примеру, такие привычные данные пользователя как: first_name (имя), last_name (фамилия), nickname (Ник), записываются как раз в эти мета поля пользователя.

Хуков нет.

Возвращает

Идентификатор добавленного ключа (поле таблицы с первичным ключом) или false, если не удалось добавить поле.

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

add_user_meta( $user_id, $meta_key, $meta_value, $unique );
$user_id(число) (обязательный)
ID пользователя.
$meta_key(строка) (обязательный)
Ключ мета поля пользователя.
$meta_value(строка/массив/число/объект/логический)
Значение мета поля пользователя.
$unique(логический)
Если равно true, то поле будет добавлено только, если поля с таким же ключом еще не существует. false – добавит еще одно поле с одинаковым ключом, если такое поле уже существует.
По умолчанию: false

Примеры

#1 Демонстрация

Добавим мета поле _level_of_awesomeness для пользователя с ID 1:

<?php
function add_user_meta($user_id, $meta_key, $meta_value, $unique = false) {
	return add_metadata('user', $user_id, $meta_key, $meta_value, $unique);
}

Комментарии:


Оставить комментарий

Your email address will not be published. Required fields are marked *