Функция wp_create_category() в WordPress предназначена для добавления новой категории в базу данных. Если категория с таким именем уже существует, она не будет дублироваться, и функция вернет ID существующей категории. Это упрощает управление категориями и делает добавление новых категорий простым и интуитивно понятным.
wp_create_category( int|string $cat_name, int $category_parent ): int|WP_Error
Параметры:
- $cat_name (int|string) (обязательный)
Название категории, которую вы хотите создать. - $category_parent (int) (необязательный)
ID родительской категории. По умолчанию используется значение0, что означает, что категория будет корневой.
Возврат:
Функция возвращает:
- int — ID созданной категории, если операция прошла успешно.
- WP_Error — объект ошибки, если произошла ошибка при создании категории.
Описание
Функция wp_create_category() является оберткой для функции wp_insert_category(). Она проверяет, существует ли категория с указанным именем, и, если да, возвращает ее ID. Если категории не существует, функция пытается создать новую категорию. Если создание прошло успешно, возвращается ID новой категории. В противном случае возвращается объект WP_Error.
Пример 1: Создание простой категории
Для создания простой категории используйте следующий код:
$category_name = 'Новая категория'; // Название категории, которую вы хотите создать
$category_id = wp_create_category( $category_name );
if ( ! is_wp_error( $category_id ) ) {
echo 'Категория создана с ID: ' . $category_id;
} else {
echo 'Ошибка при создании категории: ' . $category_id->get_error_message();
}
Пример 2: Создание категории с родителем
Чтобы создать категорию, которая является дочерней к категории с ID 10, укажите второй параметр:
$category_name = 'Дочерняя категория'; // Название дочерней категории
$parent_category_id = 10; // ID родительской категории
$category_id = wp_create_category( $category_name, $parent_category_id );
if ( ! is_wp_error( $category_id ) ) {
echo 'Дочерняя категория создана с ID: ' . $category_id;
} else {
echo 'Ошибка при создании дочерней категории: ' . $category_id->get_error_message();
}
Пример 3: Проверка успешности создания категории
Вы можете проверить, была ли категория успешно создана, следующим образом:
$cat_id = wp_create_category('Разное');
if( ! is_wp_error( $cat_id ) ) {
echo 'Категория "Разное" создана с ID: ' . $cat_id;
} else {
echo 'Не удалось создать категорию: ' . $cat_id->get_error_message();
}
Пример 4: Получение ID созданной категории в переменной
Чтобы получить ID созданной категории и сохранить его в переменной:
$cat_id = wp_create_category( 'Ребенок категории', 0 ); // 0 означает, что это корневая категория
if ( ! is_wp_error( $cat_id ) ) {
echo 'ID созданной категории: ' . $cat_id;
} else {
echo 'Ошибка: ' . $cat_id->get_error_message();
}
Заключение
Функция wp_create_category() предоставляет простой и эффективный способ добавления новых категорий в WordPress. Благодаря автоматической проверке на существование категории и удобному интерфейсу, она значительно упрощает управление категориями для разработчиков и пользователей. Используйте её в своих проектах, чтобы облегчить организацию контента.