Описание функции is_category()
Функция is_category() проверяет, находится ли пользователь на странице категории. Это полезно для изменения поведения темы или плагина в зависимости от текущей страницы.
Функция возвращает true, если текущая страница — это страница категории, и false в противном случае.
Параметры
$category
Тип: mixed
Обязательный: Нет
По умолчанию: null
Описание: Идентификатор категории, объект категории или слаг категории для проверки
Возможные значения:
ID: ID категории
slug: Слаг категории
object: Объект WP_Term
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если текущая страница — это страница категории, иначе false
Возможные значения:
• true — если текущая страница категория
• false — если текущая страница не категория
Примеры использования
Проверка, является ли текущая страница страницей категории
if (is_category()) {
echo 'Это страница категории';
}
Выводит сообщение, если это страница категории
Проверка, является ли текущая страница страницей категории слагом ‘news’
if (is_category('news')) {
echo 'Это страница категории новостей';
}
Выводит сообщение, если это страница категории новостей
Проверка, является ли текущая страница страницей категории с ID 5
if (is_category(5)) {
echo 'Это страница категории с ID 5';
}
Выводит сообщение, если это страница категории с ID 5
Безопасность
Валидация входных данных: Входные параметры автоматически проверяются
Санитизация: Санитизация не требуется, так как функция работает с внутренними данными WordPress
Рекомендации: Избегайте использования пользовательских данных без предварительной проверки
— Связанные функции
Проверяет, является ли текущая страница страницей тега
Проверяет, является ли текущая страница архивом
— Примечания
– Ограничения
Функция не работает на страницах, не связанных с категориями
– Частые проблемы
- Неверный результат при использовании в неправильном контексте
- Функция вернет false, если на странице есть другие таксономии
