Switch language

wpseek.com
A WordPress-centric search engine for devs and theme authors




wp_insert_category [ WordPress Function ]

wp_insert_category ( $catarr, $wp_error = false )
Parameters:
  • (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.
  • (bool) $wp_error Optional, since 2.5.0. Set this to true if the caller handles WP_Error return values.
Returns:
  • (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.
Defined at:



Updates an existing Category or creates a new Category.

Source


<?php
function wp_insert_category($catarr$wp_error false) {
    
$cat_defaults = array('cat_ID' => 0'taxonomy' => 'category''cat_name' => '''category_description' => '''category_nicename' => '''category_parent' => '');
    
$catarr wp_parse_args($catarr$cat_defaults);
    
extract($catarrEXTR_SKIP);

    if ( 
trim$cat_name ) == '' ) {
        if ( ! 
$wp_error )
            return 
0;
        else
            return new 
WP_Error'cat_name'__('You did not enter a category name.') );
    }

    
$cat_ID = (int) $cat_ID;

    
// Are we updating or creating?
    
if ( !empty ($cat_ID) )
        
$update true;
    else
        
$update false;

    
$name $cat_name;
    
$description $category_description;
    
$slug $category_nicename;
    
$parent $category_parent;

    
$parent = (int) $parent;
    if ( 
$parent )
        
$parent 0;

    if ( empty( 
$parent ) || ! term_exists$parent$taxonomy ) || ( $cat_ID && term_is_ancestor_of$cat_ID$parent$taxonomy ) ) )
        
$parent 0;

    
$args compact('name''slug''parent''description');

    if ( 
$update )
        
$cat_ID wp_update_term($cat_ID$taxonomy$args);
    else
        
$cat_ID wp_insert_term($cat_name$taxonomy$args);

    if ( 
is_wp_error($cat_ID) ) {
        if ( 
$wp_error )
            return 
$cat_ID;
        else
            return 
0;
    }

    return 
$cat_ID['term_id'];
}
?>

Examples [ wp-snippets.com ]

Top Google zoekresultaten

Meer ...

0 User Note(s)

Nog geen één. Wees de eerste!

Nieuw toevoegen ...



HTML5 Powered with CSS3 / Styling, Performance & Integration, and Semantics