Описание функции category_exists()
Функция category_exists() проверяет, существует ли категория с заданным идентификатором или ярлыком. Она используется для проверки наличия категорий перед выполнением операций, таких как создание или редактирование записей с использованием определенных категорий.
Функция возвращает true, если категория существует, и false в противном случае.
Параметры
$term
Тип: mixed
Обязательный: Да
Описание: ID категории или ее ярлык (slug)
Возможные значения:
type: int или string
examples: 12, news
Возвращаемое значение
Тип: bool
Описание: Возвращает true, если категория существует, и false, если нет
Возможные значения:
• true — категория существует
• false — категория не найдена
Примеры использования
Проверка категории по ее ID
$exists = category_exists(12);
if ($exists) {
echo 'Категория существует';
} else {
echo 'Категория не найдена';
}
Выводит: ‘Категория существует’ или ‘Категория не найдена’
Проверка категории по ее ярлыку
$exists = category_exists('news');
if ($exists) {
echo 'Категория существует';
} else {
echo 'Категория не найдена';
}
Выводит: ‘Категория существует’ или ‘Категория не найдена’
Обработка случая, когда категория не найдена
$term_id = 999;
$exists = category_exists($term_id);
if (!$exists) {
echo 'Категория с ID 999 не найдена';
}
Выводит: ‘Категория с ID 999 не найдена’
Проверка категории в контексте плагина
function my_plugin_check_category($term) {
if (category_exists($term)) {
// Логика для существующей категории
} else {
// Логика для отсутствующей категории
}
}
Выполняет логику в зависимости от существования категории
Безопасность
Валидация входных данных: Параметры проверяются на соответствие типам данных
Санитизация: Не требуется дополнительная очистка ввода
Рекомендации: Используйте intval() для приведения ID к целочисленному типу, если необходимо
— Связанные функции
Получает категорию по ее ярлыку
Получает термин (категорию, метку и т.д.) по ID
— Примечания
– Ограничения
Функция может не работать корректно с пользовательскими таксономиями
– Частые проблемы
- Возвращает false для несуществующих ID или ярлыков
- Не учитывает неактивные категории или категории с ошибками
