描述:
更新文章/页面的自定义字段(post meta)信息
用法:
<?php update_post_meta($post_id, $meta_key, $meta_value, $prev_value); ?>
参数:
$post_id
(integer) (必填) 要更新metabox的文章的ID
默认值: None
$meta_key
(string) (必填) 要更新的metabox的键(key)
默认值: None
$meta_value
(mixed) (必填) 要更新的metabox的值(这个值是你希望它更新完之后的值,不是它现有的值)
默认值: None
$prev_value
(mixed) (可选) 要更改的自定义字段的旧值。这是为了区分具有相同键的几个字段。如果省略,并且此post和meta key有多行,则将更新所有meta值。
默认值: Empty
示例:
<?php update_post_meta(76, 'my_key', 'Steve'); ?>
源文件:
function update_post_meta( $post_id, $meta_key, $meta_value, $prev_value = '' ) {
// Make sure meta is added to the post, not a revision.
$the_post = wp_is_post_revision( $post_id );
if ( $the_post ) {
$post_id = $the_post;
}
return update_metadata( 'post', $post_id, $meta_key, $meta_value, $prev_value );
}