# get_header_video_settings()

URL: https://chugunov.pro/api-wordpress/functions/get_header_video_settings/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 4.7.0.

## Сигнатура

```php
get_header_video_settings(): array
```

## Описание

Получает настройки видео шапки.

## Возвращаемое значение

`array`

## Исходный код

Файл: `wp-includes/theme.php:1707`

```php
function get_header_video_settings() {
	$header     = get_custom_header();
	$video_url  = get_header_video_url();
	$video_type = wp_check_filetype( $video_url, wp_get_mime_types() );

	$settings = array(
		'mimeType'  => '',
		'posterUrl' => get_header_image(),
		'videoUrl'  => $video_url,
		'width'     => absint( $header->width ),
		'height'    => absint( $header->height ),
		'minWidth'  => 900,
		'minHeight' => 500,
		'l10n'      => array(
			'pause'      => __( 'Pause' ),
			'play'       => __( 'Play' ),
			'pauseSpeak' => __( 'Video is paused.' ),
			'playSpeak'  => __( 'Video is playing.' ),
		),
	);

	if ( preg_match( '#^https?://(?:www\.)?(?:youtube\.com/watch|youtu\.be/)#', $video_url ) ) {
		$settings['mimeType'] = 'video/x-youtube';
	} elseif ( ! empty( $video_type['type'] ) ) {
		$settings['mimeType'] = $video_type['type'];
	}

	/**
	 * Filters header video settings.
	 *
	 * @since 4.7.0
	 *
	 * @param array $settings An array of header video settings.
	 */
	return apply_filters( 'header_video_settings', $settings );
}
```

## История изменений

- 4.7.0 — Introduced.

## Связанные

Использует: [`get_header_video_url`](https://chugunov.pro/api-wordpress/functions/get_header_video_url/), [`get_custom_header`](https://chugunov.pro/api-wordpress/functions/get_custom_header/), [`get_header_image`](https://chugunov.pro/api-wordpress/functions/get_header_image/), [`wp_check_filetype`](https://chugunov.pro/api-wordpress/functions/wp_check_filetype/), [`wp_get_mime_types`](https://chugunov.pro/api-wordpress/functions/wp_get_mime_types/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`absint`](https://chugunov.pro/api-wordpress/functions/absint/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: `WP_Customize_Manager::export_header_video_settings`, [`the_custom_header_markup`](https://chugunov.pro/api-wordpress/functions/the_custom_header_markup/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/get_header_video_settings/