WordPress 常用函数 / get_post_meta

说明

该函数返回指定文章中含有指定关键字自定义字段的值。参见 update_post_meta(), delete_post_meta() 和 add_post_meta() 。

用法

<?php $meta_values = get_post_meta($post_id, $key, $single); ?>

示例

缺省用法

<?php $key_1_values = get_post_meta(76, 'key_1'); ?>

其他示例

仅检索给定关键字的第一个值：

<?php $key_1_value = get_post_meta(76, 'key_1', true); ?>

更详细的示例参见 post_meta 函数示例页面。

参数

$post_id

（整数）（必需）希望从中得到数据的文章的编号。用$post->ID获取文章编号。

默认值：None

$key

（字符）（必需）字符，字符中含有希望的meta值的名称。

默认值：None

$single

（布尔值）（可选）如果默认值设为true，函数返回单个字符形式的结果。如果为false或为设置，则函数返回自定义字段的数组。

默认值：false

返回的值

• 若$single设为false或空，函数返回一个包含指定关键字的所有值的数组
• 若$single设为true，函数返回指定关键字的第一个值（不是数组）

无论$single值是什么，如果没有指定关键字，函数将返回空的字符。