//
/**
- * {@internal Missing Short Description}}
+ * Check whether a category exists.
*
* @since 2.0.0
*
- * @param int|string $cat_name
- * @return int
+ * @see term_exists()
+ *
+ * @param int|string $cat_name Category name.
+ * @param int $parent Optional. ID of parent term.
+ * @return mixed
*/
-function category_exists($cat_name, $parent = 0) {
+function category_exists( $cat_name, $parent = null ) {
$id = term_exists($cat_name, 'category', $parent);
if ( is_array($id) )
$id = $id['term_id'];
}
/**
- * {@internal Missing Short Description}}
+ * Get category object for given ID and 'edit' filter context.
*
* @since 2.0.0
*
}
/**
- * {@internal Missing Short Description}}
+ * Add a new category to the database if it does not already exist.
*
* @since 2.0.0
*
*/
function wp_create_categories( $categories, $post_id = '' ) {
$cat_ids = array ();
- foreach ($categories as $category) {
- if ($id = category_exists($category))
+ foreach ( $categories as $category ) {
+ if ( $id = category_exists( $category ) ) {
$cat_ids[] = $id;
- else
- if ($id = wp_create_category($category))
- $cat_ids[] = $id;
+ } elseif ( $id = wp_create_category( $category ) ) {
+ $cat_ids[] = $id;
+ }
}
if ( $post_id )
* @param array $catarr {
* Array of arguments for inserting a new category.
*
- * @type int $cat_ID Categoriy ID. A non-zero value updates an existing category.
+ * @type int $cat_ID Category ID. A non-zero value updates an existing category.
* Default 0.
- * @type string $taxonomy Taxonomy slug. Defualt 'category'.
- * @type string $cat_nam Category name. Default empty.
+ * @type string $taxonomy Taxonomy slug. Default 'category'.
+ * @type string $cat_name Category name. Default empty.
* @type string $category_description Category description. Default empty.
* @type string $category_nicename Category nice (display) name. Default empty.
* @type int|string $category_parent Category parent ID. Default empty.
//
/**
- * {@internal Missing Short Description}}
+ * Check whether a post tag with a given name exists.
*
* @since 2.3.0
*
}
/**
- * {@internal Missing Short Description}}
+ * Add a new tag to the database if it does not already exist.
*
* @since 2.3.0
*
}
/**
- * {@internal Missing Short Description}}
+ * Get comma-separated list of tags available to edit.
*
* @since 2.3.0
*
- * @param int $post_id
+ * @param int $post_id
+ * @param string $taxonomy Optional. The taxonomy for which to retrieve terms. Default 'post_tag'.
* @return string|bool|WP_Error
*/
function get_tags_to_edit( $post_id, $taxonomy = 'post_tag' ) {
}
/**
- * {@internal Missing Short Description}}
+ * Get comma-separated list of terms available to edit for the given post ID.
*
* @since 2.8.0
*
- * @param int $post_id
+ * @param int $post_id
+ * @param string $taxonomy Optional. The taxonomy for which to retrieve terms. Default 'post_tag'.
* @return string|bool|WP_Error
*/
function get_terms_to_edit( $post_id, $taxonomy = 'post_tag' ) {
}
/**
- * {@internal Missing Short Description}}
+ * Add a new term to the database if it does not already exist.
*
* @since 2.8.0
*
* @param int|string $tag_name
+ * @param string $taxonomy Optional. The taxonomy for which to retrieve terms. Default 'post_tag'.
* @return array|WP_Error
*/
function wp_create_term($tag_name, $taxonomy = 'post_tag') {