Описание функции load_child_theme_textdomain()
Функция load_child_theme_textdomain() используется для загрузки текстового домена дочерней темы, что позволяет локализовать её интерфейс. Это необходимо для поддержки многоязычности и перевода текстов в теме.
Эта функция должна вызываться в функции setup_theme или init для корректной работы.
Параметры
$domain
Тип: string
Обязательный: Да
По умолчанию: none
Описание: Уникальный текстовый домен для вашей темы
Возможные значения:
$path
Тип: string
Обязательный: Нет
По умолчанию: get_stylesheet_directory() . ‘/languages’
Описание: Путь к каталогу с файлами перевода относительно корневой директории WordPress
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если текстовый домен успешно загружен
Возможные значения:
• true при успешной загрузке
• false если не удалось загрузить текстовый домен
Примеры использования
Простой вызов функции для загрузки текстового домена
add_action('after_setup_theme', 'my_theme_setup');
function my_theme_setup() {
load_child_theme_textdomain('my_child_theme');
}
Вызывается в хуке after_setup_theme
Загрузка текстового домена с указанием пользовательского пути к языковым файлам
add_action('after_setup_theme', 'my_theme_setup');
function my_theme_setup() {
load_child_theme_textdomain('my_child_theme', get_stylesheet_directory() . '/lang');
}
Убедитесь, что папка существует и содержит файлы перевода
Безопасность
Валидация входных данных: Текстовый домен проверяется на корректность
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Используйте уникальные текстовые домены для предотвращения конфликтов
— Связанные функции
Загружает текстовый домен для основной темы
Получает текущий текстовый домен
— Примечания
– Ограничения
Функция должна вызываться после загрузки темы
– Частые проблемы
- Отсутствие файлов перевода в указанной директории
- Неправильный текстовый домен, который не совпадает с загруженным
