get_header_image_tag() WP 4.4.0

Создает IMG тег с картинкой заголовка установленной в настройках темы (кастомайзере).

Возвращает

Строку. HTML тег <img> или пустую строку, если для заголовка не установлена картинка.

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

$img = get_header_image_tag( $attr );

$attr(массив)

Дополнительные атрибуты для IMG тега. Можно использовать чтобы переписать атрибуты по умолчанию.

По умолчанию указываются такие атрибуты:

array(
	'src'    => $header->url,
	'width'  => $width,
	'height' => $height,
	'alt'    => get_bloginfo( 'name' ),
	'srcset' => '', // генерируется если атрибут пустой
)

По умолчанию: array()

Примеры

#1 Пример вывода тега картинки заголовка

$img = get_header_image_tag();
echo $img;

Выведет:

<img src="http://wptest.ru/wp-content/uploads/2016/05/cropped.jpg" width="954" height="1300" alt="Тестовый сайт"
	srcset="http://wptest.ru/wp-content/uploads/2016/05/cropped.jpg 954w, http://wptest.ru/wp-content/uploads/2016/05/cropped-220x300.jpg 220w, http://wptest.ru/wp-content/uploads/2016/05/cropped-768x1047.jpg 768w, http://wptest.ru/wp-content/uploads/2016/05/cropped-751x1024.jpg 751w"
	sizes="(max-width: 954px) 100vw, 954px"
/>

#2 Укажем атрибуты

Например давайте укажем свой alt и запретим создавать атрибут srcset и в месте с ним sizes

$img = get_header_image_tag( array(
	'srcset' => 'none',
	'alt' => 'картинка заголовка',
) );
echo $img;

Получим:

<img src="http://wptest.ru/wp-content/uploads/2016/05/cropped.jpg" width="954" height="1300" alt="картинка заголовка" srcset="none" />

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

Код get header image tag: wp-includes/theme.php ^{WP 5.3.2}

<?php
function get_header_image_tag( $attr = array() ) {
	$header      = get_custom_header();
	$header->url = get_header_image();

	if ( ! $header->url ) {
		return '';
	}

	$width  = absint( $header->width );
	$height = absint( $header->height );

	$attr = wp_parse_args(
		$attr,
		array(
			'src'    => $header->url,
			'width'  => $width,
			'height' => $height,
			'alt'    => get_bloginfo( 'name' ),
		)
	);

	// Generate 'srcset' and 'sizes' if not already present.
	if ( empty( $attr['srcset'] ) && ! empty( $header->attachment_id ) ) {
		$image_meta = get_post_meta( $header->attachment_id, '_wp_attachment_metadata', true );
		$size_array = array( $width, $height );

		if ( is_array( $image_meta ) ) {
			$srcset = wp_calculate_image_srcset( $size_array, $header->url, $image_meta, $header->attachment_id );
			$sizes  = ! empty( $attr['sizes'] ) ? $attr['sizes'] : wp_calculate_image_sizes( $size_array, $header->url, $image_meta, $header->attachment_id );

			if ( $srcset && $sizes ) {
				$attr['srcset'] = $srcset;
				$attr['sizes']  = $sizes;
			}
		}
	}

	$attr = array_map( 'esc_attr', $attr );
	$html = '<img';

	foreach ( $attr as $name => $value ) {
		$html .= ' ' . $name . '="' . $value . '"';
	}

	$html .= ' />';

	/**
	 * Filters the markup of header images.
	 *
	 * @since 4.4.0
	 *
	 * @param string $html   The HTML image tag markup being filtered.
	 * @param object $header The custom header object returned by 'get_custom_header()'.
	 * @param array  $attr   Array of the attributes for the image tag.
	 */
	return apply_filters( 'get_header_image_tag', $html, $header, $attr );
}

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

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

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