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

Главная - WordPress Codex - Функция get_header_textcolor() в WordPress с примерами
Доступна с версии: 2.1
Раздел: Тема
Написал: Александр Сокирка

Функция get_header_textcolor() используется для получения пользовательского цвета текста заголовка сайта, установленного в настройках темы. Она возвращает цвет текста в виде строки, содержащей шестизначный или трехзначный HEX-код (без символа #).

Описание

Функция предназначена для использования в темах WordPress, где включена поддержка опций кастомизации заголовка через функцию add_theme_support('custom-header'). Цвет текста можно настроить в кастомайзере, и функция get_header_textcolor() позволяет получить этот цвет.

Если для заголовка не задан пользовательский цвет, функция вернет значение по умолчанию, которое задается через параметр default-text-color при подключении поддержки заголовка.

get_header_textcolor(): string

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

  • Строка: Возвращает цвет текста в HEX-формате (без символа #). Например, cccccc или 333333.
  • Пустая строка: Если поддержка кастомного заголовка не включена, или если текст заголовка выключен.

Получение цвета текста заголовка

Простой пример, который получает цвет текста, установленного в заголовке, и выводит его на экран:

$header_text_color = get_header_textcolor();
echo "Цвет текста внутри шапки равен #". $header_text_color . ".";

Результат:

Цвет текста внутри шапки равен #000000.

Использование цвета заголовка в стилях HTML

Этот пример демонстрирует, как использовать полученный цвет текста заголовка в атрибуте style HTML тега, чтобы динамически задать цвет текста:

<header style="<?php echo sprintf( 'color: #%s;', get_header_textcolor() ); ?>">
    Ваш заголовок
</header>

Результат:

<header style="color: #000000;">
    Ваш заголовок
</header>

Примечания

  • Чтобы полностью настроить кастомизацию заголовка, нужно использовать функцию add_theme_support('custom-header') в файле functions.php темы.
  • Если у темы не включена поддержка пользовательского заголовка, или если для заголовка не задан цвет, функция вернет значение по умолчанию или пустую строку.

Заключение

Функция get_header_textcolor() — это полезный инструмент для получения и использования цвета текста заголовка, что позволяет разработчикам тем WordPress гибко управлять стилями заголовков. Она особенно полезна для динамической настройки внешнего вида сайта, позволяя изменять цвет заголовка через панель кастомайзера.

Стартовая премиум тема для WordPress
Демо импорт тестового контента в 1 клик.
SEO оптимизированный и валидный код.
Множество готовых стартовых сайтов.
Лучшая документация и поддержка.
Опции персонализации контента.
Креативный и современный дизайн.
Тема для WordPress

Дополнительно по: Тема