get_header_image() │ WP 2.1.0

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

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

Используйте header_image(), когда нужно вывести УРЛ на экран, а не получить его для обработки.

Работает на основе: get_theme_mod()

Основа для: header_image()

Хуки из функции

get_header_image

Возвращает

Строку|false. Пустая строка будет возвращена если:

текущая тема не поддерживает картинку-шапку. Как включить такую поддержку читайте здесь: add_theme_support().
для текущей темы не установлена картинка заголовка. Устанавливается она в настройках: Внешний вид > Customize (Appearance > Customize).

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

get_header_image();

Примеры

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

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

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

С версии 2.1.0

Введена.

Код `get_header_image() get header image` ^{WP 6.5.2}

wp-includes/theme.php

function get_header_image() {
	$url = get_theme_mod( 'header_image', get_theme_support( 'custom-header', 'default-image' ) );

	if ( 'remove-header' === $url ) {
		return false;
	}

	if ( is_random_header_image() ) {
		$url = get_random_header_image();
	}

	/**
	 * Filters the header image URL.
	 *
	 * @since 6.1.0
	 *
	 * @param string $url Header image URL.
	 */
	$url = apply_filters( 'get_header_image', $url );

	if ( ! is_string( $url ) ) {
		return false;
	}

	$url = trim( $url );
	return sanitize_url( set_url_scheme( $url ) );
}

get_header_image() │ WP 2.1.0

Хуки из функции

Возвращает

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

Примеры

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

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

Код get_header_image() get header image WP 6.5.2

Cвязанные функции

theme_support

custom_header (настройки шапки темы: картинка цвет видео)

Другие функции темы

Код `get_header_image() get header image` ^{WP 6.5.2}