WordPress как на ладони

wp_create_category()WP 2.0.0

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

Перед добавление категории функция проверят нет ли уже категории с указанными параметрами.

Работает на основе: wp_insert_category()

Хуков нет.

Возвращает

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

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

wp_create_category( $cat_name, $parent );
$cat_name(строка) (обязательный)
Название новой категории.
$parent(число)
ID категории, которая будет родительской для добавляемой.

Примеры

0

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

Для создания простой категории используйте:

wp_create_category( 'Название моей категории' );

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

wp_create_category( 'Ребенок моей категории', 6 );

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

$cat_id = wp_create_category( 'Ребенок моей категории', 6 );
0

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

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

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

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

С версии 2.0.0 Введена.

Код wp_create_category() WP 6.0.2

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,
		)
	);
}
4 комментария
    Войти