WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru

get_user_meta() WP 3.0

Получает отдельное мета поле или все мета поля указанного пользователя.

Мета поля пользователей, это тоже самое что и произвольные поля для постов, только тут пост - это пользователь, а произвольное поле - мета поле пользователя. Мета поля хранятся в таблице wp_usermeta, которая является тем же самым, что и таблица wp_postmeta для постов.

Работает на основе: get_metadata()
1 раз = 0.000998с = медленно | 50000 раз = 0.09с = скорость света | PHP 7.1.2, WP 4.7.5

Хуков нет.

Возвращает
  • Значение мета поля, если параметр $single = true.
  • Массив, если $key не был указан или $single = false.
  • Если мета поля не существует и $single = true, функция вернет пустую строку. Если $single = false будет возвращен пустой массив.

Использование

get_user_meta( $user_id, $key, $single );
$user_id(число) (обязательный)
ID пользователя, данные которого нужно получить.
$key(строка)
Ключ мета поля, данные которого нужно получить. Если оставить этот параметр пустым, то будут возвращены все мета поля пользователя.
По умолчанию: ''
$single(логический)
Если установить в true, то функция вернет значение мета поля, если оставить false, то значение мета поля будет возращено в массиве. Этот параметр не имеет смысла, если параметр $key не был указан.
По умолчанию: false

Примеры

#1 Пример использования

Этот пример получит и затем выведет на экран Ник пользователя с ID = 9:

$user_id = 9;
$key = 'nickname';
$single = true;
$user_last = get_user_meta( $user_id, $key, true ); 
echo 'Значение ключа '. $key . ' у пользователя ' . $user_id . ' равно: ' . $user_last; 

// получим:
// Значение ключа nickname у пользователя 9 равно: Enot

#2 Получение всех метаданных

Этот пример показывает что будет если $key оставить пустым, чтобы получить все метаданных указанного пользователя:

$all_meta_for_user = get_user_meta( 9 );

/* 
$all_meta_for_user будет содержать массив:
Array ( 
	[first_name] => Array ( [0] => Tom ) 
	[last_name] => Array ( [0] => Auger) 
	[nickname] => Array ( [0] => tomauger ) 
	[description] => и т.д... 
)
*/

Чтобы получить данные из этого примера, вам нужно получать первый элемент массива, так:

$last_name = $all_meta_for_user['last_name'][0];

Чтобы избежать этого неудобства, возможно лучше применить свою функцию к получаемому массиву, используя array_map():

$all_meta_for_user = array_map( function( $a ){ return $a[0]; }, get_user_meta( $user_id ) );

/*
Теперь, $all_meta_for_user будет содержать такой массив:

Array ( 
	[first_name] => Tom 
	[last_name] => Auger 
	[nickname] => tomauger 
	[description] => и т.д...
)
*/

Список изменений

С версии 3.0.0 Введена.

Код get_user_meta() WP 5.6

<?php
function get_user_meta( $user_id, $key = '', $single = false ) {
	return get_metadata( 'user', $user_id, $key, $single );
}

Из метки: metadata (метаданные)

11 комментов
Полезные 2 Вопросы 1 Все
    Войти