is_front_page()
Проверяет отображается ли главная (домашняя) страница сайта. Условный тег.
Тег сработает в любом случае: будь это страница с выводом последних постов или страница где для главной страницы сайта установлена статическая страница.
Когда для главной установлена статическая страница, is_home() уже не работает на главной, а работают: is_front_page(), is_singular(), is_page()
В настройках Параметры > Чтение > На главной странице отображать
(Settings > Reading > Front page displays) можно установить статическую страницу для главной и статическую страницу для вывода последних постов. is_front_page() в любом случае будет работать для главной страницы сайта, а is_home() будет срабатывать только для страницы с выводом последних постов.
На страницах пагинации этот тег будет также срабатывать: /page/2
- будет считаться главной.
Смотрите аналогичную функцию is_home().
Хуков нет.
Возвращает
true|false
. true или false зависит от выполнения условия.
Использование
if( is_front_page() ) { //код }
Примеры
#1 Обычный пример использования:
if( is_front_page() ){ echo "Это главная страница"; } else { echo "это не главная страница"; }
#2 Опции «главной страницы» и «страницы записей»
Опции где хранятся ID страниц, который установлены для «главной страницы» и для «страницы записей»:
// ID постоянной страницы, которая указана как главная страница сайта get_option('page_on_front'); // ID постоянной страницы, которая указана как страница блога (последних записей сайта) get_option('page_for_posts');
Заметки
- Global. WP_Query. $wp_query WordPress Query object.
Список изменений
С версии 2.5.0 | Введена. |
Код is_front_page() is front page WP 6.6.1
function is_front_page() { global $wp_query; if ( ! isset( $wp_query ) ) { _doing_it_wrong( __FUNCTION__, __( 'Conditional query tags do not work before the query is run. Before then, they always return false.' ), '3.1.0' ); return false; } return $wp_query->is_front_page(); }