Описание функции wp_insert_category()
Функция wp_insert_category() используется для добавления новой категории в WordPress. Она позволяет задать название, описание, родительскую категорию и другие параметры. Функция возвращает ID вновь созданной категории или false в случае ошибки.
Эта функция может быть использована как в админ-панели, так и в пользовательских плагинах для управления категориями.
Параметры
$args
Тип: array
Обязательный: Да
По умолчанию: array()
Описание: Массив аргументов для создания категории
Возможные значения:
cat_name: Строка с названием категории
category_nicename: Строка с слагом категории
category_description: Строка с описанием категории
parent: ID родительской категории
term_id: ID категории, если нужно обновить существующую
Возвращаемое значение
Тип: int|false
Описание: ID созданной категории или false в случае ошибки
Возможные значения:
• ID новой категории при успешном выполнении
• false в случае ошибки, например, если название категории уже существует
Примеры использования
$category_id = wp_insert_category(array(
'cat_name' => 'Новая категория'
));
// Выводим ID новой категории
echo $category_id; // 123
$category_id = wp_insert_category(array(
'cat_name' => 'Статьи',
'category_nicename' => 'stati',
'category_description' => 'Описание статей'
));
// Выводим ID
echo $category_id; // 124
$category_id = wp_insert_category(array(
'cat_name' => 'Новая категория'
));
if (!$category_id) {
echo 'Ошибка при добавлении категории';
} else {
echo 'Категория добавлена с ID: ' . $category_id;
}
$args = array(
'cat_name' => 'Плагин категории',
'category_description' => 'Категория для плагина'
);
wp_insert_category($args);
Безопасность
Валидация входных данных: Параметры должны быть валидными, название категории не должно быть пустым
Санитизация: WordPress автоматически очищает входные данные
Рекомендации: Перед использованием wp_insert_category проверьте, существует ли категория с таким названием
— Связанные функции
Обновляет существующую категорию
Получает список категорий
— Примечания
– Ограничения
Не позволяет создавать категории с пустым названием
– Частые проблемы
- Ошибка при попытке создать категорию с уже существующим названием
- Неверные параметры могут привести к неудаче операции
