Функция wp_custom_css_cb() отвечает за вывод CSS-стилей, добавленных пользователями через интерфейс кастомизации WordPress. Эти стили отображаются внутри HTML-тега <style> в разделе <head> вашего сайта. Функция автоматически вызывается в процессе выполнения wp_head, обеспечивая, что дополнительные стили всегда присутствуют на странице.
wp_custom_css_cb();Возвращаемое значение
Возвращает null, так как функция предназначена только для вывода HTML-кода стилей на экран.
Как работает
Перед выводом CSS-код очищается с помощью функции strip_tags(), что предотвращает возможные уязвимости, связанные с внедрением HTML-тегов.
Если вам нужно просто получить CSS-код, не выводя его на экран, вы можете использовать функцию wp_get_custom_css().
Пример 1: Стандартное использование
В WordPress по умолчанию функция wp_custom_css_cb() подключается к хуку wp_head, что позволяет автоматически выводить дополнительные стили в <head> части документа. Это делается следующим образом:
add_action('wp_head', 'wp_custom_css_cb', 101);
При добавлении этого кода в файл functions.php вашей темы вы обеспечиваете, что дополнительные стили, введенные пользователями через кастомайзер, будут автоматически отображаться на сайте.
Пример 2: Ручной вызов функции
Вы также можете вызывать функцию wp_custom_css_cb() в любом месте вашего кода, если хотите вывести стили в определенном месте. Например:
if (is_single()) {
wp_custom_css_cb(); // Выводим стили только на одиночных страницах постов
}Пример 3: Получение CSS без вывода
Если вам нужно просто получить стили в виде строки, а не выводить их, используйте wp_get_custom_css(). Например:
$custom_css = wp_get_custom_css();Это может быть полезно, если вы хотите обработать или использовать CSS-код по-другому, например, для динамического создания стилей в другом месте вашего кода.
Заключение
Функция wp_custom_css_cb() является важным инструментом для тем WordPress, позволяя пользователям настраивать внешний вид своих сайтов с помощью дополнительных CSS-стилей. Она автоматизирует процесс отображения кастомизированного CSS, что облегчает задачу для разработчиков и пользователей.