## Функция BACKGROUND_IMAGE() │ WP 3.0.0
Функция background_image() позволяет получить путь к изображению фона для вашего сайта на WordPress.
### Использование
Функция использует еще одну функцию — get_background_image().
### Производительность
- Время выполнения один раз: 0.002051 сек (очень медленно)
- Время выполнения 50000 раз: 1.90 сек (быстро)
- Версия PHP: 7.2.5, Версия WP: 5.0
### Возвращаемое значение
Функция возвращает null, что означает, что не будет ничего отображено, если изображение фона не установлено.
### Пример использования
Чтобы использовать функцию background_image(), достаточно написать в вашем коде:
```php
background_image();
Пример 1: Вывод URL изображения в CSS
Вот как можно использовать функцию для установки фона в CSS:
Это CSS правило установит фоновое изображение для тела документа, если оно задано.
Изменения в версии
Функция background_image() была введена в версии 3.0.0.
Исходный код функции
Вот как выглядит функция в файле theme.php:
function background_image() {
echo get_background_image();
}
Связанные функции
Если вас интересуют другие функции, связанные с фоном темы, вот некоторые из них:
Функции для работы с фоном темы
- get_background_image(): Получает URL изображения фона вашей темы.
Функции API модификации темы
- get_theme_mod(): Получает значение настройки темы.
- get_theme_mods(): Получает все настройки темы.
- remove_theme_mod(): Удаляет настройку темы.
- remove_theme_mods(): Удаляет все настройки темы.
- set_theme_mod(): Сохраняет настройку темы.
Настройки (Настраиватель)
- has_custom_header(): Проверяет, есть ли пользовательский заголовок.
- is_customize_preview(): Проверяет, находитесь ли вы в режиме предварительного просмотра настроек.
Эти функции помогут вам управлять внешним видом вашего сайта более эффективно.