Описание функции get_stylesheet_directory()
Функция get_stylesheet_directory() возвращает путь к директории активной дочерней темы (при её наличии) или к директории родительской темы. Это позволяет разработчикам тем безопасно получать доступ к файлам в директории темы.
Функция полезна для подключения стилей, скриптов и изображений, а также для работы с шаблонами
Возвращаемое значение
Тип: string
Описание: Путь к директории активной темы
Возможные значения:
• Строка с абсолютным путем к директории темы
• Возвращает false в случае ошибки
Примеры использования
Базовый пример получения пути к директории текущей темы
$theme_directory = get_stylesheet_directory();
// Вывод: /wp-content/themes/your-theme/
Подключение файла style.css из директории темы
wp_enqueue_style('theme-style', get_stylesheet_directory() . '/style.css');
Получение пути к изображению в директории темы
$image_url = get_stylesheet_directory() . '/images/logo.png';
// Вывод: /wp-content/themes/your-theme/images/logo.png
Безопасность
Валидация входных данных: Нет входных параметров, требующих валидации
Санитизация: Функция возвращает только безопасный путь
Рекомендации: При выводе используйте esc_url() для URL-адресов
— Связанные функции
Возвращает путь к директории родительской темы
Возвращает URL к главному стилю темы
— Примечания
– Ограничения
Работает только в контексте активной темы
– Частые проблемы
- Неправильный путь при ошибках в настройках темы
- Не работает в контексте плагинов без активной темы
