Описание функции is_year()
Функция is_year() используется для проверки, находится ли пользователь на странице годового архива. Эта функция полезна для изменения поведения темы или плагина в зависимости от того, просматривается ли архив за конкретный год.
Функция возвращает true, если текущий запрос соответствует году, и false в противном случае.
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если текущий запрос является архивом года, иначе false
Возможные значения:
• true — если текущий запрос годовой архив
• false — если текущий запрос не является годовым архивом
Примеры использования
Проверка, является ли текущая страница годовым архивом
if (is_year()) {
echo 'Это годовой архив';
}
Вывод: Это годовой архив
Загрузка определенного шаблона для годового архива
if (is_year()) {
get_template_part('template-parts/content', 'year');
}
Загружает файл content-year.php, если это годовой архив
Безопасность
Валидация входных данных: Нет входных параметров для проверки
Санитизация: Не требуется, так как нет пользовательского ввода
Рекомендации: Используйте is_year() только в контексте темы или плагина, где необходимо различать архивы
— Связанные функции
Проверяет, является ли текущий запрос месячным архивом
Проверяет, является ли текущий запрос датированным архивом
— Примечания
– Ограничения
Работает только в контексте архивов по годам
– Частые проблемы
- Не срабатывает на страницах, которые не являются архивами
- Некорректные результаты при неверной настройке постоянных ссылок
