wp_create_category()
Упрощенная функция добавления категории, в которую нужно передать название новой категории и если нужно ID родительской категории.
Перед добавление категории функция проверят нет ли уже категории с указанными параметрами.
Работает на основе: wp_insert_category()
Хуков нет.
Возвращает
int|WP_Error. 0 - при неудаче. ID добавленной категории, если удалось добавить рубрику.
Использование
wp_create_category( $cat_name, $parent );
- $cat_name(строка) (обязательный)
- Название новой категории.
- $parent(число)
- ID категории, которая будет родительской для добавляемой.
Примеры
#1 Создадим рубрику
Для создания простой категории используйте:
wp_create_category( 'Название моей категории' );
Чтобы создать категорию, которая является дочерней к категории с ID = 6, укажите второй параметр:
wp_create_category( 'Ребенок моей категории', 6 );
Чтобы получить id созданной категории и поместить значение в переменную:
$cat_id = wp_create_category( 'Ребенок моей категории', 6 );
#2 Проверка создалась ли категория
$cat_id = wp_create_category('Разное');
if( $cat_id )
echo 'Создана';
else
echo 'Не создана';
Список изменений
| С версии 2.0.0 | Введена. |
Код wp_create_category() wp create category WP 6.3.1
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,
)
);
}