Проверка наличия пользовательского заголовка в WordPress
Введение
Функция has_custom_header() предназначена для проверки, установлен ли пользовательский заголовок (например, изображение или видео) для вашего сайта на WordPress. Эта функция появилась в версии 4.7.0.
Как работает функция
Функция has_custom_header() возвращает логическое значение (true или false). Она будет возвращать true, если пользовательский заголовок установлен, и false, если его нет.
Общее время выполнения
- 1 раз: 0.000148 сек (быстро)
- 50000 раз: 2.97 сек (быстро)
Пример использования
Чтобы проверить, есть ли пользовательский заголовок, выполните следующий код:
if ( has_custom_header() ) {
the_custom_header_markup();
}Что произойдет
Если есть пользовательский заголовок (изображение или видео), функция the_custom_header_markup() выведет HTML-код заголовка.
Примеры выводимого HTML-кода
Изображение
Если установлен пользовательский заголовок-изображение, вывод будет следующим:
Видео
Если установлен заголовок-видео, HTML-код будет выглядеть так:
Скрипты
Кроме того, внизу страницы будут подключены необходимые скрипты для работы с видео:
Как работает функция
Давайте взглянем на реализацию функции has_custom_header():
function has_custom_header() {
if ( has_header_image() || ( has_header_video() && is_header_video_active() ) ) {
return true;
}
return false;
}Что делает код?
- Проверяет, установлено ли изображение заголовка с помощью
has_header_image(). - Если заголовок — это видео, также проверяется, активен ли он с помощью
is_header_video_active(). - Если одно из условий истинно, функция возвращает true. В противном случае — false.
Заключение
Функция has_custom_header() — это простой и удобный способ проверки наличия пользовательского заголовка на сайте WordPress. Понимание ее работы и применение поможет вам улучшить пользовательский интерфейс и внешний вид вашего сайта.
Теперь вы знаете, как использовать эту функцию и как она работает. Удачи в создании вашего сайта на WordPress!