Описание функции wp_insert_term()
Функция wp_insert_term() используется для добавления нового термина в заданную таксономию. Это может быть полезно при создании новых категорий, меток или пользовательских таксономий. Функция возвращает информацию о добавленном термине или ошибку, если что-то пошло не так.
Функция поддерживает множество дополнительных параметров, таких как описание термина и родительский терм, что позволяет создавать иерархические структуры.
Параметры
$term
Тип: string
Обязательный: Да
Описание: Название термина, который будет добавлен
Возможные значения:
$taxonomy
Тип: string
Обязательный: Да
Описание: Имя таксономии, в которую будет добавлен термин
Возможные значения:
0: category
1: post_tag
2: custom_taxonomy
$args
Тип: array
Обязательный: Нет
По умолчанию: array()
Описание: Дополнительные параметры термина, такие как описание и родительский термин
Возможные значения:
description: Описание термина
parent: ID родительского термина (если требуется)
Возвращаемое значение
Тип: array|WP_Error
Описание: Массив с информацией о добавленном термине или объект WP_Error в случае ошибки
Возможные значения:
• Массив с ключами ‘term_id’ и ‘term’ при успешном добавлении
• Объект WP_Error при возникновении ошибки
Примеры использования
Базовый пример добавления нового термина в категорию
$result = wp_insert_term('Новые товары', 'category');
// Проверяем результат
if (is_wp_error($result)) {
echo 'Ошибка: ' . $result->get_error_message();
} else {
echo 'Термин добавлен с ID: ' . $result['term_id'];
}
Выводит ID добавленного термина или сообщение об ошибке
Добавление нового термина с описанием
$args = array(
'description' => 'Описание для новых товаров',
'parent' => 0
);
$result = wp_insert_term('Новые товары', 'category', $args);
Описание будет сохранено в базе данных
Проверка на наличие ошибок при добавлении термина
$result = wp_insert_term('Новые товары', 'category');
if (is_wp_error($result)) {
// Обработка ошибки
echo 'Ошибка: ' . $result->get_error_message();
}
Отображает сообщение об ошибке, если термин не был добавлен
Безопасность
Валидация входных данных: Функция автоматически валидирует входные параметры
Санитизация: Название термина очищается перед добавлением в базу данных
Рекомендации: При выводе данных используйте esc_html() для названия термина
— Связанные функции
Обновляет существующий термин в таксономии
Удаляет термин из таксономии
— Примечания
– Ограничения
Не поддерживает добавление термина с одинаковым названием в одной таксономии
– Частые проблемы
- Ошибка при добавлении термина с уже существующим названием
- Проблемы с правами доступа на создание термина
