add_user_meta()
Додає метадані до вказаного користувача.
Для додавання метаданих користувача також можна використовувати функцію 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
Приклади
#1 Демонстрація
Додамо мета поле _level_of_awesomeness для користувача з ID 1:
$user_id = 1; $ awesome_level = 1000; add_user_meta( $user_id, '_level_of_awesomeness', $awesome_level, true );
#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() 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 ); }