delete_term_meta( int $term_id, string $meta_key, mixed $meta_value = '' )
Removes metadata matching criteria from a term.
Parameters
- $term_id
-
(Required) Term ID.
- $meta_key
-
(Required) Metadata name.
- $meta_value
-
(Optional) Metadata value. If provided, rows will only be removed that match the value.
Default value: ''
Return
(bool) True on success, false on failure.
Source
File: wp-includes/taxonomy.php
function delete_term_meta( $term_id, $meta_key, $meta_value = '' ) {
// Bail if term meta table is not installed.
if ( get_option( 'db_version' ) < 34370 ) {
return false;
}
$deleted = delete_metadata( 'term', $term_id, $meta_key, $meta_value );
// Bust term query cache.
if ( $deleted ) {
wp_cache_set( 'last_changed', microtime(), 'terms' );
}
return $deleted;
}
Changelog
Version | Description |
---|---|
WP-4.4.0 | Introduced. |