header_image()WP 2.1.0

Выводит на экран УРЛ картинки шапки (заголовка), которая устанавливается в настройках темы.

Перед выводом URL очищается через esc_url().

Работает только когда у темы есть возможность устанавливать картинку-шапку.

Используйте get_header_image(), когда нужно получить URL в переменную.

1 раз — 0.005023 сек (очень медленно) | 50000 раз — 3.03 сек (быстро)

Хуков нет.

Возвращает

null. Ничего не выведет если:

  • текущая тема не поддерживает картинку-шапку. Как включить такую поддержку читайте здесь: add_theme_support().

  • для текущей темы не установлена картинка заголовка. Устанавливается она в настройках: Внешний вид > Customize (Appearance > Customize).

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

header_image();

Примеры

0

#1 Выведем img тег картинки для шапки сайта

<img src="<?php header_image(); ?>" alt="<?php bloginfo('title'); ?>">

Список изменений

С версии 2.1.0 Введена.

Код header_image() WP 6.1.1

function header_image() {
	$image = get_header_image();

	if ( $image ) {
		echo esc_url( $image );
	}
}