is_year()
Спрацьовує коли показується сторінка-архів із постами за вказаний рік example.com/2009 . Умовний тег.
Функція входить у перевірку функцій is_archive() , тому, в одному логічному ланцюжку, цю функцію потрібно використовувати перед зазначеними функціями, інакше вона просто ніколи не спрацює. Див. Приклад 2.
Працює на основі:
WP_Query::is_year()
WP_Query::is_year()
1 раз – 0.00007 сек
(дуже швидко) | 50000 разів – 0.01 сек
(швидкість світла)
(дуже швидко) | 50000 разів – 0.01 сек
(швидкість світла)
Хуків немає.
Повертає
true|false.
Використання
if( is_year() ){
// ...
}Приклади
#1 Виведення запису на архівах протягом року
Використовуючи такий код у сайдбарі, ми можемо виводити потрібну інформацію тільки на архівних сторінках з постами за рік:
if( is_year() ){
echo 'Це сторінка архіву за рік: наприклад, таке посилання example.com';
}#2 Одночасне використання is_archive() та is_year()
Як правильно будувати логічний ланцюжок з використанням is_archive() та is_year() одночасно:
if( is_year() ) echo "Сторінка архіву за рік."; elseif( is_archive() ) echo 'Сторінка архіву: день, місяць, категорія, мітка тощо'; else echo 'Це не сторінка архіву';
Спочатку йде is_year() , а потім is_archive()
нотатки
- Global. WP_Query. $wp_query WordPress Query object.
список змін
| З версії 1.5.0 | Введено. |
Код is_year() is year WP 6.0.2
function is_year() {
global $wp_query;
if ( ! isset( $wp_query ) ) {
_doing_it_wrong( __FUNCTION__, __( 'Conditional query tags для роботи не буде для роботи, тому що не буде, якщо вони беруть участь false.' ), '3.1.0' );
return false;
}
return $wp_query->is_year();
}