Описание функции _x()
Функция _x() используется для локализации строк в WordPress с указанием контекста. Это позволяет избежать неоднозначностей при переводе, когда одна и та же строка может иметь разные значения в зависимости от контекста. Функция возвращает локализованную строку, что делает ее полезной для работы с многоязычными сайтами.
Используется в основном в темах и плагинах для обеспечения корректного перевода строк в зависимости от контекста.
Параметры
$text
Тип: string
Обязательный: Да
Описание: Строка для локализации
Возможные значения:
$context
Тип: string
Обязательный: Да
Описание: Контекст для строки, который поможет в переводе
Возможные значения:
$domain
Тип: string
Обязательный: Нет
По умолчанию: ‘default’
Описание: Домен для перевода, используемый для организации переводов
Возможные значения:
Возвращаемое значение
Тип: string
Описание: Локализованная строка
Возможные значения:
• Локализованная строка на языке пользователя
• Оригинальная строка, если перевод не найден
Примеры использования
Простой пример использования функции для перевода строки
$localized_string = _x('Hello', 'Greeting');
// Вывод: Hello на английском
Перевод будет зависеть от локализации сайта
Пример использования с указанием текстового домена
$localized_string = _x('Submit', 'Button label', 'my-plugin');
// Вывод: Submit на английском
Используется для плагинов и тем
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Строки очищаются автоматически WordPress
Рекомендации: Используйте корректные значения для контекста и домена
— Связанные функции
Локализует строку без контекста
Локализует и выводит строку
— Хуки
Фильтрует переводы перед выводом
Фильтрует переводы для строк в множественном числе
— Примечания
– Ограничения
Необходимо предоставлять контекст для избежания неоднозначностей
– Частые проблемы
- Отсутствие перевода приводит к возврату оригинальной строки
- Некорректный контекст может привести к неправильному переводу