WordPress-C
/
WordPress
mirror of https://github.com/WordPress/WordPress.git
1
0
Fork 0
Code Issues Packages Projects Releases Wiki Activity

Clarify error handling and special cases in the `wp_insert_term()` phpdoc block. 

props lgedeon, SergeyBiryukov. See #22801.

Built from https://develop.svn.wordpress.org/trunk@25498


git-svn-id: http://core.svn.wordpress.org/trunk@25419 1a063a9b-81f0-0310-95a4-ce76da25c4cd
This commit is contained in:
Drew Jaynes 2013-09-19 16:09:10 +00:00
parent 8595facd73
commit 00ca46973c
1 changed files with 9 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
wp-includes/taxonomy.php
View File

@ -2030,17 +2030,19 @@ function wp_get_object_terms($object_ids, $taxonomies, $args = array()) {
* 5. Several more actions are fired.
* 6. An array is returned containing the term_id and term_taxonomy_id.
*
* If the 'slug' argument is not empty, then it will be checked to see if the term
* is invalid. If it is not a valid, existing term, it is added and the term_id is given.
* If the taxonomy is hierarchical, and the 'parent' argument is not empty, the term
* will be inserted and the term_id will be given.
* If the 'slug' argument is not empty, then it is checked to see if the term
* is invalid. If it is not a valid, existing term, it is added and the term_id
* is given.
*
* If the taxonomy is hierarchical, and the 'parent' argument is not empty,
* the term is inserted and the term_id will be given.
* Error handling:
* If $taxonomy does not exist -- or $term is numeric or empty,
* If $taxonomy does not exist or $term is empty,
* a WP_Error object will be returned.
*
* If the term already exists, the term slug is not unique, or both the term id and taxonomy
* already exist, a WP_Error object will be returned.
* If the term already exists on the same hierarchical level,
* or the term slug and name are not unique, a WP_Error object will be returned.
*
* @global wpdb $wpdb The WordPress database object.