is_front_page()
Перевіряє, чи відображається головна (домашня) сторінка сайту. Умовний тег.
Тег спрацює у будь-якому випадку: чи це сторінка з виведенням останніх постів чи сторінка де для головної сторінки сайту встановлена статична сторінка.
Коли для головної встановлено статична сторінка, is_page()
У налаштуваннях Параметры > Чтение > На главной странице отображать( Settings > Reading > Front page displays ) можна встановити статичну сторінку для головної та статичну сторінку для виведення останніх постів. is_front_page() у будь-якому випадку працюватиме для головної сторінки сайту, а is_home() буде спрацьовувати тільки для сторінки з виведенням останніх постів.
На сторінках пагінації цей тег спрацьовуватиме також: /page/2– вважатиметься головною.
Дивіться аналогічну функцію is_home() .
WP_Query::is_front_page()
(дуже повільно) | 50000 разів – 3.20 сек
(швидко) |
PHP 7.1.2, WP 4.7.5
Хуків немає.
Повертає
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.0.2
function is_front_page() {
global $wp_query;
if ( ! isset( $wp_query ) ) {
_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags для роботи не буде для роботи, тому що не буде, якщо вони беруть участь false.' ), '3.1.0' );
return false;
}
return $wp_query->is_front_page();
}