sergiotarxz
/
Wordpress
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity

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

props lgedeon, SergeyBiryukov. See #22801.


git-svn-id: https://develop.svn.wordpress.org/trunk@25498 602fd350-edb4-49c9-b593-d223f7449a82
This commit is contained in:
Drew Jaynes 2013-09-19 16:08:30 +00:00
parent 24db2253b3
commit bb42ed6893
1 changed files with 9 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

16
src/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.