Функция 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.