WordPress.org

Make WordPress Core

Ticket #12422: 12422.diff

File 12422.diff, 2.1 KB (added by miqrogroove, 8 years ago)
  • wp-admin/includes/taxonomy.php

     
    8080}
    8181
    8282/**
    83  * {@internal Missing Short Description}}
     83 * Deletes one existing category.
    8484 *
    85  * @since unknown
     85 * @since 2.0.0
    8686 *
    87  * @param unknown_type $cat_ID
    88  * @return unknown
     87 * @param int $cat_ID
     88 * @return mixed Returns TRUE if completes delete action; FALSE if not term; Zero if default cat_ID; WP_Error object is also a possibility.
    8989 */
    9090function wp_delete_category($cat_ID) {
    9191        $cat_ID = (int) $cat_ID;
     
    9999}
    100100
    101101/**
    102  * {@internal Missing Short Description}}
     102 * Updates an existing Category or creates a new Category.
    103103 *
    104  * @since unknown
     104 * @since 2.0.0
    105105 *
    106  * @param unknown_type $catarr
    107  * @param unknown_type $wp_error
    108  * @return unknown
     106 * @param mixed $catarr See defaults below. Set 'cat_ID' to a non-zero value to update an existing category. The 'taxonomy' key was added in 3.0.0.
     107 * @param bool $wp_error Optional, since 2.5.0. Set this to TRUE if the caller handles WP_Error return values.
     108 * @return int|object The ID number of the new or updated Category on success.  Zero or a WP_Error on failure, depending on param $wp_error.
    109109 */
    110110function wp_insert_category($catarr, $wp_error = false) {
    111111        $cat_defaults = array('cat_ID' => 0, 'taxonomy' => 'category', 'cat_name' => '', 'category_description' => '', 'category_nicename' => '', 'category_parent' => '');
     
    157157}
    158158
    159159/**
    160  * {@internal Missing Short Description}}
     160 * Aliases wp_insert_category() with minimal args.
    161161 *
    162  * @since unknown
     162 * If you want to update only some fields of an existing category, call this
     163 * function with only the new values set inside $catarr.
    163164 *
    164  * @param unknown_type $catarr
    165  * @return unknown
     165 * @since 2.0.0
     166 *
     167 * @param array $catarr The 'cat_ID' value is required.  All other keys are optional.
     168 * @return int|bool The ID number of the new or updated Category on success. Zero or FALSE on failure.
    166169 */
    167170function wp_update_category($catarr) {
    168171        $cat_ID = (int) $catarr['cat_ID'];