添加自定义栏目(字段)到文章/页面
描述
add_post_meta为指定文章添加自定义（meta）字段。
若$unique参数设为true且已指定meta关键字，函数返回false，不作更改；否则返回true。
用法
<?php add_post_meta($post_id, $meta_key, $meta_value, $unique); ?> 参数
$post_id
(integer) (必填) 应向其添加自定义字段的帖子的 ID。
默认值: None
$meta_key
(string) (必填) 应添加的自定义域的键。
默认值: None
$meta_value
(mixed) (必填) 应添加的自定义域的值。如果给定一个数组，它将被序列化为一个字符串。
默认值: None
$unique
(boolean) (可选) 您是否希望密钥保持唯一。设置为 true 时，如果给定键已存在于指定帖子的自定义字段中，则不会添加自定义字段。
默认值: false
示例
默认用法
/* ———————————-
* wordpress函数 星空站长网收集
* ———————————- */
<?php add_post_meta( 68, ‘my_key’, 47 ); ?>添加或更新唯一的自定义字段
如果键尚不存在，则添加新的自定义域，否则使用该键更新自定义域的值。
<?php
if ( ! add_post_meta( 7, ‘fruit’, ‘banana’, true ) ) {
update_post_meta ( 7, ‘fruit’, ‘banana’ );
}其他示例
仅当具有给定键的自定义字段尚不存在时，才添加新的自定义字段：
<?php add_post_meta( 68, ‘my_key’, ’47’, true ); ?>添加多个具有不同值但具有相同键“my_key”的自定义字段：
<?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.’ ); ?>
…有关更详细的示例，请参阅post_meta函数示例页面。
隐藏的自定义字段
如果您是插件或主题开发人员，并且计划使用自定义字段来存储与您的插件或模板相关的参数，有趣的是，WordPress 不会在帖子编辑屏幕的自定义字段列表中或使用 the_meta（） 模板函数时显示键以“_”（下划线）开头的自定义字段。例如，这可以用于通过使用 add_meta_box（） 函数以不寻常的方式显示这些自定义字段。
The following example: 以下示例：
<?php add_post_meta( 68, ‘_color’, ‘red’, true ); ?>将添加一个键名称为“_color”和值为“red”的唯一自定义字段，但此自定义字段不会显示在“编辑后”屏幕中。
Hidden Arrays 隐藏数组
此外，如果 $meta_value 参数是一个数组，则它不会显示在页面编辑屏幕上，即使您没有在键名称前面加上下划线也是如此。
注意
使用到 add_metadata().
角色转义
由于元值是通过 stripslashes（） 函数传递的，因此您需要小心使用字符转义的内容。您可以在 update_post_meta（） 文档中阅读有关该行为和解决方法示例的更多信息。
历史
添加于 版本 1.5.0
相关
Custom Fields:
the_meta(),
get_post_meta(),
add_post_meta(),
update_post_meta(),
delete_post_meta(),
get_post_custom(),
get_post_custom_values(),
get_post_custom_keys()
(See Also: post_meta Function(函数) Examples)
