add_user_meta() — это функция в WordPress, которая добавляет новое метаполе к указанному пользователю. Метаполя пользователей используются для хранения дополнительной информации о пользователях, такой как предпочтения, настройки, кастомные данные и т.д.
Синтаксис
add_user_meta( $user_id, $meta_key, $meta_value, $unique )- $user_id (int): ID пользователя, к которому добавляется метаполе.
- $meta_key (string): Уникальный ключ метаполя.
- $meta_value (mixed): Значение метаполя.
- $unique (bool, необязательный): Опциональный параметр, указывающий, следует ли предотвращать добавление дублирующихся значений. По умолчанию
false.
Зачем использовать add_user_meta()?
- Дополнительная информация: Позволяет добавлять пользовательские данные, такие как предпочтения, настройки и кастомные данные.
- Гибкость: Помогает улучшить функциональность тем и плагинов, добавляя кастомные возможности и функции для пользователей.
- Персонализация: Используется для персонализации пользовательского опыта на сайте.
Примеры использования
Добавление кастомного поля к пользователю
Добавим кастомное поле с уникальным ключом и значением к пользователю.
$user_id = 1; // ID пользователя
$meta_key = 'favorite_color';
$meta_value = 'blue';
add_user_meta( $user_id, $meta_key, $meta_value );Предотвращение дублирования значений
Добавим метаполе с предотвращением дублирования значений.
$user_id = 3; // ID пользователя
$meta_key = 'newsletter_subscribed';
$meta_value = 'yes';
// Убедимся, что значение 'yes' не будет добавлено, если оно уже существует
add_user_meta( $user_id, $meta_key, $meta_value, true );
Если метаполе ‘newsletter_subscribed’ уже имеет значение ‘yes’ у пользователя с ID 3, оно не будет добавлено второй раз благодаря использованию параметра $unique со значением true.
Использование в темах и плагинах
Функция add_user_meta() часто используется в разработке тем и плагинов для добавления и хранения дополнительной информации о пользователях, что делает её мощным инструментом для расширения функциональности WordPress.
Сохранение пользовательских данных из формы
Рассмотрим пример, когда данные добавляются из формы в плагине или теме:
function save_custom_user_data( $user_id ) {
if ( isset( $_POST['custom_field'] ) ) {
$custom_field_value = sanitize_text_field( $_POST['custom_field'] );
add_user_meta( $user_id, 'custom_field_key', $custom_field_value );
}
}
add_action( 'user_register', 'save_custom_user_data' );Этот код сохраняет данные, отправленные из формы регистрации пользователя, в качестве кастомного поля у нового пользователя.
Заключение
Функция add_user_meta() предоставляет разработчикам WordPress мощный инструмент для добавления и хранения дополнительной информации о пользователях. Правильное использование add_user_meta() помогает создавать более функциональные и персонализированные темы и плагины, улучшая пользовательский опыт и гибкость сайта.