функция
since 3.0.0
add_user_meta()
Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.
Сигнатура
add_user_meta( int $user_id, string $meta_key, mixed $meta_value, bool $unique = false ): int|falseОписание
По историческим причинам и ключ метаданных, и значение метаданных на входе должны быть «экранированы обратными слэшами».
Оригинал (английский)
For historical reasons both the meta key and the meta value are expected to be “slashed” (slashes escaped) on input.
Параметры
$user_id
int
обязательный
ID пользователя.
$meta_key
string
обязательный
Имя метаданных.
$meta_value
mixed
обязательный
Значение метаданных. Массивы и объекты сохраняются как сериализованные данные и возвращаются того же типа при получении. Остальные типы данных сохраняются в базе данных как строки:
false сохраняется и возвращается как пустая строка ('')
true сохраняется и возвращается как '1'
числа (как целые, так и с плавающей точкой) сохраняются и возвращаются как строки. Должно быть сериализуемым, если не является скалярным значением.
$unique
bool
необязательный
= false
Следует ли запретить добавление одного и того же ключа.
Возвращаемое значение
int|false
Исходный код
wp-includes/user.php:1229
function add_user_meta( $user_id, $meta_key, $meta_value, $unique = false ) {
return add_metadata( 'user', $user_id, $meta_key, $meta_value, $unique );
}История изменений
| Версия | Описание |
|---|---|
| 3.0.0 | Introduced. |
