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

# Функция _E() в WordPress

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

## Возврат

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

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

```php

• $text (string) (обязательный) — текст, который нужно перевести.
• $domain (string) — идентификатор файла перевода, который указывается при регистрации и подключении файла перевода. Если не указан, будет использоваться стандартный файл перевода WordPress.
  • По умолчанию: 'default'

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

1. Перевод строки с указанием домена перевода

Чтобы перевести строку из собственного файла перевода, необходимо указать второй параметр $domain. Он связывает строку для перевода с файлом перевода.

2. Делаем строку внутри вашего плагина или темы переводимой

Обратите внимание, что 'Привет, мир' и 'text_domain' должны передаваться как строковые литералы, а не как переменные.

Неправильно:

3. Перевод строки

Пример использования функции в базовой теме WordPress:

Если используется файл локализации для русского языка, будет отображено: "Комментарий:".

С версии 4.2 константа WPLANG была отменена, и теперь язык меняется в основных настройках сайта.

Пример для версий до 4.2:

Для русского языка константа WPLANG должна быть определена в файле wp-config.php следующим образом:

define('WPLANG', 'ru_RU');

Для такого перевода без указания $domain будет использоваться файл wp-content/languages/ru_RU.mo.

4. Вывод перевода

Существует похожая функция __(), которая возвращает результат, но не выводит его. Пример использования:

_e( 'это сообщение', 'text_domain' );

Это то же самое, что и:

echo __( 'это сообщение', 'text_domain' );

Изменения

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

Код функции _E

function _e( $text, $domain = 'default' ) {
    echo translate( $text, $domain );
}

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

• __()
• _ex()
• _n()
• _nx()
• _x()
• date_i18n()
• determine_locale()
• esc_attr__()
• esc_attr_e()
• esc_html__()
• esc_html_e()
• get_locale()
• get_translations_for_domain()
• get_user_locale()
• is_locale_switched()
• is_textdomain_loaded()
• language_attributes()
• load_child_theme_textdomain()
• load_muplugin_textdomain()
• load_plugin_textdomain()
• load_textdomain()
• load_theme_textdomain()
• number_format_i18n()
• sanitize_locale_name()
• switch_to_locale()
• translate()
• translate_user_role()
• unload_textdomain()
• wp_localize_jquery_ui_datepicker()
• wp_set_script_translations()