delete_post_meta

函数
delete_post_meta ( $post_id, $meta_key, $meta_value = '' )
参数
  • (int) $post_id Post ID.
    Required:
  • (string) $meta_key Metadata name.
    Required:
  • (mixed) $meta_value Optional. Metadata value. If provided, rows will only be removed that match the value. Must be serializable if non-scalar. Default empty.
    Required:
    Default: (empty)
返回值
  • (bool) True on success, false on failure.
定义位置
相关方法
delete_site_metaget_post_metadelete_post_meta_by_keydelete_user_metaupdate_post_meta
引入
1.5.0
弃用
-

delete_post_meta函数: 该函数用于删除与一个特定文章相关的元数据。它需要三个参数:文章的ID,要删除的元数据的名称,以及一个可选的元值来匹配。如果提供了元值,只有具有该值的元数据才会被删除: 该函数成功时返回true,失败时返回false。

为给定的文章ID删除一个文章元域。

你可以根据键,或键和值来匹配。基于键和值的删除,将避免删除具有相同键的重复元数据。如果需要的话,它还可以删除所有与键匹配的元数据。

function delete_post_meta( $post_id, $meta_key, $meta_value = '' ) {
	// Make sure meta is deleted from the post, not from a revision.
	$the_post = wp_is_post_revision( $post_id );
	if ( $the_post ) {
		$post_id = $the_post;
	}

	return delete_metadata( 'post', $post_id, $meta_key, $meta_value );
}

常见问题

FAQs
查看更多 >