Функция _EX() в WordPress
Функция _ex() используется для отображения переведённого текста с определённым контекстом. Это полезно, когда одно и то же слово или фраза могут иметь разные переводы в зависимости от ситуации.
Использование функции
Функция просто отображает то, что получает от другой функции — _x(). Если вам нужен более детальный обзор перевода с учетом контекста, обратите внимание на описание функции _x().
Синтаксис
Функция вызывается следующим образом:
Параметры
- $text (string, обязательный) — текст, который нужно перевести.
- $context (string, обязательный) — информация о контексте для переводчиков.
- $domain (string) — текстовый домен. Уникальный идентификатор для получения переведённых строк. По умолчанию: 'default'.
Возвращаемое значение
Функция не возвращает ничего (null). Она отображает переведённый текст или оригинальный текст, если перевод не был найден.
Пример использования
Предположим, вы хотите перевести слово "Format" в контексте "формата сообщения". Вы можете использовать следующий код:
Если, например, пере��одить на русский, то этот код выведет: Формат.
Версия
Функция была введена в WordPress версии 3.0.0 и обновлена до версии 6.7.2.
Как это работает?
Вот как выглядит реализация функции _ex() в файле l10n.php:
function _ex( $text, $context, $domain = 'default' ) {
echo _x( $text, $context, $domain );
}
Эта функция просто вызывает _x() с заданными параметрами и выводит результат.
Связанные функции
В WordPress есть несколько других функций, связанных с интернационализацией и локализацией:
__()— возвращает переведённый текст._e()— выводит переведённый текст._n()— поддерживает перевод с учетом чисел._nx()— поддерживает перевод с учетом контекста для множественного числа.date_i18n()— форматирует дату в соответствии с локалью.load_theme_textdomain()— загружает текстовый домен для темы.
Эти функции могут быть полезны, если вы хотите улучшить поддержку перевода на вашем сайте на WordPress.