# add_custom_background()

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

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

> Устаревший элемент. Помечен устаревшим с версии 3.4.0.

## Сигнатура

```php
add_custom_background( callable $wp_head_callback = '', callable $admin_head_callback = '', callable $admin_preview_callback = '' )
```

## Описание

См. alsoadd_theme_support()

## Параметры

- `$wp_head_callback` `callable` — необязательный, по умолчанию `''`. Вызывается на действии 'wp_head'.
- `$admin_head_callback` `callable` — необязательный, по умолчанию `''`. Вызывается на экране администрирования произвольного фона.
- `$admin_preview_callback` `callable` — необязательный, по умолчанию `''`. Выводит div с произвольным фоновым изображением на экране администрирования произвольного фона. Необязательный.

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

Файл: `wp-includes/deprecated.php:3046`

```php
function add_custom_background( $wp_head_callback = '', $admin_head_callback = '', $admin_preview_callback = '' ) {
	_deprecated_function( __FUNCTION__, '3.4.0', 'add_theme_support( \'custom-background\', $args )' );
	$args = array();
	if ( $wp_head_callback )
		$args['wp-head-callback'] = $wp_head_callback;
	if ( $admin_head_callback )
		$args['admin-head-callback'] = $admin_head_callback;
	if ( $admin_preview_callback )
		$args['admin-preview-callback'] = $admin_preview_callback;
	return add_theme_support( 'custom-background', $args );
}
```

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

- 3.4.0 — Deprecated. Use add_theme_support()
- 3.0.0 — Introduced.

## Связанные

Использует: [`add_theme_support`](https://chugunov.pro/api-wordpress/functions/add_theme_support/), [`_deprecated_function`](https://chugunov.pro/api-wordpress/functions/_deprecated_function/).

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