//
/**
- * {@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 )
//
/**
- * {@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') {