WordPress.org

Make WordPress Core

Ticket #12422: 12422.diff

File 12422.diff, 2.1 KB (added by miqrogroove, 6 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'];