WordPress: Function Reference/update post meta：修订间差异

来自站长百科
跳转至： 导航、​ 搜索
无编辑摘要
无编辑摘要
 
第1行： 第1行：
==Description==
==描述==
==描述==
The function, [[WordPress:Function Reference/update post meta|update post meta()]], updates the value of an existing meta key (custom field) for the specified post.
函数 [[WordPress:Function Reference/update post meta|update post meta()]]为某篇文章更新现存的meta key（自定义区）。
函数 [[WordPress:Function Reference/update post meta|update post meta()]]为某篇文章更新现存的meta key（自定义区）。
The function returns <var>true</var> upon successful updating, and returns <var>false</var> if the post does not have the meta key specified.


成功更新之后，函数返回<var>true</var>，如果文章没有规定meta key，函数返回<var>false</var>。
成功更新之后，函数返回<var>true</var>，如果文章没有规定meta key，函数返回<var>false</var>。
If you want to add a new meta key and value, use the [[WordPress:Function Reference/add post meta|add_post_meta()]] function instead.


如果你想要添加一个新的meta key和参数值，请使用[[WordPress:Function Reference/add post meta|add_post_meta()]]函数。
如果你想要添加一个新的meta key和参数值，请使用[[WordPress:Function Reference/add post meta|add_post_meta()]]函数。
==Usage==


==用法==
==用法==
第19行： 第10行：
%%% <?php update_post_meta($post_id, $meta_key, $meta_value, $prev_value); ?> %%%
%%% <?php update_post_meta($post_id, $meta_key, $meta_value, $prev_value); ?> %%%


%%% <?php update_post_meta($post_id, $meta_key, $meta_value, $prev_value); ?> %%%
==Examples==
===Default Usage===
==例子==
==例子==
===默认用法===
===默认用法===
<?php update_post_meta(76, 'my_key', 'Steve'); ?>


<?php update_post_meta(76, 'my_key', 'Steve'); ?>
<?php update_post_meta(76, 'my_key', 'Steve'); ?>


===Other Examples===
===其它的例子===
===其它的例子===
Assuming a post has an ID of 76, and the following 4 custom fields:


假定一篇文章的ID是76，下面的4个自定义区：
假定一篇文章的ID是76，下面的4个自定义区：
<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
[key_1] => 'Happy'<br/>
[key_1] => 'Sad'<br/>
[key_2] => 'Gregory'<br/>
[my_key] => 'Steve'<br/>
</div>


<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
第50行： 第26行：
</div>
</div>


To change <tt>key_2</tt>'s value to ''Hans'':
将<tt>key_2</tt>的参数值更改为''Hans'':
将<tt>key_2</tt>的参数值更改为''Hans'':
<?php update_post_meta(76, 'key_2', 'Hans'); ?>


<?php update_post_meta(76, 'key_2', 'Hans'); ?>
<?php update_post_meta(76, 'key_2', 'Hans'); ?>
To change <tt>key_1</tt>'s value from ''Sad'' to ''Happy'':
<?php update_post_meta(76, 'key_1', 'Happy', 'Sad'); ?>


将<tt>key_1</tt>的参数值从''悲伤'' 更改为 ''愉悦''：
将<tt>key_1</tt>的参数值从''悲伤'' 更改为 ''愉悦''：
第64行： 第34行：
<?php update_post_meta(76, 'key_1', 'Happy', 'Sad'); ?>
<?php update_post_meta(76, 'key_1', 'Happy', 'Sad'); ?>


The fields would now look like this:
Fields现在看起来像：
Fields现在看起来像：
<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
第72行： 第41行：
[my_key] => 'Steve'<br/>
[my_key] => 'Steve'<br/>
</div>
</div>
<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
[key_1] => 'Happy'<br/>
[key_1] => 'Happy'<br/>
[key_2] => 'Hans'<br/>
[my_key] => 'Steve'<br/>
</div>
'''''Note:''' This function will update only the first field that matches the criteria.''
'''''注:'''这个函数只会更新匹配标准的第一个field。''
'''''注:'''这个函数只会更新匹配标准的第一个field。''
To change the first <tt>key_1</tt>'s value from ''Happy'' to ''Excited'':


