# get_custom_header()

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

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

## Сигнатура

```php
get_custom_header(): object
```

## Описание

Получает данные изображения заголовка.

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

`object`

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

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

```php
function get_custom_header() {
	global $_wp_default_headers;

	if ( is_random_header_image() ) {
		$data = _get_random_header_data();
	} else {
		$data = get_theme_mod( 'header_image_data' );
		if ( ! $data && current_theme_supports( 'custom-header', 'default-image' ) ) {
			$directory_args        = array( get_template_directory_uri(), get_stylesheet_directory_uri() );
			$data                  = array();
			$data['url']           = vsprintf( get_theme_support( 'custom-header', 'default-image' ), $directory_args );
			$data['thumbnail_url'] = $data['url'];
			if ( ! empty( $_wp_default_headers ) ) {
				foreach ( (array) $_wp_default_headers as $default_header ) {
					$url = vsprintf( $default_header['url'], $directory_args );
					if ( $data['url'] === $url ) {
						$data                  = $default_header;
						$data['url']           = $url;
						$data['thumbnail_url'] = vsprintf( $data['thumbnail_url'], $directory_args );
						break;
					}
				}
			}
		}
	}

	$default = array(
		'url'           => '',
		'thumbnail_url' => '',
		'width'         => get_theme_support( 'custom-header', 'width' ),
		'height'        => get_theme_support( 'custom-header', 'height' ),
		'video'         => get_theme_support( 'custom-header', 'video' ),
	);
	return (object) wp_parse_args( $data, $default );
}
```

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

- 3.4.0 — Introduced.

## Связанные

Использует: [`get_theme_support`](https://chugunov.pro/api-wordpress/functions/get_theme_support/), [`is_random_header_image`](https://chugunov.pro/api-wordpress/functions/is_random_header_image/), [`_get_random_header_data`](https://chugunov.pro/api-wordpress/functions/_get_random_header_data/), [`get_theme_mod`](https://chugunov.pro/api-wordpress/functions/get_theme_mod/), [`get_template_directory_uri`](https://chugunov.pro/api-wordpress/functions/get_template_directory_uri/), [`get_stylesheet_directory_uri`](https://chugunov.pro/api-wordpress/functions/get_stylesheet_directory_uri/), [`current_theme_supports`](https://chugunov.pro/api-wordpress/functions/current_theme_supports/), [`wp_parse_args`](https://chugunov.pro/api-wordpress/functions/wp_parse_args/).
Используется в: [`get_header_video_settings`](https://chugunov.pro/api-wordpress/functions/get_header_video_settings/), [`get_header_image_tag`](https://chugunov.pro/api-wordpress/functions/get_header_image_tag/), `Custom_Image_Header::step_1`.

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