WordPress как на ладони
Недорогой хостинг для сайтов на WordPress: wordpress.jino.ru Рекомендуемые продукты со скидкой от Template Monster

get_header_image() WP 2.1.0

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

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

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

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

Хуков нет.

Возвращает

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

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

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

get_header_image();

Примеры

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

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

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

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

Код get header image: wp-includes/theme.php WP 5.2.4

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

	return esc_url_raw( set_url_scheme( $url ) );
}

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

Из метки: theme_support

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

Еще из раздела: Другие функции темы

3 коммента
  • Артем local

    А если у меня мультисайт и нужно получить список картинок шапок для каждого из сайтов сети?

    Ответить2 года назад #
    • Kama7611

      Получи сайты сети get_sites(), пройдись по полученному массиву, где переключайся на каждый сайт switch_to_blog() и юзай эту функцию...

      Ответить1.7 года назад #
Здравствуйте, !     Войти . Зарегистрироваться