get_post_custom() - WordPress 函数参考中文文档

返回介绍

get_post_custom()

发布于 2017-09-10 字数3442 浏览 874 评论 0

get_post_custom( int $post_id )

Retrieve post meta fields, based on post ID.


描述

The post meta fields are retrieved from the cache where possible, so the function is optimized to be called more than once.


参数

$post_id

(int)
(Optional)
Post ID. Default is ID of the global $post.


返回值

(array) Post meta for the given post.


源代码

File: wp-includes/post.php

function get_post_custom( $post_id = 0 ) {
	$post_id = absint( $post_id );
	if ( ! $post_id )
		$post_id = get_the_ID();

	return get_post_meta( $post_id );
}

更新日志

Version 描述
1.2.0 Introduced.

相关函数

Uses

  • wp-includes/functions.php:
    absint()
  • wp-includes/post-template.php:
    get_the_ID()
  • wp-includes/post.php:
    get_post_meta()

Used By

  • wp-includes/feed.php:
    rss_enclosure()
  • wp-includes/feed.php:
    atom_enclosure()
  • wp-includes/post-template.php:
    post_custom()
  • wp-includes/post.php:
    get_enclosed()
  • wp-includes/post.php:
    get_post_custom_keys()
  • wp-includes/post.php:
    get_post_custom_values()
  • wp-includes/class-wp-xmlrpc-server.php:
    wp_xmlrpc_server::mw_getPost()
  • Show 2 more used by
    Hide more used by


User Contributed Notes

  1. Skip to note content

    You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note

    Contributed by Codex

    Default Usage
    Use the following example to set a variable ($custom_fields) as a multidimensional array containing all custom fields of the current post.

    <?php $custom_fields = get_post_custom(); ?>

    Retrieving data from the array
    The following example will retrieve all custom field values with the key my_custom_field from post ID 72 (assuming there are three custom fields with this key, and the values are “dogs”, “47” and “This is another value”).

    <?php
    
      $custom_fields = get_post_custom(72);
      $my_custom_field = $custom_fields['my_custom_field'];
      foreach ( $my_custom_field as $key => $value ) {
        echo $key . " => " . $value . "<br />";
      }
    
    ?>

    0 => dogs
    1 => 47
    2 => This is another value

    Note: not only does the function return a multi-dimensional array (ie: always be prepared to deal with an array of arrays, even if expecting array of single values), but it also returns serialized values of any arrays stored as meta values. If you expect that possibly an array may be stored as a metavalue, then be prepared to maybe_unserialize.

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

目前还没有任何评论,快来抢沙发吧!