add_user_meta() WP 3.0.0

Додає метадані до вказаного користувача.

Для додавання метаданих користувача також можна використовувати функцію update_user_meta() . Вона додасть поля, якщо його немає. Відмінність цієї функції в тому, що в ній можна не вказувати $unique (залишити її false), що дозволить додати кілька полів з однаковим ключем.

Метадані користувача, це аналог довільних полів у постів. Зберігаються вони у таблиці wp_usermeta . Щоб краще розуміти, що це за метадані, наприклад, такі звичні дані користувача як: first_name (ім’я), last_name (прізвище), nickname (Нік), записуються якраз у ці цілі поля користувача.

Працює на основі:
add_metadata()

Хуків немає.

Повертає

int|false. Ідентифікатор доданого ключа (поле таблиці з первинним ключем) або false, якщо не вдалося додати поле.

Використання

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


Типово: false

Приклади

0

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

Додамо мета поле _level_of_awesomeness для користувача з ID 1:

$user_id = 1;
$ awesome_level = 1000;
add_user_meta( $user_id, '_level_of_awesomeness', $awesome_level, true );
0

#2 Декілька полів з однаковим ключем

Цей приклад показує, як додати кілька полів з однаковими ключами, для цього не будемо вказувати параметр $unique , залишимо його false. Для прикладу, уявимо, що користувач вказує книжки, які він прочитав у спеціальне поле, таких книг може бути кілька і ми будемо записувати їхні назви в поля з однаковими ключами book:

$user_id = 1;

// додамо одну книгу
$read_book = 'Метро 2033';
add_user_meta ($ user_id, 'book', $read_book);

// додамо другу книгу
$read_book2 = 'Чайка на ім'я Джонатан Лівінгстон';
add_user_meta($user_id, 'book', $read_book2);

// тепер у нас 2 записи у таблиці wp_usermeta з однаковими ключами book

список змін

З версії 3.0.0Введено.

Код add_user_meta() WP 6.0.2

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

Залишити відповідь

Ваша e-mail адреса не оприлюднюватиметься. Обов’язкові поля позначені *