将第一个<tt>key_1</tt>的参数值从''高兴'' 更改为 ''兴奋的''：
将第一个<tt>key_1</tt>的参数值从''高兴'' 更改为 ''兴奋的''：
<pre><?php
  update_post_meta(76, 'key_1', 'Excited', 'Happy');
  //Or
  update_post_meta(76, 'key_1', 'Excited');
  //To change all fields with the key "key_1":
  $key1_values = get_post_custom_values('key_1', 76);
  foreach ( $key1_values as $value )
    update_post_meta(76, 'key_1', 'Excited', $value);
?></pre>


<pre><?php  
<pre><?php  
第113行： 第58行：
     update_post_meta(76, 'key_1', 'Excited', $value);
     update_post_meta(76, 'key_1', 'Excited', $value);
?></pre>
?></pre>
关于更详细的例子，请进入[[WordPress:Function Reference/post meta Function Examples|post_meta 函数例子]]网页。


For a more detailed example, go to the [[WordPress:Function Reference/post meta Function Examples|post_meta Functions Examples]] page.
关于更详细的例子，请进入[[WordPress:Function Reference/post meta Function Examples|post_meta 函数例子]]网页。
==Parameters==


==参数==
==参数==
{{Parameter|$post_id|integer|The ID of the post which contains the field you will edit.}}
{{Parameter|$meta_key|string|The key of the custom field you will edit.}}
{{Parameter|$meta_value|string|The new value of the custom field.}}
{{Parameter|$prev_value|string|The old value of the custom field you wish to change. This is to differentiate between several fields with the same key.|optional}}
{{Parameter|$post_id|integer|包含你需要编辑的field的文章的ID。}}
{{Parameter|$post_id|integer|包含你需要编辑的field的文章的ID。}}
{{Parameter|$meta_key|string|你需要编辑的自定义field的关键字。}}
{{Parameter|$meta_key|string|你需要编辑的自定义field的关键字。}}
{{Parameter|$meta_value|string|自定义field的新的参数值。}}
{{Parameter|$meta_value|string|自定义field的新的参数值。}}
{{Parameter|$prev_value|string|你想要更改的自定义field的旧的参数值。这是要区分几个相同关键词的field。|可选择的}}
{{Parameter|$prev_value|string|你想要更改的自定义field的旧的参数值。这是要区分几个相同关键词的field。|可选择的}}
==Related==


==相关的==
==相关的==

2008年7月23日 (三) 10:27的最新版本

描述[ ]

函数 update post meta()为某篇文章更新现存的meta key（自定义区）。

成功更新之后，函数返回true，如果文章没有规定meta key，函数返回false。

如果你想要添加一个新的meta key和参数值，请使用add_post_meta()函数。

用法[ ]

%%% <?php update_post_meta($post_id, $meta_key, $meta_value, $prev_value); ?> %%%

例子[ ]

默认用法[ ]

<?php update_post_meta(76, 'my_key', 'Steve'); ?>

其它的例子[ ]

假定一篇文章的ID是76，下面的4个自定义区：

[key_1] => '愉快'
[key_1] => '悲伤'
[key_2] => 'Gregory'
[my_key] => 'Steve'

将key_2的参数值更改为Hans:

<?php update_post_meta(76, 'key_2', 'Hans'); ?>

将key_1的参数值从悲伤 更改为 愉悦：

<?php update_post_meta(76, 'key_1', 'Happy', 'Sad'); ?>

Fields现在看起来像：

[key_1] => 'Happy'
[key_1] => 'Happy'
[key_2] => 'Hans'
[my_key] => 'Steve'

注:这个函数只会更新匹配标准的第一个field。

将第一个key_1的参数值从高兴 更改为 兴奋的： 

<?php 
  update_post_meta(76, 'key_1', 'Excited', 'Happy');

  //或者

  update_post_meta(76, 'key_1', 'Excited');

  //更改所有关键字为 "key_1"的fields:

  $key1_values = get_post_custom_values('key_1', 76);
  foreach ( $key1_values as $value )
    update_post_meta(76, 'key_1', 'Excited', $value);
?>

关于更详细的例子，请进入post_meta 函数例子网页。


参数[ ]

相关的[ ]

delete_post_meta(), get_post_meta(), add_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys()

delete_post_meta(), get_post_meta(), add_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys()

取自“https://www.zzbaike.com/wiki/index.php?title=WordPress:Function_Reference/update_post_meta&oldid=6697”