WP_GET_CUSTOM_CSS() │ WP 4.7.0

Функция wp_get_custom_css() помогает получить CSS-код из настроек настройки темы (Theme Customizer). Этот CSS будет возвращён таким, какой он есть, без обёртки в тег <style>.

Где сохраняются стили?

Эти стили хранятся в настройках темы в разделе "Дополнительный CSS" (Additional CSS).

Чтобы вывести пользовательский CSS с обёрткой в тег <style>, используйте функцию wp_get_custom_css().

Эти стили автоматически добавляются WordPress в раздел HEAD вашей темы во время выполнения действия wp_head.

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

Функция wp_get_custom_css() использует другую функцию wp_get_custom_css_post().

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

echo '';

Этот код выведет стили, которые вы добавили в "Дополнительный CSS".

Аргументы функции

Функция имеет следующий синтаксис:

wp_get_custom_css( $stylesheet );

• $stylesheet (строка): Название директории вашей темы. См. функцию get_stylesheet().
  • По умолчанию: текущая тема.

Пример получения пользовательского CSS для темы

Если мы добавили какие-то стили в "Дополнительный CSS" и теперь хотим их отобразить:

echo '';

Изменения

Функция была представлена в версии 4.7.0.

Код функции

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

function wp_get_custom_css( $stylesheet = '' ) {
$css = '';

if ( empty( $stylesheet ) ) {
    $stylesheet = get_stylesheet();
}

$post = wp_get_custom_css_post( $stylesheet );
if ( $post ) {
    $css = $post->post_content;
}

/**
 * Фильтрует вывод пользовательского CSS в элементе head.
 *
 * @since 4.7.0
 *
 * @param string $css        CSS, полученный из поста типа Custom CSS.
 * @param string $stylesheet Название стиля темы.
 */
$css = apply_filters( 'wp_get_custom_css', $css, $stylesheet );

return $css;

}

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

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

• wp_add_inline_style(): Добавляет встроенные стили к существующей таблице стилей.
• wp_enqueue_style(): Подключает таблицы стилей.
• wp_dequeue_style(): Убирает подключенную таблицу стилей.
• wp_enqueue_script(): Подключает JavaScript-файлы.
• wp_dequeue_script(): Убирает подключенные JavaScript-файлы.

Эти функции помогут вам управлять стилями и скриптами в вашей теме.