Функция GET_STYLESHEET_DIRECTORY() │ WP 1.5.0

Функция GET_STYLESHEET_DIRECTORY() возвращает путь к папке со стилями текущей темы WordPress.

Использование

Функция использует:

• get_stylesheet(): для получения названия текущей темы.
• get_theme_root(): для получения основного пути к папке с темами.

Когда это нужно?

Эта функция полезна, когда вы хотите получить доступ к файлам темы, находящимся в директории стилей.

Применение

get_stylesheet_directory();

Примеры

Пример 1: Получение пути к директории стилей

echo get_stylesheet_directory();
// вывод: /home/k/kama/example.com/public_html/wp-content/themes/themename

Пример 2: Подключение файла myfile.php в текущей теме

Этот пример покажет, как использовать функцию для подключения файла в родительской теме, чтобы поддерживать дочернюю тему:

require_once get_stylesheet_directory() . '/includes/myfile.php';

Хуки функции

Функция имеет один хук, который можно использовать для изменения пути к директории стилей:

• stylesheet_directory

Возвращаемое значение

Функция возвращает строку. Это абсолютный путь к директории с стилями активной темы.

Код функции

Функция get_stylesheet_directory() определена в файле wp-includes/theme.php:

function get_stylesheet_directory() {
$stylesheet = get_stylesheet();
$theme_root = get_theme_root( $stylesheet );
$stylesheet_dir = "$theme_root/$stylesheet";

/**
 * Фильтрует путь к директории стилей активной темы.
 *
 * @since 1.5.0
 *
 * @param string $stylesheet_dir Абсолютный путь к активной теме.
 * @param string $stylesheet     Имя директории активной темы.
 * @param string $theme_root     Абсолютный путь к директории тем.
 */
return apply_filters( 'stylesheet_directory', $stylesheet_dir, $stylesheet, $theme_root );

}

Связанные функции

Вот несколько функций, которые могут вам помочь при работе с директориями тем:

• get_parent_theme_file_path()
• get_parent_theme_file_uri()
• get_stylesheet_directory_uri()
• get_template_directory()
• get_template_directory_uri()
• get_theme_file_path()
• get_theme_file_uri()
• get_theme_root()
• get_theme_root_uri()
• register_theme_directory()

Эта статья объясняет, как использовать функцию GET_STYLESHEET_DIRECTORY() и как она работает в контексте WordPress. Если вы новичок, не беспокойтесь! Со временем вы освоите работу с темами и функциями WordPress.