Функция get_user_locale() в WordPress: как определить язык пользователя

## Функция get_user_locale()

Функция get_user_locale() позволяет узнать язык пользователя в вашем приложении WordPress. Если у пользователя установлен язык, не равный пустой строке, то он будет возвращен. В противном случае функция возвращает язык сайта, заданный функцией get_locale().

### Использование функции

Функция get_user_locale() используется в основном для определения языка интерфейса, который будет виден пользователю.

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

Функция возвращает строку, представляющую язык (локаль) пользователя.

### Сигнатура функции

```plaintext
get_user_locale( $user );

Параметры:

• $user (int | WP_User): ID пользователя или объект пользователя WP_User. По умолчанию используется текущий пользователь.

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

Пример 1: Получение языка текущего пользователя

$local = get_user_locale();
echo $local; // выводит 'ru_RU' для русского языка

Этот пример показывает, как получить язык, установленный для текущего пользователя. Если у него установлен русский язык, то будет выведено ru_RU.

Пример 2: Получение языка пользователя с ID 1

$local = get_user_locale( 1 );
echo $local; // выводит 'en_US' для английского языка

В этом примере мы получаем язык для пользователя с ID 1. Если для этого пользователя установлен английский язык, будет выведено en_US.

Описание функции

Вот внутренняя часть функции get_user_locale() для лучшего понимания того, как она работает:

function get_user_locale( $user = 0 ) {
    $user_object = false;

    if ( 0 === $user && function_exists( 'wp_get_current_user' ) ) {
        $user_object = wp_get_current_user();
    } elseif ( $user instanceof WP_User ) {
        $user_object = $user;
    } elseif ( $user && is_numeric( $user ) ) {
        $user_object = get_user_by( 'id', $user );
    }

    if ( ! $user_object ) {
        return get_locale();
    }

    $locale = $user_object->locale;

    return $locale ? $locale : get_locale();
}

Как работает код:

1. Если в функцию не передан аргумент $user, пытаемся получить текущего пользователя с помощью wp_get_current_user().
2. Если передан объект WP_User, сохраняем его в переменной $user_object.
3. Если передан ID пользователя, вызываем get_user_by() для получения объекта пользователя.
4. Если объект пользователя не найден, используем язык сайта по умолчанию, который возвращает get_locale().
5. Если у пользователя есть установленный язык, то он возвращается. Если нет, возвращается язык сайта.

Связанные функции

• determine_locale(): Определяет, какой язык использовать.
• get_locale(): Возвращает язык сайта.
• is_locale_switched(): Проверяет, был ли переключен язык.
• sanitize_locale_name(): Очищает имя локали.
• switch_to_locale(): Переключает на другой язык.

Эти функции помогут вам лучше управлять языковыми настройками в вашем WordPress сайте.