Функция _ex() в WordPress используется для перевода строк, предоставляя дополнительный контекст для переводчиков. Это особенно полезно, когда одна и та же строка может иметь разные значения в разных контекстах. В этой статье мы рассмотрим, что такое функция _ex(), как она работает и как её правильно использовать с примерами.
Что такое функция _ex() в WordPress?
Функция _ex() расширяет возможности стандартной функции __() добавлением аргумента для контекста. Контекст помогает переводчикам лучше понять, как должна быть переведена строка в конкретном случае, что делает переводы более точными и релевантными.
_ex( $text, $context, $domain );$text(обязательно): Строка текста, которую нужно перевести.$context(обязательно): Контекст, поясняющий перевод строки.$domain(необязательно): Текстовый домен. Используется для группировки связанных строк перевода. Если не указан, используется текстовый домен по умолчанию.
Примеры использования функции _ex()
Рассмотрим несколько примеров использования функции _ex() в реальных сценариях.
Пример 1: Базовое использование
echo _ex( 'Post', 'noun', 'my-text-domain' );В этом примере строка 'Post' переводится как существительное. Контекст 'noun' помогает переводчику понять, что перевод должен соответствовать значению существительного.
Пример 2: Использование с разным контекстом
echo _ex( 'Post', 'verb', 'my-text-domain' );В этом примере строка 'Post' переводится как глагол. Контекст 'verb' указывает переводчику на необходимость перевода в форме глагола.
Перевод с дополнительным контекстом
Иногда вам нужно перевести строку, которая имеет разные значения в зависимости от контекста.
echo _ex( 'Save', 'store', 'my-text-domain' );
echo _ex( 'Save', 'rescue', 'my-text-domain' );В этом примере одна и та же строка 'Save' переводится по-разному в зависимости от контекста: 'store' (сохранить данные) и 'rescue' (спасти кого-то).
Заключение
Функция _ex() в WordPress является мощным инструментом для перевода строк с дополнительным контекстом, что делает переводы более точными и понятными. Понимание её работы и правильное использование поможет вам сделать ваш контент доступным для глобальной аудитории. Следуя приведённым примерам и рекомендациям, вы сможете эффективно локализовать ваши проекты на WordPress.