WordPress at a glance

update_term_meta() WP 1.0

Updates term metadata.

Use the $prev_value parameter to differentiate between meta fields with the same key and term ID.

If the meta field for the term does not exist, it will be added.

No Hooks.

Return

Int/WP_Error/true/false. Meta ID if the key didn't previously exist. True on successful update. WP_Error when term_id is ambiguous between taxonomies. False on failure.

Usage

update_term_meta( $term_id, $meta_key, $meta_value, $prev_value );
$term_id(int) (required)
Term ID.
$meta_key(string) (required)
Metadata key.
$meta_value(mixed) (required)
Metadata value.
$prev_value(mixed)
Previous value to check before removing.
Default: ''

Code of update term meta: wp-includes/taxonomy.php WP 5.2.1

<?php
function update_term_meta( $term_id, $meta_key, $meta_value, $prev_value = '' ) {
	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 update_metadata( 'term', $term_id, $meta_key, $meta_value, $prev_value );
}

Related Functions

From tag: Metadatas (any)

No comments
    Hello, !     Log In . Register