Описание функции get_parent_theme_file_uri()
Функция get_parent_theme_file_uri() возвращает URI файла из родительской темы, если активна дочерняя тема. Это полезно для получения URL-адресов ресурсов, таких как стили и скрипты, находящихся в родительской теме, при использовании дочерних тем. Функция позволяет избежать необходимости указывать полный путь к ресурсам родительской темы.
Если файл не существует, функция вернет пустую строку.
Параметры
$file
Тип: string
Обязательный: Да
Описание: Путь к файлу относительно корня темы
Возможные значения:
Возвращаемое значение
Тип: string
Описание: URI файла из родительской темы
Возможные значения:
• URI файла в формате строки
• Пустая строка, если файл не найден
Примеры использования
Базовый пример получения URI файла стилей
$uri = get_parent_theme_file_uri('css/style.css');
// echo $uri; // Выводит URI файла
Подразумевается, что файл существует в родительской теме
Проверка существования файла перед его использованием
$uri = get_parent_theme_file_uri('images/logo.png');
if ( ! empty($uri) ) {
// echo $uri; // Файл существует
} else {
// echo 'Файл не найден';
}
В случае отсутствия файла будет выведено сообщение
Безопасность
Валидация входных данных: Параметр ‘file’ проверяется на корректность внутри функции
Санитизация: Функция автоматически очищает путь к файлу
Рекомендации: При выводе URI используйте esc_url() для безопасности
— Связанные функции
Получает URI файла из текущей активной темы
Получает URI директории дочерней темы
— Примечания
– Ограничения
Функция работает только с дочерними темами, в противном случае возвращает URI родительской темы
– Частые проблемы
- Пустой результат при неверно указанном пути к файлу
- Необходимо наличие активной дочерней темы для использования
