Функция header_image() в WordPress
header_image() — это функция, которая отображает URL заглавного изображения вашего сайта на WordPress. В этой статье мы рассмотрим, как использовать эту функцию, её возможности и примеры.
Как работает header_image()
Функция header_image() использует другую функцию — get_header_image(), чтобы получить ссылку на заглавное изображение. Если изображение установлено, оно будет выведено. Если изображения нет, функция ничего не вернёт.
Время выполнения функции
- 1 раз: 0.005023 секунды (очень медленно)
- 50,000 раз: 3.03 секунды (быстро)
Возврат значения
Функция возвращает null, если заглавное изображение не установлено.
Использование
Чтобы использовать header_image(), просто вызовите её так:
header_image();Пример
Чтобы отобразить изображение в заголовке, вы можете использовать следующий код:
Заметка
В данном примере функция header_image() используется внутри атрибута src тега изображения. Так заглавное изображение будет автоматически подставлено на ваше место.
Изменения и версия
Функция header_image() была введена в версии 2.1.0 WordPress.
Код функции
Вот как выглядит эта функция в файле theme.php:
function header_image() {
$image = get_header_image();
if ( $image ) {
echo esc_url( $image );
}}
Связанные функции
При работе с заглавными изображениями в WordPress, вы можете использовать и другие функции:
Поддержка тем (Theme Support)
add_theme_support()current_theme_supports()get_header_image()get_header_textcolor()get_theme_support()has_header_image()remove_theme_support()
Пользовательские заголовки (Custom Header)
get_custom_header_markup()get_header_image_tag()get_header_video_url()has_custom_header()has_header_video()is_header_video_active()the_custom_header_markup()the_header_video_url()
Другие функции тем
bloginfo()body_class()get_custom_logo()get_page_template()get_page_templates()- и другие.
Эти функции помогут вам эффективно управлять заглавными изображениями и другими аспектами вашего сайта на WordPress.