get_background_image()
Отримує URL-адресу фонового зображення, встановленого в налаштуваннях теми (в кастомайзері).
Щоб встановити фонове зображення, потрібно включити підтримку такого зображення для теми. Це робиться функцією add_theme_support(‘custom-background’) . Після увімкнення можливості в кастомайзері можна буде встановити фонове зображення:
Використовуйте background_image() , коли потрібно відразу вивести URL-адресу на екран.
Дивіться також аналогічну функцію отримання кольору background_color() .
Різні опції теми пов’язані з тлом теми:
$position_x = get_theme_mod( 'background_position_x', get_theme_support( 'custom-background', 'default-position-x' ) ); $position_y = get_theme_mod( 'background_position_y', get_theme_support( 'custom-background', 'default-position-y' ) ); $size = get_theme_mod( 'background_size', get_theme_support( 'custom-background', 'default-size' ) ); $repeat = get_theme_mod( 'background_repeat', get_theme_support( 'custom-background', 'default-repeat' ) ); $attachment = get_theme_mod( 'background_attachment', get_theme_support( 'custom-background', 'default-attachment' ) );
Основа для:
background_image()
background_image()
1 раз – 0.004724 сек
(дуже повільно) | 50000 разів – 4.45 сек
(швидко) |
PHP 7.2.5, WP 5.0
(дуже повільно) | 50000 разів – 4.45 сек
(швидко) |
PHP 7.2.5, WP 5.0
Хуків немає.
Повертає
Строку. URL фонового зображення
Використання
get_background_image();
Приклади
#1 Демонстрація роботи функції
$background_image = get_background_image(); echo $background_image; // http://example.com/wp-content/uploads/2015/04/Big_image_Pumkins.jpg
#2 Виведемо URL у css стилях
<style>
body.custom-background { background-image: url('<?php background_image(); ?>'); }
</style>#3 Фонове зображення теми як запасний варіант, коли мініатюра запису не встановлена
Цей приклад показує, як використовувати мініатюру запису як фон для сторінки, і якщо зображення для запису не встановлено за замовчуванням брати картинку з налаштувань теми.
<head>
<meta http-equiv="Content-Type" content="<?php bloginfo('html_type'); ?>; charset=<?php bloginfo('charset'); ?>" />
<?php if ( is_singular() ) wp_enqueue_script( 'comment-reply' ); ?>
<?php wp_head() ?>
<?php
// declara $post global if used outside of the loop
global $post;
// check to see if the theme supports Featured Images, and one is set
if ( current_theme_supports( 'post-thumbnails' ) && has_post_thumbnail( $post->ID ) ) {
/ / specify desired image size in place of 'full'
$page_bg_image = wp_get_attachment_image_src( get_post_thumbnail_id( $post->ID ), 'full' );
$page_bg_image_url = $page_bg_image[0]; // this returns just the URL of the image
}
else {
// the fallback – our current active theme's default bg image
$page_bg_image_url = get_background_image();
}
// And below, spit out the <style> tag...
?>
<style type="text/css" id="custom-background-css-override">
body.custom-background { background-image: url('<?php echo $page_bg_image_url; ?>'); }
</style>
</head>
список змін
| З версії 3.0.0 | Введено. |
Код get_background_image() get background image WP 6.0.2
function get_background_image() {
return get_theme_mod( 'background_image', get_theme_support( 'custom-background', 'default-image' ) );
}