Описание функции background_image()
Функция background_image() устанавливает или получает фоновое изображение для темы. Она используется в настройках кастомизации WordPress и позволяет пользователям выбирать изображения для фонового оформления сайта.
Функция поддерживает различные форматы изображений и может быть использована для настройки фона в реальном времени в кастомизаторе тем.
Параметры
$image
Тип: string
Обязательный: Нет
По умолчанию: null
Описание: URL фонового изображения
Возможные значения:
string: URL изображения или путь к изображению в медиа-библиотеке
Возвращаемое значение
Тип: string|null
Описание: URL фонового изображения или null, если изображение не установлено
Возможные значения:
• URL фонового изображения при успешном выполнении
• null если фон не установлен
Примеры использования
Базовый пример установки фонового изображения
$background_image = background_image('https://example.com/image.jpg');
// Вывод результата
echo $background_image; // https://example.com/image.jpg
URL изображения должен быть действительным
Получение установленного фонового изображения
$background_image = background_image();
if ($background_image) {
echo 'Фоновое изображение установлено: ' . $background_image;
} else {
echo 'Фоновое изображение не установлено';
}
Проверяем, установлено ли изображение
Безопасность
Валидация входных данных: Параметр изображения должен быть проверен на корректность URL
Санитизация: URL изображения автоматически очищается WordPress
Рекомендации: Используйте esc_url() при выводе URL изображений
— Связанные функции
Получает модификации темы, включая фоновые изображения
Устанавливает модификации темы, включая фоновые изображения
— Хуки
Фильтрует значение фонового изображения перед его сохранением
— Примечания
– Ограничения
Функция требует, чтобы изображение было загружено в медиа-библиотеку
– Частые проблемы
- Некорректный URL может привести к отсутствию изображения
- Проблемы с отображением на мобильных устройствах при больших изображениях
