Subject: [wp-svn] [39893]
trunk/src/wp-includes/taxonomy.php: Docs: In
`wp_set_object_terms( )`, add a note that passing
an empty value as `terms` argument will remove all
related terms.



Revision 39893 Author SergeyBiryukov Date 2017-01-12 06:53:21 +0000 (Thu, 12 Jan 2017)
Docs: In `wp_set_object_terms()`, add a note that passing an empty value as `$terms` argument will remove all related terms.

Props barryceelen.
Fixes #36690.
Modified Paths Diff Modified: trunk/src/wp-includes/taxonomy.php
--- trunk/src/wp-includes/taxonomy.php	2017-01-12 06:37:06 UTC (rev 39892)
+++ trunk/src/wp-includes/taxonomy.php	2017-01-12 06:53:21 UTC (rev 39893)
@@ -2213,8 +2213,9 @@
  * @global wpdb $wpdb The WordPress database abstraction object.
  *
  * @param int              $object_id The object to relate to.
- * @param array|int|string $terms     A single term slug, single term id, or array of either term slugs or ids.
- *                                    Will replace all existing related terms in this taxonomy.
+ * @param string|int|array $terms     A single term slug, single term id, or array of either term slugs or ids.
+ *                                    Will replace all existing related terms in this taxonomy. Passing an
+ *                                    empty value will remove all related terms.
  * @param string           $taxonomy  The context in which to relate the term to the object.
  * @param bool             $append    Optional. If false will delete difference of terms. Default false.
  * @return array|WP_Error Term taxonomy IDs of the affected terms.
@@ -2341,7 +2342,7 @@
  * @since 3.6.0
  *
  * @param int              $object_id The ID of the object to which the terms will be added... 

. - * @param array|int|string $terms The slug(s) or ID(s) of the term(s) to add. + * @param string|int|array $terms The slug(s) or ID(s) of the term(s) to add. * @param array|string $taxonomy Taxonomy name. * @return array|WP_Error Term taxonomy IDs of the affected terms. */ @@ -2357,7 +2358,7 @@ * @global wpdb $wpdb WordPress database abstraction object. * * @param int $object_id The ID of the object from which the terms will be removed. - * @param array|int|string $terms The slug(s) or ID(s) of the term(s) to remove. + * @param string|int|array $terms The slug(s) or ID(s) of the term(s) to remove. * @param array|string $taxonomy Taxonomy name. * @return bool|WP_Error True on success, false or WP_Error on failure. */
_______________________________________________
wp-svn mailing list
[email protected]
http://lists.wordpress.org/mailman/listinfo/wp-svn



Programming list archiving by: Enterprise Git Hosting