常用函数-get_post_meta()

0条评论

常用函数-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值是什么,如果没有指定关键字,函数将返回空的字符。

相关资源

add_post_meta(), delete_post_meta(), update_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys()