get_header_image()
Отримує УРЛ картинки шапки (заголовка), яка встановлюється у налаштуваннях теми.
Працює тільки коли тема має можливість встановлювати картинку-шапку .
Використовуйте header_image() , коли потрібно вивести на екран УРЛ, а не отримати його для обробки.
Працює на основі:
get_theme_mod()
get_theme_mod()
Хуків немає.
Повертає
Строку|false
. Порожній рядок буде повернуто якщо:
поточна тема не підтримує картинку-шапку. Як увімкнути таку підтримку читайте тут: add_theme_support() .
- для поточної теми не встановлено зображення заголовка. Встановлюється вона у налаштуваннях:
Внешний вид > Customize
(Appearance > Customize).
Використання
get_header_image();
Приклади
#1 Виведемо img тег картинки для шапки сайту
<img src="<?php echo get_header_image(); ?>" alt="<?php bloginfo('title'); ?>">
список змін
З версії 2.1.0 | Введено. |
Код get_header_image() get header image WP 6.0.2
function get_header_image() { $url = get_theme_mod( 'header_image', get_theme_support( 'custom-header', 'default-image' ) ); if ( 'remove-header' === $url ) { return false; } if ( is_random_header_image() ) { $url = get_random_header_image(); } return esc_url_raw(set_url_scheme($url)); }