Описание функции delete_term_meta()
Функция delete_term_meta() удаляет метаданные, связанные с конкретным термином в таксономии WordPress. Это позволяет управлять дополнительной информацией, связанной с терминами, такими как категории или теги, и поддерживать чистоту базы данных.
Функция используется в случаях, когда необходимо удалить ненужные или устаревшие метаданные термина.
Параметры
$term_id
Тип: int
Обязательный: Да
Описание: ID термина, для которого удаляются метаданные
Возможные значения:
$meta_key
Тип: string
Обязательный: Да
Описание: Ключ метаданных, которые необходимо удалить
Возможные значения:
Возвращаемое значение
Тип: bool
Описание: Возвращает true при успешном удалении, false в противном случае
Возможные значения:
• true — метаданные успешно удалены
• false — метаданные не найдены или произошла ошибка
Примеры использования
Базовый пример удаления метаданных с ID термина 123
$result = delete_term_meta(123, 'color');
// Проверка результата
if ($result) {
echo 'Метаданные успешно удалены';
} else {
echo 'Ошибка удаления метаданных';
}
Удаляем метаданные с ключом ‘color’
Обработка случаев, когда метаданные не найдены
$term_id = 456;
$meta_key = 'size';
if (!delete_term_meta($term_id, $meta_key)) {
echo 'Метаданные не найдены или не могут быть удалены';
}
Проверка результата удаления
Безопасность
Валидация входных данных: Функция требует, чтобы term_id был целым числом и meta_key — строкой
Санитизация: Входные параметры очищаются WordPress
Рекомендации: Убедитесь, что у вас есть права на удаление метаданных перед вызовом функции
— Связанные функции
Добавляет метаданные термина
Получает метаданные термина
— Примечания
– Ограничения
Функция не удаляет метаданные, если они не существуют
– Частые проблемы
- Ошибка при передаче неверных типов данных
- Неудача при отсутствии прав на удаление
