get_header

Срабатывает перед загрузкой файла шаблона заголовка (header)
Хук WordPress
INT 2.1.0
WordPress Icon

Описание хука

Хук get_header срабатывает перед загрузкой шаблона header. Он позволяет определить или изменить файл шаблона, который будет загружен для отображения заголовка сайта.

Этот хук позволяет разработчикам вмешаться в процесс загрузки шаблона header и выполнить свой код до его загрузки. Это может быть полезно, если вам нужно изменить или добавить что-то в заголовок сайта, например, добавить дополнительные мета-теги или скрипты.

Использование

do_action( 'get_header', string|null $name, array $args )

Хук get_header может быть вызван с помощью функции do_action. Он принимает два параметра:

  • $name (строка или null): Имя конкретного файла шаблона заголовка для использования. Null для использования файла шаблона по умолчанию.
  • $args (массив): Дополнительные аргументы, передаваемые в шаблон заголовка.
  • $name (строка или null): Имя конкретного файла шаблона заголовка для использования. Null для использования файла шаблона по умолчанию.
  • $args (массив): Дополнительные аргументы, передаваемые в шаблон заголовка.
<?php
/**
 * Пример использования хука get_header
 *
 * @param string|null $name Имя файла шаблона заголовка. Null для использования файла по умолчанию.
 * @param array $args Дополнительные аргументы, передаваемые в шаблон заголовка.
 */
function custom_get_header( $name, $args ) {
    // Ваш код здесь
    // Выполнение дополнительных действий перед загрузкой шаблона заголовка
}
add_action( 'get_header', 'custom_get_header', 10, 2 );

В приведенном выше примере мы создали функцию custom_get_header, которая будет вызываться при срабатывании хука get_header. Функция принимает два параметра: $name и $args. Вы можете добавить свой собственный код внутри этой функции, чтобы выполнить дополнительные действия перед загрузкой шаблона заголовка.

Примеры использования

Изменение заголовка сайта при помощи хука get_header


function change_site_title( $name, $args ) {
    // Изменяем заголовок сайта
    $name = 'New Site Title';
    return $name;
}
add_filter( 'get_header', 'change_site_title', 10, 2 );

В данном примере мы используем хук get_header для изменения заголовка сайта. Функция change_site_title принимает два параметра: $name и $args. Внутри функции мы изменяем значение переменной $name на новый заголовок сайта и возвращаем его. Затем мы добавляем фильтр с помощью функции add_filter, указывая имя хука, имя функции и приоритет фильтра.

Добавление дополнительного контента перед заголовком сайта


function add_additional_content( $name, $args ) {
    // Добавляем дополнительный контент
    echo 'Additional Content';
}
add_action( 'get_header', 'add_additional_content', 10, 2 );

В этом примере мы используем хук get_header для добавления дополнительного контента перед заголовком сайта. Функция add_additional_content принимает два параметра: $name и $args. Внутри функции мы выводим дополнительный контент с помощью функции echo. Затем мы добавляем действие с помощью функции add_action, указывая имя хука, имя функции и приоритет действия.

Установка кастомного заголовка для определенной страницы


function set_custom_header( $name, $args ) {
    // Устанавливаем кастомный заголовок для определенной страницы
    if ( is_page( 'about' ) ) {
        $name = 'Custom Page Title';
    }
    return $name;
}
add_filter( 'get_header', 'set_custom_header', 10, 2 );

В этом примере мы используем хук get_header для установки кастомного заголовка для определенной страницы. Функция set_custom_header принимает два параметра: $name и $args. Внутри функции мы проверяем, является ли текущая страница страницей «about» с помощью функции is_page. Если это так, то мы изменяем значение переменной $name на кастомный заголовок и возвращаем его. Затем мы добавляем фильтр с помощью функции add_filter, указывая имя хука, имя функции и приоритет фильтра.

Изменение параметров шаблона заголовка


function modify_header_template( $name, $args ) {
    // Изменяем параметры шаблона заголовка
    $args['template'] = 'custom-header.php';
    return $args;
}
add_filter( 'get_header', 'modify_header_template', 10, 2 );

В этом примере мы используем хук get_header для изменения параметров шаблона заголовка. Функция modify_header_template принимает два параметра: $name и $args. Внутри функции мы изменяем значение ключа 'template' в массиве $args на имя кастомного шаблона заголовка и возвращаем измененный массив. Затем мы добавляем фильтр с помощью функции add_filter, указывая имя хука, имя функции и приоритет фильтра.

Вопросы и ответы

Как изменить заголовок страницы в шаблоне header?

Для изменения заголовка страницы в шаблоне header в WordPress можно использовать хук get_header. Этот хук срабатывает перед загрузкой файла шаблона header.

Пример использования хука get_header:


function change_page_title() {
    // Ваш код для изменения заголовка страницы
    $new_title = 'Новый заголовок страницы';
    return $new_title;
}
add_filter( 'pre_get_document_title', 'change_page_title' );

Как добавить дополнительные CSS-стили в шаблон header?

