Описание функции is_textdomain_loaded()
Функция is_textdomain_loaded() используется для проверки, загружен ли текстовый домен для локализации в WordPress. Это полезно, когда необходимо убедиться, что переводы доступны перед их использованием.
Функция помогает избежать ошибок, связанных с отсутствием локализованных строк, если текстовый домен не был загружен.
Параметры
$textdomain
Тип: string
Обязательный: Да
Описание: Название текстового домена, который нужно проверить
Возможные значения:
example: my-plugin
description: Названия текстовых доменов, используемых для локализации
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если текстовый домен загружен, иначе false
Возможные значения:
• true — текстовый домен загружен
• false — текстовый домен не загружен
Примеры использования
Базовый пример проверки, загружен ли текстовый домен
$is_loaded = is_textdomain_loaded('my-plugin');
if ($is_loaded) {
echo 'Текстовый домен загружен';
} else {
echo 'Текстовый домен не загружен';
}
Выводит сообщение в зависимости от состояния загрузки
Проверка загрузки текстового домена перед выводом перевода
$textdomain = 'my-plugin';
if (is_textdomain_loaded($textdomain)) {
echo __('Hello, World!', $textdomain);
} else {
echo 'Перевод недоступен';
}
Предотвращает ошибки при отсутствии перевода
Безопасность
Валидация входных данных: Параметр textdomain проверяется на корректность внутри функции
Санитизация: Санитизация не требуется, так как используется только строка
Рекомендации: Используйте текстовые домены, соответствующие вашему плагину или теме для предотвращения конфликтов
— Связанные функции
Загружает текстовый домен для локализации
Выгружает текстовый домен, если он больше не нужен
— Примечания
– Ограничения
Функция не проверяет наличие перевода для конкретной строки, только загруженность текстового домена
– Частые проблемы
- Неверное название текстового домена приводит к false
- Проблемы с локализацией, если не загружен текстовый домен
