更新术语元数据。

原型

update_term_meta( int $term_id, string $meta_key, mixed $meta_value, mixed $prev_value = '' )

描述

使用$ prev_value参数来区分具有相同键和术语ID的元字段。

参数

$term_id (int) (Required) 术语ID。

$meta_key (string) (Required) 元数据键。

$meta_value (mixed) (Required) 元数据价值。

$prev_value (mixed) (Optional)  要删除之前要检查的上一个值。

返回值

(int|WP_Error|bool)  如果密钥以前不存在,则为元ID。成功更新时为True。

源文件

路径:wp-includes/taxonomy.php

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

其他

英文文档:https://developer.wordpress.org/reference/functions/update_term_meta/