Kama3 месяца назад18 EN

is_front_page() │ WP 2.5.0

Проверяет отображается ли главная (домашняя) страница сайта. Условный тег.

Тег сработает в любом случае: будь это страница с выводом последних постов или страница где для главной страницы сайта установлена статическая страница.

В настройках Параметры > Чтение > На главной странице отображать (Settings > Reading > Front page displays) можно установить статическую страницу для главной и статическую страницу для вывода последних постов. Эта функция будет работать в обоих случаях для главной страницы сайта, а is_home() будет срабатывать только для страницы с выводом последних постов.

На страницах пагинации этот тег будет также срабатывать: /page/2 - будет считаться главной.

Когда для главной установлена статическая страница, is_home() уже не работает на главной, а работают: is_front_page(), is_singular(), is_page()

Смотрите аналогичную функцию is_home().

Работает на основе: WP_Query::is_front_page()
1 раз — 0.001879 сек (очень медленно) | 50000 раз — 3.20 сек (быстро) | PHP 7.1.2, WP 4.7.5

Хуков нет.

Возвращает

true|false. true или false зависит от выполнения условия.

Использование

if( is_front_page() ) {
   //код
}

Примеры

0

#1 Обычный пример использования: 

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

#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() WP 6.9.4

wp-includes/query.php 
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();
}

Условные теги (типов страниц и запросов)

Условные теги (все)

Запросы

Основные

18 комментариев
Полезные - 2 Все