Описание функции wp_delete_term()
Функция wp_delete_term() удаляет термин из заданной таксономии. Это может быть использовано для удаления категорий, меток и других терминов. Функция также обрабатывает удаление термина с учетом всех связанных данных и обеспечит корректное удаление термина из базы данных, а также вызов соответствующих хуков для обработки событий удаления.
Функция полезна в административных интерфейсах и при разработке плагинов, где необходимо управлять терминами.
Параметры
$term
Тип: int|string
Обязательный: Да
Описание: ID или слаг термина, который необходимо удалить
Возможные значения:
$taxonomy
Тип: string
Обязательный: Да
Описание: Имя таксономии, из которой удаляется термин
Возможные значения:
Возвращаемое значение
Тип: mixed
Описание: Результат выполнения операции удаления термина
Возможные значения:
• WP_Term объект удаленного термина при успешном выполнении
• null если термин не найден
• WP_Error в случае ошибки
Примеры использования
Базовый пример удаления термина по ID
$result = wp_delete_term(10, 'category');
if (is_wp_error($result)) {
echo 'Ошибка: ' . $result->get_error_message();
} else {
echo 'Термин успешно удален';
}
Термин с ID 10 будет удален из категории
Удаление термина по слагу
$result = wp_delete_term('news', 'category');
if (is_wp_error($result)) {
echo 'Ошибка: ' . $result->get_error_message();
} else {
echo 'Термин успешно удален';
}
Термин с слагом ‘news’ будет удален
Попытка удалить несуществующий термин
$result = wp_delete_term(999, 'category');
if (is_wp_error($result)) {
echo 'Ошибка: ' . $result->get_error_message();
} else {
echo 'Термин успешно удален';
}
В случае ошибки будет выведено сообщение об ошибке
Безопасность
Валидация входных данных: Функция проверяет, существует ли термин перед его удалением
Санитизация: Параметры очищаются автоматически
Рекомендации: Проверяйте права пользователя перед удалением термина, используйте current_user_can()
— Связанные функции
Добавляет новый термин в таксономию
Получает информацию о термине по ID или слагу
— Примечания
– Ограничения
Не удаляет термины, если они используются в записях
– Частые проблемы
- Ошибка при удалении несуществующего термина
- Проблемы с правами доступа
