编辑“WordPress:Function Reference/add post meta”

==描述==
[[WordPress:Function Reference/add post meta|add_post_meta]]为某篇文章添加了一个自定义的（meta）区。

如果<tt>$unique</tt>参数设置为<var>true</var>而且已经存在特别的meta关键词，函数返回<var>false</var>而且不做什么更改；否则的话，函数返回<var>true</var>。

==用法==

%%% <?php add_post_meta($post_id, $meta_key, $meta_value, $unique); ?> %%%

==例子==

===默认用法===

<?php add_post_meta($68, 'my_key', 47); ?>

===添加或者更新一个独特的区===

如果你存在关键词，添加一个新的field，或者更新现存的field。

  <?php add_post_meta(7, 'fruit', 'banana', true) 或者update_post_meta(7, 'fruit', 'banana'); ?>

===其它的例子===

如果你想要确定没有带有关键字''"my_key"''的fieled，添加之前：

<?php add_post_meta(68, 'my_key', '47', true); ?>
To add several values to the key ''"my_key"'':
<pre><?php add_post_meta(68, 'my_key', '47'); ?>
<?php add_post_meta(68, 'my_key', '682'); ?>
<?php add_post_meta(68, 'my_key', 'The quick, brown fox jumped over the lazy dog.'); ?>
...</pre>

更详细的例子，请进入[[WordPress:Function Reference/post meta Function Examples|post_meta 函数例子]]网页。

=== 制作一个 "隐藏的" 自定义区 ===

如果你是一个插件/主题开发人员而且你计划使用自定义field储存与你的插件或者主题相关的参数，你会饶有兴趣地发现，WordPress习惯于显示网页/文章编辑网页中自定义field列表上以"_"（下划线）开始的关键字。就是说，在自定义参数中将下划线设置为第一个字符，是个很好的做法，这样你可以将设置储存为自定义fields，但是你的设置不会在管理UI中的自定义fields列表中显示。

下面的例子：

<?php add_post_meta(68, '_color', 'red', true); ?>
会添加一个关键字是 "_color" 的自定义范围而且这个自定义范围中的参数值"red"不会在网页/文章编辑网页中显示。

==参数==

{{Parameter|$post_id|integer|The ID of the post to which you will add a custom field.}}
{{Parameter|$meta_key|string|The key of the custom field you will add.}}
{{Parameter|$meta_value|string|The value of the custom field you will add.}}
{{Parameter|$unique|boolean|Whether or not you want the key to be unique. When set to true, this will ensure that there is not already a custom field attached to the post with <tt>$meta_key</tt> as it's key, and, if such a field already exists, the key will not be added.|optional|false}}


{{Parameter|$post_id|integer|你添加一个自定义范围的文章的ID。}}
{{Parameter|$meta_key|string|你将要添加的自定义field的关键词。}}
{{Parameter|$meta_value|string|你将要添加的自定义field的参数值。}}


{{Parameter|$unique|boolean|你是否想要独特的关键字。如果设置为真的，能够确保不存在文章的关键字with <tt>$meta_key</tt> 如果这个field已经存在，这个关键词就不会得到添加。|optional|false}}

==相关的==

[[WordPress:Function Reference/delete post meta|delete_post_meta()]], [[WordPress:Function Reference/get post meta|get_post_meta()]], [[WordPress:Function Reference/update post meta|update_post_meta()]], [[WordPress:Function Reference/get post custom|get_post_custom()]], [[WordPress:Function Reference/get post custom values|get_post_custom_values()]], [[WordPress:Function Reference/get post custom keys|get_post_custom_keys()]]

[[WordPress:Function Reference/delete post meta|delete_post_meta()]], [[WordPress:Function Reference/get post meta|get_post_meta()]], [[WordPress:Function Reference/update post meta|update_post_meta()]], [[WordPress:Function Reference/get post custom|get_post_custom()]], [[WordPress:Function Reference/get post custom values|get_post_custom_values()]], [[WordPress:Function Reference/get post custom keys|get_post_custom_keys()]]