Changeset 31140

Timestamp:

01/11/2015 01:25:19 AM (10 years ago)

Author:

boonebgorges

Message:

Default $parent in category_exists() should default to null rather than 0.

[29863] made the corresponding change in term_exists(). Failure to change the
default value in category_exists() meant that an unspecified value for
$parent would limit results to top-level categories.

Includes unit tests and corrected function documentation.

Props hissy.
Fixes #30975 for trunk.

Location:

trunk

Files:

• src/wp-admin/includes/taxonomy.php (modified) (1 diff)
• tests/phpunit/tests/term/categoryExists.php (added)

trunk/src/wp-admin/includes/taxonomy.php

@@ -12 +12 @@
 
 /**
- * {@internal Missing Short Description}}
- *
- * @since 2.0.0
- *
- * @param int|string $cat_name
- * @return int
- */
-function category_exists($cat_name, $parent = 0) {
+ * Check whether a category exists.
+ *
+ * @since 2.0.0
+ *
+ * @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 = null ) {
     $id = term_exists($cat_name, 'category', $parent);
     if ( is_array($id) )