Для добавления дополнительных CSS-стилей в шаблон header в WordPress можно использовать хук get_header. Этот хук срабатывает перед загрузкой файла шаблона header.

Пример использования хука get_header:


function add_custom_styles() {
    // Ваш код для добавления дополнительных CSS-стилей
    $custom_styles = '<style>body { background-color: #f1f1f1; }</style>';
    echo $custom_styles;
}
add_action( 'get_header', 'add_custom_styles' );

Как добавить дополнительные JavaScript-скрипты в шаблон header?

Для добавления дополнительных JavaScript-скриптов в шаблон header в WordPress можно использовать хук get_header. Этот хук срабатывает перед загрузкой файла шаблона header.

Пример использования хука get_header:


function add_custom_scripts() {
    // Ваш код для добавления дополнительных JavaScript-скриптов
    $custom_scripts = '<script src="custom-script.js"></script>';
    echo $custom_scripts;
}
add_action( 'get_header', 'add_custom_scripts' );

Как изменить порядок загрузки шаблонов header?

Порядок загрузки шаблонов header в WordPress можно изменить с помощью хука get_header. Этот хук срабатывает перед загрузкой файла шаблона header.

Пример использования хука get_header:


function change_header_template( $name ) {
    // Ваш код для изменения порядка загрузки шаблонов header
    $new_header_template = 'custom-header.php';
    return $new_header_template;
}
add_filter( 'get_header', 'change_header_template' );

Как создать и использовать пользовательский шаблон header?

Для создания пользовательского шаблона header в WordPress необходимо выполнить следующие шаги:

  1. Создайте новый файл шаблона с расширением «.php».
  2. Откройте созданный файл в текстовом редакторе и добавьте необходимый код для header.
  3. Сохраните файл и загрузите его на сервер в директорию вашей темы WordPress.
  4. Откройте файл «header.php» в директории вашей темы и замените его содержимое на следующий код:

<?php
  /**
   * Шаблон header
   *
   * @package WordPress
   * @subpackage Ваша_тема
   */
  get_template_part( 'custom-header' );
?>

Как удалить или отключить шаблон header?

Для удаления или отключения шаблона header в WordPress необходимо выполнить следующие шаги:

  1. Откройте файл «header.php» в директории вашей темы.
  2. Удалите или закомментируйте весь код в файле.
  3. Сохраните изменения.

Как использовать разные шаблоны header для разных страниц?

Для использования разных шаблонов header для разных страниц в WordPress необходимо выполнить следующие шаги:

  1. Создайте новый файл шаблона header для каждой страницы с расширением «.php».
  2. Откройте файл «header.php» в директории вашей темы и замените его содержимое на следующий код:

<?php
  /**
   * Шаблон header
   *
   * @package WordPress
   * @subpackage Ваша_тема
   */
  if ( is_home() ) {
    get_template_part( 'header-home' );
  } elseif ( is_single() ) {
    get_template_part( 'header-single' );
  } else {
    get_template_part( 'header-default' );
  }
?>

Как добавить условия для загрузки определенного шаблона header?

Для добавления условий для загрузки определенного шаблона header в WordPress необходимо выполнить следующие шаги:

  1. Откройте файл «header.php» в директории вашей темы.
  2. Добавьте необходимые условия перед вызовом функции «get_template_part()».
  3. Сохраните изменения.

<?php
  /**
   * Шаблон header
   *
   * @package WordPress
   * @subpackage Ваша_тема
   */
  if ( is_front_page() ) {
    get_template_part( 'header-front' );
  } elseif ( is_archive() ) {
    get_template_part( 'header-archive' );
  } else {
    get_template_part( 'header-default' );
  }
?>

Хук «get_header» в WordPress позволяет изменять и настраивать заголовок сайта перед его загрузкой. С помощью этого хука можно создавать пользовательские шаблоны header, отключать или удалять шаблон header, использовать разные шаблоны header для разных страниц и добавлять условия для загрузки определенного шаблона header. Это дает разработчикам большую гибкость и контроль над отображением заголовка сайта в WordPress.

Связанные элементы

  • Функция get_header(): Возвращает путь к файлу шаблона заголовка.
  • Функция get_header_textcolor(): Возвращает цвет текста заголовка сайта.
  • Функция get_header_image(): Возвращает URL изображения для использования в качестве заголовка сайта.
  • Функция get_header_image_tag(): Возвращает HTML-тег изображения для использования в качестве заголовка сайта.
  • Функция get_custom_header(): Возвращает информацию о пользовательском заголовке сайта.
  • Функция get_custom_header_markup(): Возвращает HTML-разметку для пользовательского заголовка сайта.
  • Хук wp_head: Вызывается перед выводом содержимого внутри тега <head>.
  • Хук wp_get_custom_css: Вызывается для получения пользовательского CSS-кода для заголовка сайта.
  • Класс WP_Customize_Header_Image_Control: Класс для создания пользовательского элемента управления заголовком сайта в Customizer.
  • Класс WP_Customize_Header_Image_Setting: Класс для создания настройки пользовательского заголовка сайта в Customizer.
Обсуждение