Получение URI директории стилей в WordPress

Введение

В WordPress есть функция get_stylesheet_directory_uri(), которая возвращает URL-адрес директории стилей текущей дочерней темы. Если вы используете удобствогруппу «родительская тема», использовать нужно функцию get_template_directory_uri().

Что такое дочерняя тема?

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

Как использовать get_stylesheet_directory_uri()

Функция get_stylesheet_directory_uri() просто возвращает строку с URL-адресом директории стилей. Например:

get_stylesheet_directory_uri();

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

1. Отображение изображения из директории темы:

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

2. Подключение CSS-стилей:

add_action( 'wp_enqueue_scripts', 'my_scripts_method' );

function my_scripts_method() {
    $url = get_stylesheet_directory_uri() . '/js/custom_script.js';
    wp_enqueue_script( 'custom_script', $url, [ 'jquery' ], '1.0', true );
}

В данном примере мы подключаем файл custom_script.js, который находится в папке js нашей темы.

Пример из жизни

Допустим, у вас есть веб-сайт с адресом: https://example.com/. Ваша активная дочерняя тема называется mytheme-child, а родительская тема — mytheme. Функция get_stylesheet_directory_uri() вернет следующую строку:

https://example.com/wp-content/themes/mytheme-child

Обратите внимание, что в итоговом URL нет слеша в конце.

Код функции get_stylesheet_directory_uri()

Вот как выглядит код функции в WordPress:

function get_stylesheet_directory_uri() {
$stylesheet = str_replace( '%2F', '/', rawurlencode( get_stylesheet() ) );
$theme_root_uri = get_theme_root_uri( $stylesheet );
$stylesheet_dir_uri = "$theme_root_uri/$stylesheet";

/**
 * Фильтры для URI директории стилей.
 *
 * @since 1.5.0
 *
 * @param string $stylesheet_dir_uri URI директории стилей.
 * @param string $stylesheet         Имя директории активной темы.
 * @param string $theme_root_uri     Корень URI тем.
 */
return apply_filters( 'stylesheet_directory_uri', $stylesheet_dir_uri, $stylesheet, $theme_root_uri );

}

Примечание

Эта функция была добавлена в WordPress начиная с версии 1.5.0.

Заключение

Функция get_stylesheet_directory_uri() — это полезный инструмент для получения URL-адреса директории стилей вашей темы в WordPress. Подключение стилей и изображений станет проще благодаря этой функции. Используйте её, чтобы упростить процесс разработки и сделать ваши проекты более организованными.