Функция GET_CURRENTUSERINFO() в WordPress: Использование, примеры, изменения

# Функция GET_CURRENTUSERINFO() │ WP 0.71

Функция get_currentuserinfo() устарела с версии 4.5.0. Она больше не поддерживается и может быть удалена в будущих версиях. Вместо неё используйте wp_get_current_user().

Эта функция заполняет глобальные переменные информацией о текущем пользователе.

- Время выполнения: 1 раз — 0.000013 сек (очень быстро) | 50000 раз — 0.01 сек (молниеносно) | PHP 7.0.5, WP 4.5.1
- Хуки: нет

## Возвращаемое значение

Функция возвращает:
- true или false в случае ошибки.
- Экземпляр WP_User при успешном выполнении, если запрос не является XMLRPC и токен аутентификации действителен.

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

```php
get_currentuserinfo();

Примеры

Пример 1: Получение информации о пользователе

global $current_user;

get_currentuserinfo();

echo 'Имя пользователя: ' . $current_user->user_login . "n";
echo 'E-mail: ' . $current_user->user_email . "n";
echo 'Имя: ' . $current_user->user_firstname . "n";
echo 'Фамилия: ' . $current_user->user_lastname . "n";
echo 'Отображается как: ' . $current_user->display_name . "n";
echo 'ID пользователя: ' . $current_user->ID . "n";

Результат:

Имя пользователя: Zedd
E-mail: zedd@example.com
Имя: John
Фамилия: Doe
Отображается как: John Doe
ID пользователя: 1

Пример 2: Использование отдельных переменных

Много информации о пользователе записывается в отдельные глобальные переменные. Их можно использовать вот так:

global $display_name, $user_email;
get_currentuserinfo();

echo "E-mail адрес пользователя {$user_identity}: {$user_email}";

Результат:

E-mail адрес пользователя Леонид: leonid@example.com

Примечание: Переменная $display_name может не работать в версиях выше 2.5. Используйте вместо неё $user_identity.

Пример 3: Проверка авторизации пользователя

Чтобы проверить, авторизован ли пользователь (вошёл ли в систему), используйте следующий условный тег:

if( is_user_logged_in() ){
    // авторизованный пользователь
}

Пример 4: Как разделить отображение для авторизованных и неавторизованных пользователей

Как показать один текст для авторизованных пользователей и другой для тех, кто не вошёл в систему:

    

    
    
Чтобы увидеть полностью, зарегистрируйтесь.

Примечания

• Используйте wp_get_current_user() вместо устаревшей функции get_currentuserinfo().

Изменения

• Введена в версии 0.71. Устарела с версии 4.5.0. Рекомендуется использовать wp_get_current_user().

Код функции GET_CURRENTUSERINFO

Файл: wp-includes/pluggable-deprecated.php

function get_currentuserinfo() {
    _deprecated_function( __FUNCTION__, '4.5.0', 'wp_get_current_user()' );
    return _wp_get_current_user();
}

Связанные функции пользователей

• clean_user_cache(): Очищает кэш пользователя.
• current_user_can(): Проверяет, имеет ли пользователь определённые права.
• get_current_user_id(): Получает ID текущего пользователя.
• is_user_logged_in(): Проверяет, авторизован ли пользователь.
• wp_create_user(): Создаёт нового пользователя.
• wp_insert_user(): Вставляет нового пользователя в базу данных.

И многие другие функции, связанные с управлением пользователями.