【Wordpress相关】WordPress 常用函数 / add_post_meta

WordPress 常用函数 / add_post_meta,

简介

add_post_meta 添加一个一个自定义字段（Custom Field）到指定的日志，页面或者 post type 中。

如果 $unique 参数设置为 true，并且指定的 meta key 已存在，那么这个函数返回 false 并且不对现有的字段做任何修改，否则添加字段并返回 true。

<script async src="//pagead2.googlesyndication.com/pagead/js/adsbygoogle.js"></script> <script> (adsbygoogle = window.adsbygoogle || []).push({}); </script>

用法

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

参数

$post_id
(integer) (required) 将要添加自定义字段的日志 ID。
Default: None

$meta_key
(string) (required) 将要添加自定义字段的名称（key）。
Default: None

$meta_value
(mixed) (required) 将要添加自定义字段的值，如果是一个数组，将会被序列化成字符串。
Default: None

$unique
(boolean) (optional) 设置当前的 key 是否为唯一的，当设置为 true，将保证当前日志没有以 $meta_key 作为 key 的自定义字段，并且如果已经存在，则添加不成功。
Default: false

返回值

(bool)
添加成功返回 true，否则返回 false。

修改记录

Since 1.5.0

源文件

wp-includes/post.php