Описание функции wp_create_category()
Функция wp_create_category() используется для создания новой категории в WordPress. Она добавляет категорию в базу данных и возвращает ID новой категории.
Функция часто используется в плагинах и темах для автоматизации процесса добавления категорий при создании контента или настройки сайта.
Параметры
$cat_name
Тип: string
Обязательный: Да
Описание: Название создаваемой категории
Возможные значения:
$parent
Тип: int
Обязательный: Нет
Описание: ID родительской категории, если нужно создать вложенную категорию
Возможные значения:
$description
Тип: string
Обязательный: Нет
Описание: Описание категории
Возможные значения:
Возвращаемое значение
Тип: int|WP_Error
Описание: ID созданной категории или объект WP_Error в случае ошибки
Возможные значения:
• ID новой категории при успешном выполнении
• WP_Error при возникновении ошибки
Примеры использования
Базовый пример создания категории
$category_id = wp_create_category('Новости');
// Вывод результата
if (is_wp_error($category_id)) {
echo 'Ошибка: ' . $category_id->get_error_message();
} else {
echo 'Создана категория с ID: ' . $category_id;
}
Создана категория ‘Новости’
Создание вложенной категории ‘Обзоры’ под родительской категорией ‘Статьи’
$parent_id = wp_create_category('Статьи');
$child_id = wp_create_category('Обзоры', $parent_id);
if (is_wp_error($child_id)) {
echo 'Ошибка: ' . $child_id->get_error_message();
} else {
echo 'Создана вложенная категория с ID: ' . $child_id;
}
Статья ‘Обзоры’ будет дочерней к ‘Статьи’
Пример обработки ошибок при создании категории с пустым названием
$category_id = wp_create_category('');
if (is_wp_error($category_id)) {
echo 'Ошибка: ' . $category_id->get_error_message();
}
Ошибка, так как название категории не может быть пустым
Безопасность
Валидация входных данных: Функция проверяет корректность входных данных
Санитизация: Параметры автоматически очищаются WordPress
Рекомендации: Используйте esc_html() для вывода данных категории на экран
— Связанные функции
Вставляет термин в таксономию, может использоваться для создания категорий
Получает список категорий
— Примечания
– Ограничения
Не может создать категорию с уже существующим названием
– Частые проблемы
- Ошибка при пустом названии категории
- Ошибка при неверном ID родительской категории
