WordPress.org

Ready to get started?Download WordPress

Codex

Attention Interested in functions, hooks, classes, or methods? Check out the new WordPress Code Reference!

it:Riferimento funzioni/wp insert category

Descrizione

Inserisce una nuova categoria nel sistema di tassonomia.

Utilizzo

<?php wp_insert_category$catarr$wp_error ); ?>

Parametri

$catarr
(array) (richiesto) Informazioni sulla categoria.
Default: Nessuno
$catarr viene confrontato con un array contenente i seguenti valori predefiniti:
$cat_defaults = array(
  'cat_ID' => 0,
  'cat_name' => ,
  'category_description' => ,
  'category_nicename' => ,
  'category_parent' => ,
  'taxonomy' => 'category' );
$catarr può contenere valori aggiuntivi, ma è raccomandato fornire almeno il minimo di quelli definiti in $cat_defaults.
$wp_error
(boolean) (opzionale) Indica se restituire un WP_Error o un booleano. Il booleano è il valore predefinito.
Default: false

Valori restituiti

(boolean o WP_Error o int) (richiesto) True in caso di successo e false in caso di fallimento; oppure l'ID della nuova categoria in caso di successo e un WP_Error in caso di fallimento.
Default: Nessuno

Esempi

Per inserire una nuova categoria usare:

%%%//Definire la categoria
$my_cat = array('cat_name' => 'La mia categoria', 'category_description' => 'Un bella categoria', 'category_nicename' => 'category-slug', 'category_parent' => '');

// Creare la categoria
$my_cat_id = wp_insert_category($my_cat);

Note

  • Non tutti i possibili membri dell'array $catarr sono elencati qui.
  • Si veda wp_create_category() per una versione più semplice che richiede solo una stringa invece di un array.

File sorgente

wp_insert_category() si trova in wp-admin/includes/taxonomy.php.

Correlati

Si veda anche l'indice di Riferimento funzioni e l'indice di Tag dei template.