Функция get_userdata() в WordPress используется для получения данных пользователя по его ID. Она возвращает объект класса WP_User, который содержит информацию из таблиц базы данных wp_users и wp_usermeta. Эта функция полезна для работы с пользовательскими данными, их отображения или использования в различных задачах на сайте.
get_userdata( int $user_id ): WP_User|false
Параметры:
$user_id(int, обязательный) — ID пользователя, данные которого нужно получить.
Возвращаемое значение:
WP_User|false— Возвращает объект WP_User при успешном нахождении пользователя илиfalse, если пользователь не найден.
Пример 1: Получение и вывод данных пользователя
Функция возвращает объект данных пользователя. Вы можете выводить отдельные поля, как показано в примере ниже:
$user_info = get_userdata(1);
echo 'Имя пользователя: ' . $user_info->user_login . "\n";
echo 'Роли пользователя: ' . implode(', ', $user_info->roles) . "\n";
echo 'ID пользователя: ' . $user_info->ID . "\n";
Результат:
Имя пользователя: admin
Роли пользователя: administrator
ID пользователя: 1
Пример 2: Сохранение отдельных частей данных в переменные
Вы можете извлечь конкретные поля объекта и использовать их в дальнейшем коде:
$user_info = get_userdata(1);
$username = $user_info->user_login;
$first_name = $user_info->first_name;
$last_name = $user_info->last_name;
echo "$first_name $last_name зашел(а) на сайт под логином $username.";
Результат:
Иван Иванов зашел на сайт под логином ivanov.
Пример 3: Получение email и имени для отображения
Этот пример показывает, как получить и вывести имя пользователя и его email:
$user_info = get_userdata(1);
$user_name = $user_info->display_name;
$user_email = $user_info->user_email;
echo "$user_name, $user_email";
Результат:
Admin, [email protected]
Пример 4: Доступ к пользовательским мета-данным
Вы также можете получать мета-данные пользователя:
$user_info = get_userdata(1);
echo $user_info->last_name . ", " . $user_info->first_name . "\n";
Результат:
Doe, John
Пример 5: Использование метода для получения данных
Объект WP_User, возвращаемый функцией, предоставляет доступ к методам для работы с данными пользователя. Например, метод get() можно использовать для получения значений:
$user = get_userdata(1);
echo $user->get('user_login');
Результат:
admin
Описание полей объекта WP_User
Функция get_userdata() возвращает объект WP_User, который содержит следующие основные поля:
ID— Идентификатор пользователя.user_login— Логин пользователя.user_email— Email пользователя.display_name— Имя пользователя для отображения.roles— Роли пользователя (массив).user_registered— Дата регистрации пользователя.first_name— Имя.last_name— Фамилия.wp_capabilities— Массив с возможностями пользователя (caps).
Методы класса WP_User
Помимо прямого доступа к данным, вы можете использовать методы объекта WP_User для различных операций. Вот некоторые полезные методы:
get( $key )— Получает значение свойства или мета-данных пользователя.has_cap( $cap )— Проверяет, обладает ли пользователь указанной привилегией.add_role( $role )— Добавляет роль пользователю.remove_role( $role )— Удаляет роль у пользователя.set_role( $role )— Устанавливает роль пользователя.
Пример 6: Проверка роли пользователя
Вы можете использовать метод для проверки, принадлежит ли пользователь к определенной роли:
$user = get_userdata(1);
if ( in_array( 'administrator', $user->roles ) ) {
echo 'Пользователь является администратором.';
}
Заключение
Функция get_userdata() — это удобный способ получить полные данные пользователя в виде объекта WP_User. Благодаря множеству доступных полей и методов, она позволяет легко управлять данными пользователя, проверять роли, получать мета-данные и использовать их в различных сценариях на сайте WordPress.