_e()

Отображает переведенный текст
Функция WordPress
INT 1.2.0
WordPress Icon

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

Функция «_e()» в WordPress используется для отображения переведенного текста. Она принимает строку текста, которую нужно перевести, и отображает ее на экране. Функция автоматически определяет язык сайта и выбирает соответствующий перевод из файла переводов.

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

_e( string $text, string $domain = 'default' )

Функция «_e()» имеет два параметра: $text и $domain. Параметр $text является обязательным и представляет собой текст, который нужно перевести. Параметр $domain является необязательным и представляет собой уникальный идентификатор для получения переведенных строк. По умолчанию, если не указан, используется значение ‘default’.

  • $text (строка) — Обязательный. Текст, который нужно перевести.
  • $domain (строка) — Необязательный. Идентификатор для получения переведенных строк. По умолчанию: ‘default’.
<?php
/**
 * Пример использования функции _e()
 */
$text = 'Привет, мир!'; // Текст для перевода
$domain = 'my-theme'; // Идентификатор домена
_e( $text, $domain ); // Отображение переведенного текста
?>

В данном примере мы используем функцию «_e()» для отображения переведенного текста «Привет, мир!» с помощью идентификатора домена «my-theme». Если в файле переводов найдется соответствующий перевод для текущего языка сайта, то текст будет отображен на экране.

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

Отображение переведенного текста


_e( 'Hello, world!', 'my-text-domain' );

Функция _e() используется для отображения переведенного текста на экране. В приведенном примере текст «Hello, world!» будет переведен на текущий язык сайта и выведен на экран. Второй параметр 'my-text-domain' является необязательным и представляет собой уникальный идентификатор для получения переведенных строк. Если не указан, будет использован домен по умолчанию ‘default’.

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


_e( 'Hello, world!', 'my-text-domain' );

В этом примере функция _e() используется для перевода текста «Hello, world!» с указанием домена ‘my-text-domain’. Домен используется для определения, из какого источника получать переводы. Если переводы для указанного домена не найдены, будет использован перевод по умолчанию.

Использование функции _e() для перевода текста в шаблонах


<?php _e( 'Hello, world!', 'my-text-domain' ); ?>

В этом примере функция _e() используется внутри PHP-кода в шаблоне WordPress. Текст «Hello, world!» будет переведен и выведен на экран в соответствии с текущим языком сайта.

Изменение домена для получения переведенных строк


_e( 'Hello, world!', 'my-custom-domain' );

В этом примере функция _e() используется для перевода текста «Hello, world!» с указанием пользовательского домена ‘my-custom-domain’. При использовании этого домена будут получены переводы, связанные только с этим доменом. Если переводы для указанного домена не найдены, будет использован перевод по умолчанию.

Перевод текста с использованием функции _e() в плагинах


function my_plugin_function() {
    _e( 'Hello, world!', 'my-plugin-domain' );
}

В этом примере функция _e() используется внутри функции плагина. Текст «Hello, world!» будет переведен с использованием домена ‘my-plugin-domain’. Это позволяет плагинам иметь собственные переводы, отличные от переводов темы или других плагинов.

Вопросы и ответы

Как перевести текст с помощью функции _e()?

Функция _e() используется для отображения переведенного текста на сайте WordPress. Она принимает один обязательный параметр — текст, который нужно перевести.

Пример использования функции _e():


_e( 'Hello, world!', 'text-domain' );

Как указать уникальный идентификатор для получения переведенных строк?

Функция _e() принимает второй необязательный параметр — текстовый домен. Он служит уникальным идентификатором для получения переведенных строк.

Пример использования функции _e() с указанием текстового домена:


_e( 'Hello, world!', 'text-domain' );

Как изменить текстовый домен по умолчанию для функции _e()?

По умолчанию, функция _e() использует текстовый домен ‘default’. Его можно изменить, указав второй параметр.

Пример изменения текстового домена для функции _e():


_e( 'Hello, world!', 'my-text-domain' );

Как использовать переменные вместо статического текста при использовании функции _e()?

Для использования переменных вместо статического текста при использовании функции _e(), нужно сначала объявить переменную, а затем передать ее значение в функцию.

Пример использования переменных с функцией _e():


$greeting = 'Hello, world!';
_e( $greeting, 'text-domain' );

Как добавить новый текстовый домен для перевода строк?

Для добавления нового текстового домена для перевода строк в WordPress необходимо использовать функцию load_textdomain(). Она принимает два параметра: путь к файлу перевода и уникальный идентификатор домена.


load_textdomain( 'my-domain', WP_LANG_DIR . '/my-domain/my-domain-' . get_locale() . '.mo' );

Как перевести текст на другой язык с помощью функции _e()?

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


_e( 'Hello, world!', 'my-domain' );

Как обработать ошибку при отсутствии перевода для заданного текста?

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


$translated_text = __( 'Hello, world!', 'my-domain' );
if ( $translated_text === 'Hello, world!' ) {
    // Обработка ошибки отсутствия перевода
}

Как использовать функцию _e() внутри шаблона WordPress?

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


<h1><?php _e( 'Hello, world!', 'my-domain' ); ?></h1>

Функция _e() в WordPress используется для вывода переведенного текста. Она позволяет легко переводить текст на другие языки, добавлять новые текстовые домены для перевода и обрабатывать ошибки при отсутствии перевода. Используйте эту функцию внутри шаблонов WordPress, чтобы создавать многоязычные сайты.

Связанные элементы

  • Функция add_action(): регистрирует функцию, которая будет выполнена при возникновении определенного события.
  • Функция add_filter(): регистрирует функцию, которая будет использоваться для изменения определенных данных или результатов.
  • Функция do_action(): вызывает все функции, связанные с определенным событием.
  • Функция apply_filters(): применяет все функции-фильтры к определенным данным или результатам.
  • Хук init: срабатывает при инициализации WordPress и позволяет регистрировать дополнительные функции и настройки.
  • Хук wp_enqueue_scripts: срабатывает при загрузке скриптов и стилей на сайте и позволяет добавлять свои собственные файлы.
  • Хук the_content: срабатывает перед выводом содержимого записи и позволяет изменять его перед отображением.
  • Класс WP_Hook: предоставляет методы для управления хуками и их функциями.
  • Класс WP_Query: используется для создания и выполнения запросов к базе данных WordPress.
  • Класс WP_Widget: позволяет создавать виджеты для отображения информации на сайте.
Обсуждение