WordPress功能函数add_post_meta()，添加一个元字段到给定的帖子。

用法：

add_post_meta( int $post_id, string $meta_key, mixed $meta_value, bool $unique = false )

描述

Post元数据在管理屏幕上称为“自定义字段”。

参数：

$post_id

(int) (必需) Post ID。

$meta_key

(string) (必需) 元数据名称。

$meta_value

(mixed) (必需) 元数据的值。如果是非标量，则必须是可序列化的。

$unique

(bool) (可选) 是否不应该添加相同的键。

默认值: false

返回

(int|false)成功时元ID，失败时false。

更多信息

注意，如果给定的键已经存在于指定post的自定义字段中，那么将添加另一个具有相同键的自定义字段，除非$unique参数设置为true，在这种情况下，不会进行任何更改。如果要更新现有键的值，请使用update_post_meta()函数

字符转义

因为元值是通过stripslashes()函数传递的，所以您需要小心使用字符转义的内容。您可以在update_post_meta()文档中阅读更多关于该行为和一个解决方法的示例。

来源：

文件: wp-includes/post.php

function add_post_meta( $post_id, $meta_key, $meta_value, $unique = false ) {

// 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 add_metadata( ‘post’, $post_id, $meta_key, $meta_value, $unique );

}
更新日志：

用户贡献的笔记

（由Codex – 6年前贡献）

隐藏的定制字段

如果你是一个插件或者主题开发者和你打算使用定制字段来存储你的插件或模板参数相关,有趣的是,WordPress不会显示定制字段的键从一个“_”(下划线)在《华盛顿邮报》上的定制字段列表编辑屏幕或当使用the_meta()模板函数。例如，可以使用add_meta_box()函数以一种不同寻常的方式显示这些定制字段。

下面的例子:

<?php add_post_meta( 68, ‘_color’, ‘red’, true ); ?>

将添加一个唯一的自定义字段与键名_color和值’ red ‘，但这个自定义字段不会显示在post编辑屏幕。

此外，如果$meta_value参数是一个数组，它将不会显示在页面编辑屏幕上，即使您不以下划线作为键名的前缀。

（由Codex – 6年前贡献）

添加或更新唯一的自定义字段

如果键不存在，则添加新的自定义字段，否则使用该键更新自定义字段的值。

<?php

if ( ! add_post_meta( 7, ‘fruit’, ‘banana’, true ) ) {

update_post_meta ( 7, ‘fruit’, ‘banana’ );

}

（由Codex – 6年前贡献）

默认使用

<?php add_post_meta( 68, ‘my_key’, 47 ); ?>

（由Codex – 6年前贡献）

其他的例子

仅当指定键的自定义字段不存在时才添加新的自定义字段:

<?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函数示例页面。