add_term_meta()

Aggiunge un meta campo (campo aggiuntivo) per un elemento della tassonomia specificata (categorie, etichette …).
Funziona sulla base di: add_metadata(), wp_term_is_shared()

Non ci sono hook.
ritorna

Numero /WP_Error/true/ alse.

ID: in caso di aggiunta corretta.
WP_Error – in caso di tassonomia term_id definita in modo errato.
Falso: in caso di errore durante il processo di aggiunta.

l’uso di

add_term_meta ($term_id, $meta_key, $meta_value, $unique);
$term_id (numero) (richiesto)
ID del termine tassonomia.
$meta_key (stringa) (richiesto)
Meta campo chiave.
$meta_value (misto) (richiesto)
Il valore del meta campo.
$unique (booleano)


Questo valore è unico o no.

false: significa che per questo elemento di tassonomia è possibile definire più chiavi identiche.
true: significa che può esserci solo una chiave per questo elemento, ad es. se tale chiave esiste già, la funzione non aggiungerà nulla.
Predefinito: falso

esempi
# 1 Aggiungi un meta campo con un singolo valore

$term_id = 62;
$meta_key = 'test_meta_field';
add_term_meta($term_id, $meta_key, 'Hello world', true);
// stampa
echo get_term_meta ($term_id, $meta_key, true); // stampa "Hello world"
// prova ad aggiungere un altro campo con la stessa chiave
$done = add_term_meta ($term_id, $meta_key, 'Hello world 2', true);
var_dump ($done); // bool (false)

# 2 Aggiungi più valori per un meta campo

$term_id = 62;
$meta_key = 'test_meta_field';
// Aggiungi
add_term_meta ($term_id, $meta_key, 'Hello World', false);
add_term_meta ($term_id, $meta_key, 'Hello world', false);
// guarda cosa è successo
$campi = get_term_meta ($ term_id, $ meta_key);
print_r ($campi);
/ * verrà emesso
schieramento
(
[0] => ciao mondo
[1] => Ciao mondo
)
* /


elenco delle modifiche
Dalla versione 4.4.0 introdotta.
Aggiungi termine metacodice: wp-Includes/taxonomy.php WP 5.2.2


function add_term_meta($term_id, $meta_key, $meta_value, $unique=false ) {
if ( wp_term_is_shared( $term_id ) ) {
return new WP_Error( 'ambiguous_term_id', __( 'Term meta cannot be added to terms that are shared between taxonomies.' ), $term_id );
}

return add_metadata( 'term', $term_id, $meta_key, $meta_value, $unique );
}