Функция add_user_meta(): Добавление метаданных к пользователю в WordPress
Функция add_user_meta() позволяет добавлять метаданные к пользователю в WordPress. Это полезно, когда вам нужно хранить дополнительную информацию о пользователе, например, его предпочтения или особенности.
Использование функции add_user_meta()
Сигнатура функции
add_user_meta( $user_id, $meta_key, $meta_value, $unique );Параметры
- $user_id (int, обязательный): Идентификатор пользователя.
- $meta_key (string, обязательный): Имя метаданных.
- $meta_value (mixed, обязательный): Значение метаданных. Если это не простое значение, оно должно быть сериализуемым (т.е. его можно преобразовать в строку).
- $unique (bool, не обязательный): Указывает, нужно ли добавлять одинаковые ключи. По умолчанию
false, что позволяет добавлять несколько записей с одним и тем же ключом.
Возвращаемое значение
Функция возвращает:
- int: Идентификатор метаданных при успешно�� выполнении.
- false: В случае ошибки.
Примеры использования
Пример 1: Добавление нескольких записей с одинаковым ключом
В этом примере мы покажем, как добавлять несколько записей с одинаковыми ключами. Предположим, пользователь указывает книги, которые он прочитал. Мы не будем указывать параметр $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 );
// Теперь в таблице wp_usermeta есть 2 записи с одинаковым ключом "book".Пример 2: Добавление метаданных для пользователя
В этом примере мы добавляем метаданные "_level_of_awesomeness" (уровень крутости) для пользователя с ID 1.
$user_id = 1;
$awesome_level = 1000;
add_user_meta( $user_id, '_level_of_awesomeness', $awesome_level, true );Обновление функции add_user_meta()
Функция add_user_meta() была введена в версии WordPress 3.0. Она сейчас располагается в файле wp-includes/user.php.
Код функции
function add_user_meta( $user_id, $meta_key, $meta_value, $unique = false ) {
return add_metadata( 'user', $user_id, $meta_key, $meta_value, $unique );
}Заключение
Функция add_user_meta() — это мощный инструмент для работы с дополнительной информацией о пользователях в WordPress. Понимание того, как она работает, может значительно улучшить ваши возможности настройки и управления пользователями на вашем сайте.
Используйте эту функцию в своих проектах, чтобы сохранять нужные данные о пользователях и улучшать взаимодействие с ними.