Question

wp_create_category( int|string $cat_name,  int $parent )

Add a new category to the database if it does not already exist.

---

description

---

参数

$cat_name

(int|string) (Required)

$parent

(int) (Required)

---

返回值

(int|WP_Error)

---

源代码

File: wp-admin/includes/taxonomy.php

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

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

---

更新日志

Version	description
2.0.0	Introduced.

---

相关函数

Uses

• wp-admin/includes/taxonomy.php: category_exists()
• wp-admin/includes/taxonomy.php: wp_insert_category()

---

Used By

• wp-admin/includes/taxonomy.php: wp_create_categories()

---

User Contributed Notes

1. Skip to note content You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note Contributed by Codex

   Examples

   In order to create a simple category use:

   
    wp_create_category( 'My category name' );
   

   To create a category that is a child of Uncategorized (or whatever category has the ID 0), use:

   
   wp_create_category( 'Child of Uncategorized', 0 );
   

   To get id of category created and put value in variable:

   
   $id = wp_create_category( 'Child of Uncategorized', 0 );