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

Функция get_footer() используется в шаблонах WordPress для подключения файла подвала (footer.php) из вашей текущей темы. Если вы укажете название, вместо стандартного подвала будет загружен файл footer-{name}.php.

Если в вашей теме нет файла footer.php, будет загружен подвал из файла по умолчанию: wp-includes/theme-compat/footer.php.

Использование функции

Синтаксис

get_footer( $name, $args );

• $name (string) — имя специализированного подвала. По умолчанию: null.
• $args (array) — дополнительные аргументы, переданные в шаблон подвала. По умолчанию: пустой массив.

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

Пример 1: Простой шаблон страницы 404

Код для шаблона 404.php может выглядеть так:

Ошибка 404 - Страница не найдена

Пример 2: Разные подвалы для разных страниц

Если вы хотите использовать разные подвала для разных страниц, вы можете сделать это следующим образом:

В этом примере будут загружены файлы footer-home.php и footer-404.php для домашней страницы и страницы 404 соответственно.

Возвращаемое значение

Функция возвращает:

• null или false — возвращает false, если шаблон не существует.

Обработчик событий (Hook)

Функция get_footer() также имеет обработчик событий, который называется get_footer. Вы можете использовать этот хук для выполнения дополнительных действий перед загрузкой подвала.

Изменения в версии

• С версии 1.5.0 — функция была введена.
• С версии 5.5.0 — добавлено возвращаемое значение и параметр $args.

Код функции

Основной код функции выглядит так:

function get_footer( $name = null, $args = array() ) {
    /**
     * Срабатывает перед загрузкой файла шаблона подвала.
     * 
     * @param string|null $name Имя конкретного файла подвала. Null для стандартного подвала.
     * @param array       $args Дополнительные аргументы, переданные в шаблон подвала.
     */
    do_action( 'get_footer', $name, $args );

    $templates = array();
    $name      = (string) $name;
    if ( '' !== $name ) {
        $templates[] = "footer-{$name}.php";
    }

    $templates[] = 'footer.php';

    if ( ! locate_template( $templates, true, true, $args ) ) {
        return false;
    }
}

Заключение

Функция get_footer() — это простой, но мощный инструмент для управления подвалами на вашем сайте WordPress. С её помощью вы можете легко подключать разные версии подвалов для различных страниц, что делает ваш сайт более персонализированным.