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

Что такое IS_FRONT_PAGE()?

Функция is_front_page() проверяет, отображается ли главная (домашняя) страница вашего сайта. Это условный тег, который работает в любом случае: независимо от того, выбрана ли страница с последними публикациями или статическая страница в качестве главной.

Как это работает?

Если вы установили статическую страницу в качестве главной, функция is_home() больше не будет работать на главной странице, но будет работать:

• is_front_page()
• is_singular()
• is_page()

В настройках вашего сайта (Параметры > Чтение > Отображение главной страницы) вы можете установить статическую страницу для главной и другую для выхода последних постов. Таким образом, is_front_page() будет работать для главной страницы, а is_home() — только для страницы с последними постами.

Кроме того, на страницах пагинации, таких как /page/2, также будет срабатывать условие is_front_page() и она будет считаться главной страницей.

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

Функция возвращает true или false, в зависимости от того, запрашивается ли главная страница сайта.

if ( is_front_page() ) {
   // выполняем код, если это главная страница
}

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

Пример 1: Проверка главной страницы

if ( is_front_page() ) {
    echo "Это главная страница";
} else {
    echo "Это не главная страница";
}

Пример 2: Получение ID страниц

Вы можете получить ID страниц, которые установлены для главной и для блога следующим образом:

// ID статической страницы, назначенной как главная
$page_on_front = get_option('page_on_front');

// ID статической страницы, назначенной как страница постов
$page_for_posts = get_option('page_for_posts');

Примечания

• Глобальный объект WP_Query. Изучая WordPress, вы столкнетесь с объектом $wp_query, который содержит информацию о текущем запросе.

Изменения

Функция была введена в версии 2.5.0 WordPress.

Код функции IS_FRONT_PAGE()

function is_front_page() {
    global $wp_query;

    if ( ! isset( $wp_query ) ) {
        _doing_it_wrong( __FUNCTION__, __( 'Условные запросы не работают до выполнения запроса. До этого момента они всегда возвращают false.' ), '3.1.0' );
        return false;
    }

    return $wp_query->is_front_page();
}

Связанные функции

Ниже приведены некоторые другие условные теги, которые могут быть полезны:

• is_404(): проверяет, является ли страница ошибкой 404
• is_home(): проверяет, является ли текущая страница страницей блога с последними постами
• is_page(): проверяет, является ли текущая страница обычной страницей

Это базовая информация о функции is_front_page(). Используйте её, чтобы создавать более динамичные и функциональные сайты на WordPress!