eurobyte.ru - мощные сервера с Дата-центрами в Нидерландах и Москве. От 159 ₽/мес.
Kama2.5 лет назад2 EN

get_header_image() │ WP 2.1.0

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

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

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

Работает на основе: get_theme_mod()
Основа для: header_image()
Хуки из функции

Возвращает

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

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

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

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

get_header_image();

Примеры

0

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

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

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

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

Код get_header_image() WP 6.7.1

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 ) );
}

theme_support

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

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

2 комментария
    Войти