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 create category

Descrizione

Questa funzione aggiunge una nuova categoria specificando il nome e opzionalmente una categoria genitore.

Utilizzo

<?php wp_create_category$cat_name$parent ); ?>

Parametri

$cat_name
(string) (richiesto) Nome per la nuova categoria.
Default: Nessuno
$parent
(integer) (opzionale) ID della categoria genitore.
Default: Nessuno

Valori restituiti

(integer) 
0 in caso di fallimento, ID della nuova categoria in caso di successo.

Esempi

Per creare una categoria si può usare:

 wp_create_category('La mia categoria');

Per creare una categoria figlia di "Senza categoria" (o altra categoria che abbia ID 0), si può usare:

wp_create_category('Figlia di Senza categoria', 0);

Per ottenere l'ID della categoria creata e metterne il valore in una variabie:

$id = wp_create_category('Figlia di Senza categoria', 0);

Notes

  • wp_create_category() è una funzione contenitore per wp_insert_category().
  • Trattandosi di un contenitore, non è adatta alla creazione di elementi dalla tassonomia complessa.
  • Se la categoria esiste già, non viene duplicata. L'ID della categoria esistente viene restituito senza dare errori.

File sorgente

wp_create_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.