Описание функции WP_Term
Класс WP_Term предоставляет интерфейс для работы с терминами в WordPress. Он используется для создания, редактирования и удаления терминов в таксономиях. Объекты этого класса содержат свойства, такие как ID, название, ярлык и таксономия. WP_Term является основным классом, который взаимодействует с таксономиями в WordPress.
Класс полезен для разработчиков тем и плагинов, которые работают с терминами и их метаданными
Параметры
$args
Тип: array
Обязательный: Да
По умолчанию: {}
Описание: Массив аргументов для создания или обновления термина
Возможные значения:
name: Название термина
slug: Ярлык термина
term_id: ID термина
taxonomy: Таксономия, к которой принадлежит термин
description: Описание термина
Возвращаемое значение
Тип: WP_Term
Описание: Объект WP_Term, представляющий термин
Возможные значения:
• Объект WP_Term при успешном выполнении
• null в случае ошибки
Примеры использования
Базовый пример создания нового термина
$term = new WP_Term(array(
'name' => 'Новая категория',
'slug' => 'novaya-kategoriya',
'taxonomy' => 'category'
));
Термин будет добавлен в категорию
Получение термина по ID
$term = get_term(1, 'category');
if ($term instanceof WP_Term) {
echo 'Название: ' . $term->name;
}
Проверка на существование термина
Безопасность
Валидация входных данных: Параметры проверяются при создании термина
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Используйте sanitize_title() для очистки ярлыка термина
— Связанные функции
Получает список терминов в таксономии
Добавляет новый термин в таксономию
— Хуки
Фильтрует ссылку на термин перед выводом
Фильтрует параметры сортировки терминов
— Примечания
– Ограничения
Класс не предназначен для создания иерархии терминов напрямую
– Частые проблемы
- Ошибка при создании термина с существующим ярлыком
- Проблемы с правами доступа при работе с таксономиями
