> WordPress开发手册 > get_post_meta

get_post_meta


WordPress 中的自定义字段是很多主题会用到的,get_post_meta 函数是用来取出自定义字段的值所设立的一个函数,该函数普遍用于主题的一些个性表现中,本文主要会讲解一下该函数的使用及一些实例。

该函数的用处很多,很多主题用来设置文章相应图片的设置,这与将远程图像设置为缩略图有异曲同工之妙,当然自定义字段还可以用于存储许多我们觉得更有用的东西,例如统计信息,等等等等。

如何添加自定义字段

我们在添加文章时,会有一个添加自定义栏目的地方,因为两处翻译有所不同,所以这里总是会让一些新手有所疑惑。
添加自定义字段截图如下:
get_post_meta

get_post_meta()函数意义详解

This function returns the values of the custom fields with the specified key from the specified post.

中文的大概意思是,该函数用于取出用户设置的自定义字段。
像许多以get开头的诸如:get_post_classget_posts一样,只是将结果返回,而不直接显示与页面,在使用的时候要留意下。

用法

$meta_values = get_post_meta($post_id, $key, $single);

参数解释

$post_id文章的ID(如果在循环中,你可以用 get_the_ID()来设置),
$key自定义字段的名称(键值),
$single是否以字符串形式返回,false会返回数组形式。

实例

以下代码可用于index.php进行测试

 if (have_posts()) ://如果有文章
 while (have_posts()) : the_post(); //开启主循环
   $xzmeta  = get_post_meta(get_the_ID(),'xzmeta',true);
 endwhile; 
 endif;
  • 如果没有设置”xzmeta”这个自定义字段的话,$xzmeta 会是false
  • 如果有设置,则返回设置的值。
  • 如果第三个参数设置为false,则返回数组,且相同键值的自定义字段的值会按照添加顺序组合成一个序列数组。
  • 如果只设置$postid参数,那将返回所有的自定义字段值。用法类似于使用get_post_custom()函数

函数声明

/**
 * Retrieve post meta field for a post.
 *
 * @since 1.5.0
 * @uses $wpdb
 * @link http://codex.wordpress.org/Function_Reference/get_post_meta
 *
 * @param int $post_id Post ID.
 * @param string $key Optional. The meta key to retrieve. By default, returns data for all keys.
 * @param bool $single Whether to return a single value.
 * @return mixed Will be an array if $single is false. Will be value of meta data field if $single
 *  is true.
 */
function get_post_meta($post_id, $key = '', $single = false) {
	return get_metadata('post', $post_id, $key, $single);
}

总结

后面有可能会讲一下三个配套使用的函数,虽然这三个函数用处不会很多。

  1. add_post_meta(),
  2. update_post_meta(),
  3. delete_post_meta(),

还有自定义字段的扩展用法相关的函数。

  1. get_post_custom(),
  2. get_post_custom_values(),
  3. get_post_custom_keys()。

上一篇:
下一篇: