Функция get_header() в WordPress

Главная - WordPress Codex - Функция get_header() в WordPress
Доступна с версии: 1.5
Раздел: Тема
Написал: Александр Сокирка

Функция 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(), вы можете создать гибкую структуру для вашего сайта, которая легко настраивается и поддерживается.

Стартовая премиум тема для WordPress
Демо импорт тестового контента в 1 клик.
SEO оптимизированный и валидный код.
Множество готовых стартовых сайтов.
Лучшая документация и поддержка.
Опции персонализации контента.
Креативный и современный дизайн.
Тема для WordPress

Дополнительно по: Тема