WP_CREATE_CATEGORY() │ WP 2.0.0

Функция WP_CREATE_CATEGORY() позволяет добавить новую категорию в базу данных, если она ещё не существует.

Использование

Эта функция использует wp_insert_category() для добавления новой категории.

Возвращаемое значение:

• Возвращает int (ID созданной категории) или WP_Error, если произошла ошибка.

Формат вызова функции

wp_create_category( $cat_name, $category_parent );

• $cat_name (обязательный) — название категории (строка или число).
• $category_parent (необязательный) — ID родительской категории (число).

Примеры использования

Пример 1: Создание простой категории

Чтобы создать простую категорию, можно использовать такой код:

wp_create_category( 'Моя категория' );

Пример 2: Создание подкатегории

Чтобы создать категорию, которая будет дочерней для категории с ID = 6, нужно указать второй параметр:

wp_create_category( 'Дочерняя категория', 6 );

Пример 3: Получение ID созданной категории

Если хотите сохранить ID созданной категории в переменной, используйте следующий код:

$cat_id = wp_create_category( 'Дочерняя категория', 6 );

Проверка успешности создания категории

Чтобы проверить, была ли успешно создана категория, выполните следующий код:

$cat_id = wp_create_category( 'Разное' );

if( $cat_id ){
echo 'Создано';
} else {
echo 'Не создано';
}

Изменения в функции

• С версии 2.0.0 — функция была введена в WordPress.

Исходный код функции

Функция wp_create_category расположена в файле wp-admin/includes/taxonomy.php:

function wp_create_category( $cat_name, $category_parent = 0 ) {
$id = category_exists( $cat_name, $category_parent );
if ( $id ) {
return $id;
}

return wp_insert_category(
    array(
        'cat_name'        => $cat_name,
        'category_parent' => $category_parent,
    )
);

}

Связанные функции

• cat_is_ancestor_of()
• category_description()
• category_exists()
• get_cat_ID()
• get_cat_name()
• get_categories()
• get_category()
• get_category_by_slug()
• get_category_link()
• get_category_parents()
• get_the_category_by_ID()
• in_category()
• single_cat_title()
• wp_dropdown_categories()
• wp_insert_category()
• wp_list_categories()

Эти функции поможет вам более эффективно работать с категориями в WordPress. Если у вас есть вопросы по использованию, не стесняйтесь уточнять!