wpseek.com
Un motore di ricerca WordPress per sviluppatori e autori di temi



add_term_meta › WordPress Function

Da4.4.0
Deprecaton/a
› add_term_meta ( $term_id, $meta_key, $meta_value, $unique = false )
Parametri: (4)
  • (int) $term_id Term ID.
    Richiesto: Sì
  • (string) $meta_key Metadata name.
    Richiesto: Sì
  • (mixed) $meta_value Metadata value. Arrays and objects are stored as serialized data and will be returned as the same type when retrieved. Other data types will be stored as strings in the database: - false is stored and retrieved as an empty string ('') - true is stored and retrieved as '1' - numbers (both integer and float) are stored and retrieved as strings Must be serializable if non-scalar.
    Richiesto: Sì
  • (bool) $unique Optional. Whether the same key should not be added. Default false.
    Richiesto: No
    Default: false
Ritorna:
  • (int|false|WP_Error) Meta ID on success, false on failure.
    WP_Error when term_id is ambiguous between taxonomies.
Definito a:
Codex:

Adds metadata to a term.

For historical reasons both the meta key and the meta value are expected to be "slashed" (slashes escaped) on input.


Funzioni correlate: add_site_meta, add_user_meta, has_term_meta, add_post_meta, get_term_meta

Sorgenti 

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 );
}