wp_create_category()
Спрощена функція додавання категорії, в яку потрібно передати назву нової категорії та якщо потрібно ID батьківської категорії.
Перед додаванням категорії функція перевірять чи немає категорії з зазначеними параметрами.
Працює на основі:
wp_insert_category()
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.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,
)
);
}