Функция GET_STYLESHEET_URI() в WordPress

Что это такое?

Функция get_stylesheet_uri() в WordPress помогает получить URL файла стилей текущей темы. Этот файл называется style.css, поэтому функция использует другую функцию — get_stylesheet_directory_uri() — чтобы получить путь к папке темы и добавляет к нему название файла.

Если вы используете дочернюю тему, эта функция вернёт URL именно для дочерней темы, а не родительской.

Как работает функция

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

• get_stylesheet_directory_uri()

Время выполнения: 1 раз — 0.000039 сек (очень быстро) | 50000 раз — 0.78 сек (также быстро) | PHP 7.0.2, WP 4.4.2

Хуки функции

• stylesheet_uri — хук, который можно использовать для изменения URL файла стилей.

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

Функция возвращает строку — URL файла стилей style.css текущей темы.

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

Чтобы вызвать эту функцию, просто используйте:

get_stylesheet_uri();

Примеры использования

Пример 1: Получение URL стилей текущей темы

echo get_stylesheet_uri(); 
// вывод: http://example.com/wp-content/themes/example-theme/style.css

Пример 2: Подключение файла стилей темы

Если вы хотите подключить файл стилей (CSS), воспользуйтесь функцией wp_enqueue_style():

add_action('wp_enqueue_scripts', 'enqueue_mytheme_style');
function enqueue_mytheme_style() {
    wp_enqueue_style('theme-style', get_stylesheet_uri());
}

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

Изменение стилей дочерней темы

Вы также можете легко добавлять стили дочерней темы вместе с родительскими стилями.

История изменений

• С версии 1.5.0 — функция была введена.

Код функции

Вот как выглядит код функции get_stylesheet_uri() в файле wp-includes/theme.php:

function get_stylesheet_uri() {
$stylesheet_dir_uri = get_stylesheet_directory_uri();
$stylesheet_uri = $stylesheet_dir_uri . '/style.css';
/**

• Фильтры URI активного файла стилей темы.
• @since 1.5.0
• @param string $stylesheet_uri URI файла стилей активной темы/дочерней темы.
• @param string $stylesheet_dir_uri URI директории файла стилей активной темы/дочерней темы.
  */
  return apply_filters('stylesheet_uri', $stylesheet_uri, $stylesheet_dir_uri);
  }
  

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

Существует несколько других функций, которые могут быть вам полезны при работе с URL в WordPress:

• admin_url()
• attachment_url_to_postid()
• get_home_url()
• get_theme_root_uri()

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