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

# Функция IS_LOCALE_SWITCHED() │ WP 4.7.0

## Описание

Функция is_locale_switched() проверяет, активирована ли смена локали с помощью функции switch_to_locale().

**Время выполнения:**  
- 1 раз - 0.000019 секунд (очень быстро)  
- 50000 раз - 0.02 секунд (супер быстро)

**PHP:** 7.0.14, **WP:** 4.7

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

Функция возвращает true или false. Значение true указывает на то, что локаль была изменена, а false - что нет.

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

Чтобы использовать данную функцию, просто напишите:

```php
is_locale_switched();

Примеры

Пример 1: Проверка смены языка сайта

Предположим, что ваш сайт по умолчанию работает на русском языке (ru_RU). Но вы изменили страну пользователя по IP и переключили язык на английский (en_US). Теперь нам нужно сообщить пользователю о смене языка. Для этого можно отобразить сообщение, например, в заголовке сайта. В файле header.php добавьте следующее:

if( is_locale_switched() ){
    echo 'Язык сайта изменен на '. get_locale();
}

Замечания

• Используется глобальный объект: WP_Locale_Switcher. Это объект переключателя локали WordPress: $wp_locale_switcher.

Изменения

Функция была введена в версии 4.7.0.

Код функции IS_LOCALE_SWITCHED()

Вот как выглядит код функции is_locale_switched() в файле wp-includes/l10n.php:

function is_locale_switched() {
    /* @var WP_Locale_Switcher $wp_locale_switcher */
    global $wp_locale_switcher;

    return $wp_locale_switcher->is_switched();
}

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

Локализация (язык сайта)

• determine_locale()
• get_locale()
• get_user_locale()
• sanitize_locale_name()
• switch_to_locale()

Локализация (L10N I18N Интернационализация и локализация)

• __()
• _e()
• _n()
• translate()
• translate_user_role()