WordPress.org

Codex

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

es:Function Reference/wp insert term

Descripción

Agrega un nuevo termino a la base de datos. Opcionalmente lo marca como un alias de un termino existente.

Uso

<?php wp_insert_term$term$taxonomy$args = array() ); ?>

Parámetros

$term
(int|string) (required) Término a agregar o actualizar.
Default: None
$taxonomy
(string) (required) La taxonomía a la que vamos a agregar el término.
Default: None
$args
(array|string) (optional) Change the values of the inserted term
Default: None

Argumentos

Los argumentos deciden como el término será manejado según el parámetro $args. A continuación una lista de valores disponibles y los que vienen predeterminados.

'alias_of'
(string) (opcional) No se usa de forma predeterminado, pero si se agrega, se espera que el termino slug pueda ser un alias de (alias of).
Default: None
'description'
(string) (opcional) Si existe, puede ser agregado a la base de datos junto con el término.
Default: None
'parent'
(numeric) (opcional) Puede asignar un valor de 'padre' para el término.
Default: 0 (cero)
'slug'
(string) (opcional)
Default: None

Si el argumento 'slug' existe entonces puede ser usado para chequear y ver si un término no es válido. Si este chequeo tiene éxito (No es un término válido), entonces será agregado y devuelve el id. Si fallará, entonces se hará un chequeo a la taxonomía si es heredada y el argumento padre esta declarado. Si el segundo chequeo tiene éxito, será insertado y devolverá el id del término. Si el argumento slug esta vacío, entonces todo esto será calculado desde el termino nombre (name).

Valores Devueltos

(array|WP_Error) 
El ID del término y de la taxonomía. (Por ejemplo: array('term_id'=>12,'term_taxonomy_id'=>34))

Error handling is assigned for the nonexistence of the $taxonomy and $term parameters before inserting. If both the term id and taxonomy exist previously, then an array will be returned that contains the term id and the contents of what is returned. The keys of the array are 'term_id' and 'term_taxonomy_id' containing numeric values.

It is assumed that the term does not yet exist or the above will apply. The term will be first added to the term table and then related to the taxonomy if everything is well. If everything is correct, then several actions will be run prior to a filter and then several actions will be run after the filter is run.

Ejemplos

$parent_term = term_exists( 'fruits', 'product' ); // retorna una arreglo si declaramos una taxonomía
$parent_term_id = $parent_term['term_id']; // tomamos el id del término (numerico)
wp_insert_term(
  'Apple', // el término
  'product', // la taxonomía
  array(
    'description'=> 'Una deliciosa manzana.',
    'slug' => 'apple',
    'parent'=> $parent_term_id
  )
);

Hooks Used

  • 'pre_insert_term' filter with $term and $taxonomy as parameters

This function calls these hooks with term id and taxonomy id as parameters:

  • 'create_term' action
  • 'create_$taxonomy' action
  • 'term_id_filter' filter
  • 'created_term' action
  • 'created_$taxonomy' action

Change Log

Desde: 2.3.0

Archivos de Origen

wp_insert_term() se localiza en wp-includes/taxonomy.php.

Relacionado

wp_update_term, wp_unique_term_slug

See also index of Function Reference and index of Template Tags.