get_header()
Подключает файл шаблона header.php (шапку). Если передан параметр $name, то будет подключен файл header-{name}.php.
Если файл не найден в папке темы, то будет взят дефолтный файл: wp-includes/theme-compat/header.php
.
Работает на основе: locate_template()
Хуки из функции
Возвращает
null|false
. null при удачном подключении файла, false если файла шаблона не существует.
Использование
<?php get_header( $name, $args ); ?>
- $name(строка)
- Индекс названия файла, который нужно подключить: header-{name}.php
По умолчанию: null - $args(массив) (с WP 5.5)
- Дополнительные параметры для подключаемого файла. Используйте переменную $args в подключаемом файле.
По умолчанию: array()
Примеры
#1 Разные файлы header.php (шапки) для разных страниц
Для главной страницы и 404 будут подключены header-home.php
и header-404.php
соответственно.
<?php if ( is_home() ){ get_header('home'); } elseif ( is_404() ) { get_header('404'); } else { get_header(); } ?>
#2 Простой шаблон страницы 404 (код файла шаблона 404.php)
<?php get_header(); ?> <h2>Ошибка 404 - Не найдено</h2> <?php get_sidebar(); ?> <?php get_footer(); ?>
Список изменений
С версии 1.5.0 | Введена. |
С версии 5.5.0 | A return value was added. |
С версии 5.5.0 | The $args parameter was added. |