get_header_video_url() │ WP 4.7.0

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

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

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

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

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

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

Возвращает

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

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

get_header_video_url();

Примеры

1

#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://example.com/wp-content/uploads/2017/01/polina.mp4?_=1" />
		<a href="http://example.com/wp-content/uploads/2017/01/polina.mp4">http://example.com/wp-content/uploads/2017/01/polina.mp4</a>
	</video>
</div>

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

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

Код get_header_video_url() WP 7.0

wp-includes/theme.php 
function get_header_video_url() {
	$id = absint( get_theme_mod( 'header_video' ) );

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

	/**
	 * 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 sanitize_url( set_url_scheme( $url ) );
}

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

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