Функция wp_get_custom_css() в WordPress с примерами

Функция wp_get_custom_css() используется для получения пользовательских CSS-стилей, которые были добавлены в разделе «Дополнительные стили» в Кастомайзере. Эти стили сохраняются в базе данных и могут быть получены для использования в шаблонах или других местах темы.

wp_get_custom_css( string $stylesheet = '' ): string

Параметры:

• $stylesheet (необязательный) — Название файла стилей текущей темы. По умолчанию используется активная тема.

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

• string — Пользовательский CSS-код, сохранённый в настройках темы. Функция возвращает только сам CSS-код без обёртки в теги <style>.

Пример 1: Получение пользовательских стилей из кастомайзера

Допустим, в Кастомайзере темы, в разделе «Дополнительные стили», вы добавили несколько кастомных CSS-правил. С помощью wp_get_custom_css() можно получить эти стили для дальнейшего использования.

$custom_css = wp_get_custom_css();
echo '<style>' . $custom_css . '</style>';

Этот код выводит стили, сохранённые в кастомайзере, и оборачивает их в тег <style>, что позволяет их сразу использовать на странице.

Пример 2: Получение стилей для определённой темы

Если вы хотите получить кастомные стили для определённой темы, можно указать её название в качестве параметра $stylesheet. Это может быть полезно, если вы работаете с дочерними темами или хотите получить стили другой активной темы.

$custom_css = wp_get_custom_css( 'my-theme' );
echo '<style>' . $custom_css . '</style>';

В данном примере стили будут получены для темы с названием my-theme, даже если она не активна в данный момент.

Пример 3: Использование CSS в шаблоне без обёртки

Иногда может потребоваться получить пользовательские стили для использования в каком-то другом контексте, например, для передачи их в JavaScript или для обработки перед выводом:

$custom_css = wp_get_custom_css();
if ( ! empty( $custom_css ) ) {
    // Выполняем какие-то действия с CSS
    error_log( 'Custom CSS: ' . $custom_css );
}

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

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

Если вы хотите сразу вывести стили в теге <style> без необходимости вручную оборачивать их, WordPress предоставляет функцию wp_custom_css_cb(), которая выводит пользовательские стили автоматически. Она используется в основном через хук wp_head.

Пример:

add_action( 'wp_head', 'wp_custom_css_cb' );

Заключение

Функция wp_get_custom_css() полезна для получения пользовательских стилей, сохранённых через Кастомайзер. Она позволяет гибко использовать эти стили в шаблонах и темах, предоставляя доступ к CSS-коду напрямую. Это удобный способ интеграции пользовательских настроек стилей в код темы без необходимости повторного редактирования файлов стилей.