wp_create_category() WP 2.0.0

Упрощенная функция добавления категории, в которую нужно передать название новой категории и если нужно ID родительской категории.

Хуков нет.

Возвращает

int|WP_Error. 0 - при неудаче. ID добавленной категории, если удалось добавить рубрику.

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

wp_create_category( $cat_name, $parent );

$cat_name(строка) (обязательный)

Название новой категории.

$parent(число)

ID категории, которая будет родительской для добавляемой.

Примеры

#1 Создадим рубрику "разное"

wp_create_category('Разное');

#2 Создадим дочернюю рубрику

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

wp_create_category('PHP', 6);

#3 Проверка создалась ли категория

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

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

Список изменений

Код wp_create_category() wp create category ^{WP 5.7.2}

<?php
function wp_create_category( $cat_name, $parent = 0 ) {
	$id = category_exists( $cat_name, $parent );
	if ( $id ) {
		return $id;
	}

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

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

Из раздела: Рубрики