Описание функции __()
Функция __() используется для перевода строк в WordPress. Она принимает строку и возвращает переведенную версию этой строки на текущем языке. Функция применяется в темах и плагинах для обеспечения интернационализации контента.
Строки, переданные в эту функцию, должны быть зарегистрированы с помощью функции _e() или load_plugin_textdomain(), чтобы быть доступными для перевода.
Параметры
$text
Тип: string
Обязательный: Да
По умолчанию: »
Описание: Строка, которую необходимо перевести
Возможные значения:
string: Любая строка для перевода
$domain
Тип: string
Обязательный: Нет
По умолчанию: ‘default’
Описание: Домен текста для загрузки переводов
Возможные значения:
string: Имя текстового домена, по умолчанию ‘default’
Возвращаемое значение
Тип: string
Описание: Переведенная строка или оригинальная строка, если перевод не найден
Возможные значения:
• Переведенная строка, если перевод доступен
• Оригинальная строка, если перевод отсутствует
Примеры использования
Простой пример использования функции для перевода строки
$translated_text = __('Hello, World!');
// Вывод: Hello, World!
Если перевод доступен, то будет возвращен переведенный текст
Пример использования функции с указанием текстового домена
$translated_text = __('Submit', 'my-plugin');
// Выводит переведенную строку для плагина
Не забудьте зарегистрировать домен с использованием load_plugin_textdomain()
Безопасность
Валидация входных данных: Функция проверяет входные параметры на корректность
Санитизация: Входные строки автоматически очищаются
Рекомендации: Убедитесь, что строки зарегистрированы для перевода, чтобы избежать уязвимостей
— Связанные функции
Выводит переведенную строку сразу
Переводит строку и экранирует ее для безопасного вывода
— Примечания
– Ограничения
Необходимо регистрировать строки для перевода, иначе они не будут переведены
– Частые проблемы
- Отсутствие переводов для строк приведет к возврату оригинального текста
- Ошибки при указании неверного текстового домена
