wordpress开发 – WordPress 常用函数 / get_post_meta


本站长承接“企业网站定制服务,有想做网站的客户可联系!站长QQ:739696033 | 微信:bing-0719

简介

这个函数获取指定日志的指定 key 的自定义字段,如果要获取指定日志的所有自定义字段,使用get_post_custom()

用法

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

参数

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

$key
(string) (required) 要获取自定义字段的名称(key)。
Default: None

$single
(boolean) (optional) 如果设置为 true,返回单个值。如果 false 或者没设置,则返回自定义字段的数组。
Default: false

返回值

(mixed)
这个函数返回值比较复杂:

  • 如果只设置了 $post_id 的值,返回该日志的所有自定义字段的关联数组。
  • 如果 $single 设置为 false 或者留空,返回指定 key 的所有值的一个数组。
  • 如果 $single 设置为 true,返回指定 key 的第一个值(并且不是在一个数组中)。
  • 如果没有东西可以返回的时候,返回空数组,除非 $single 设置为 true ,则返回空字符串。
  • 还有一种特殊情况就是,自定义字段的值是序列化的数组,这样 $single 设置为 true,则返回未序列化的数组,而 $single 设置为 false 或者留空,则你会获取一个数组,其中的一个值是序列化之后的字符串,你需要使用 maybe_unserialize 函数将其解析成数组。

实例

基本用法

获取所有 key 的 meta:

<?php $meta = get_post_meta( get_the_ID() ); ?>

获取单个 key 的 meta:

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

在主循环中获取指定 key 的第一个值

<?php 
$key_1_value = get_post_meta($post->ID, 'key_1', true);
// check if the custom field has a value
if($key_1_value != '') {
  echo $key_1_value;
} 
?>

获取缩略图地址为自定义字段的值

当你在 WordPress 主循环中,你可以使用下面的代码获取名字为“thumb”的自定义字段的值作为缩略图地址。

<?php if ( get_post_meta($post->ID, 'thumb', true) ) : ?>
    <a href="<?php the_permalink() ?>" rel="bookmark">
        <img class="thumb" src="<?php echo get_post_meta($post->ID, 'thumb', true) ?>" alt="<?php the_title(); ?>" />
    </a>
<?php endif; ?>

修改记录

Since 1.5.0

源文件

wp-includes/post.php

站长QQ:739696033 | 微信:bing-0719:Bcoder资源网 » wordpress开发 – WordPress 常用函数 / get_post_meta


本站VPN

扫描二维码关注微信公众号:“bcoder-cn 声明:本站内容部分来自互联网,仅供交流学习之用,请勿作商业用途,版权归原作者所有。如果有侵犯到您的权益,请提供相关证明联系本站删除,谢谢合作!
赞 (0)
分享到:更多 ()

评论 0

  • 昵称 (必填)
  • 邮箱 (必填)
  • 网址