Функция get_footer() подключает файл футера (подвала) сайта, который обычно называется footer.php. Она позволяет использовать различные шаблоны для футера, загружая соответствующий файл в зависимости от текущей страницы.
get_footer( $name = null );Параметры
- $name (строка): Название (или индекс названия) файла шаблона футера. Подключается файл
footer-{$name}.php. Если параметр не указан, загружаетсяfooter.php. Если файлаfooter.phpнет в папке темы, загружается стандартный файл/wp-includes/theme-compat/footer.php. Параметр был добавлен в WordPress версии 2.7.0.
Возвращаемое значение
Функция возвращает null при успешном подключении файла и false, если файл шаблона не найден.
Примеры использования
Базовое использование
Вызов функции get_footer() без параметров подключает стандартный файл footer.php.
<?php
get_footer(); // Подключается footer.php
?>Использование с условными тегами
Вы можете подключить различные файлы футера в зависимости от условий. Например, подключение footer-custom.php для записи с ID=3:
<?php
if ( is_single( 3 ) ) {
get_footer('custom'); // Подключается footer-custom.php
} else {
get_footer(); // Подключается footer.php
}
?>Дополнительные параметры (с WP 5.5)
С версии 5.5 можно передавать дополнительные параметры в подключаемый файл футера через массив $args.
<?php get_footer( $name, $args ); ?>- $args (массив): Дополнительные параметры для подключаемого файла. Эти параметры можно использовать в файле шаблона через переменную
$args.
Разные футеры для различных страниц
Подключение различных файлов футера в зависимости от типа страницы:
<?php
if ( is_home() ) {
get_footer('home'); // Подключается footer-home.php
} elseif ( is_singular('post') ) {
get_footer('single'); // Подключается footer-single.php
} else {
get_footer(); // Подключается footer.php
}
?>В данном случае, файлы подвала темы для главной страницы и страницы поста должны называться footer-home.php и footer-single.php соответственно.
Хуки
Функция get_footer() работает на основе функции locate_template() и вызывает хук get_footer, который можно использовать для добавления собственных действий до подключения футера.
Заключение
Функция get_footer() предоставляет гибкость в управлении подвалом сайта, позволяя подключать разные файлы футера в зависимости от условий и передавать дополнительные параметры в подключаемый файл. Это делает её мощным инструментом для создания динамичных и настраиваемых шаблонов в WordPress.