get_header_image_tag() WP 4.4.0
Создает IMG тег с картинкой заголовка установленной в настройках темы (кастомайзере).
Основа для: get_custom_header_markup()
Хуки из функции
Возвращает
Строку. 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" />
Список изменений
С версии 4.4.0 | Введена. |