Функция get_header() в WordPress используется для включения файла шаблона шапки (header) на страницах вашего сайта. Этот файл обычно содержит HTML-код шапки страницы, включая мета-теги, ссылки на стили и скрипты, а также любую другую информацию, которая должна быть включена в начало каждой страницы вашего сайта (метатэг HEAD).
Функция get_header() вызывает файл header.php, который находится в директории вашей темы. Вы также можете указать имя конкретного файла заголовка, если хотите использовать разные заголовки для разных страниц.
get_header( $name = null, $args = array() );Параметры
$name(string, необязательный): Название файла заголовка, который вы хотите включить. Файл будет искаться по шаблонуheader-{name}.php. Если параметр не указан, будет использован файлheader.php. Если такого файла нет в папке темы, то будет подключен стандартный файл/wp-includes/theme-compat/header.php.$args(array, необязательный): Дополнительные параметры для передаваемого файла. Доступно с версии WordPress 5.5.
Возвращаемое значение
- null: При успешном подключении файла.
- false: Если файл шаблона не существует.
Простейший пример без параметров
<?php
get_header();
?>Этот вызов функции включит стандартный файл заголовка header.php.
Использование с указанием имени файла заголовка
Предположим, у нас есть специальный заголовок для главной страницы сайта, который хранится в файле header-home.php:
<?php
get_header('home');
?>Этот вызов функции включит файл заголовка header-home.php.
Пример с использованием условных тегов
Более сложный пример, где используются условные теги is_single() и is_page(). В этом примере у нас будут два специальных заголовка для постов и страниц: header-post.php и header-page.php соответственно. Для остальных страниц будет использоваться стандартный заголовок header.php:
<?php
if ( is_single() ) {
get_header('post'); // header-post.php
} elseif ( is_page() ) {
get_header('page'); // header-page.php
} else {
get_header(); // header.php
}
?>Пример с дополнительными параметрами
С версии WordPress 5.5 можно передавать дополнительные параметры в подключаемый файл:
<?php
$args = array( 'key' => 'value' );
get_header( 'custom', $args );
?>В подключаемом файле header-custom.php эти параметры можно использовать через переменную $args.
Работа функции
Функция get_header() основана на функции locate_template(), которая ищет файл шаблона в директории темы. Если файл не найден, подключается дефолтный файл /wp-includes/theme-compat/header.php.
Хуки
Функция get_header() вызывает следующие хуки:
get_header: Перед подключением файла заголовка.
Заключение
Функция get_header() является одной из ключевых функций WordPress, которая позволяет легко управлять шапками страниц вашего сайта. Используя функцию get_header(), вы можете создать гибкую структуру для вашего сайта, которая легко настраивается и поддерживается.