WordPress как на ладони
wordpress jino

get_header_video_url() WP 4.7.0

Получает URL видео заголовка указанного в настройках (кастомайзере).

Функция получает ссылку на локальное видео, если его нет, но есть ссылка на внешнее видео, то вернет эту ссылку. Вернет false если нет никакого видео.

С версии 4.7 появилась возможно устанавливать видео заголовка, в дополнении к картинке заголовка.

Эта функция лежит в основе проверки: есть ли видео у заголовка - has_header_video()

Используйте the_header_video_url(), когда URL сразу нужно вывести на экран.

Используется в: the_header_video_url(), has_header_video().
Работает на основе: get_theme_mod(), wp_get_attachment_url()
Хуки из функции:
Возвращает

Строку/false. URL на видео или false.

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

get_header_video_url();

Примеры

#1 Выведем видео заголовка если оно есть

$url = get_header_video_url();
if( $url ){
	echo wp_video_shortcode( array(
		'src'      => $url,
		'poster'   => '',
		'height'   => 400,
		'width'    => 600,
	) );
}

В результате получим такой HTML код:

<div style="width:600px;" class="wp-video">
	<!--[if lt IE 9]><script>document.createElement('video');</script><![endif]-->
	<video class="wp-video-shortcode" id="video-298-1" width="600" height="400" preload="metadata" controls="controls">
		<source type="video/mp4" src="http://wptest.ru/wp-content/uploads/2017/01/polina.mp4?_=1" />
		<a href="http://wptest.ru/wp-content/uploads/2017/01/polina.mp4">http://wptest.ru/wp-content/uploads/2017/01/polina.mp4</a>
	</video>
</div>

Код get header video url: wp-includes/theme.php VER 4.9.1

<?php
function get_header_video_url() {
	$id = absint( get_theme_mod( 'header_video' ) );
	$url = esc_url( get_theme_mod( 'external_header_video' ) );

	if ( $id ) {
		// Get the file URL from the attachment ID.
		$url = wp_get_attachment_url( $id );
	}

	/**
	 * Filters the header video URL.
	 *
	 * @since 4.7.3
	 *
	 * @param string $url Header video URL, if available.
	 */
	$url = apply_filters( 'get_header_video_url', $url );

	if ( ! $id && ! $url ) {
		return false;
	}

	return esc_url_raw( set_url_scheme( $url ) );
}

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

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

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

get_header_video_url Комментариев нет

Здравствуйте, !

Ваш комментарий