• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

「関数リファレンス/get post custom values」の版間の差分

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/get post custom values 13:12, 9 November 2009 GeertDD)
(相違点なし)

2010年4月20日 (火) 22:52時点における版

Description

This function is useful if you wish to access a custom field that is not unique, i.e. has more than 1 value associated with it. Otherwise, you might wish to look at get_post_meta().

Returns an array containing all the values of the custom fields with a particular key ($key) of a post with ID $post_id (defaults to the current post if unspecified).

Returns nothing if no such key exists, or none is entered.

See also get_post_custom() and get_post_custom_keys().

Usage

%%% <?php get_post_custom_values($key, $post_id); ?> %%%

Parameters

$key
string) (required) The key whose values you want returned.
初期値: なし
$post_id
integer) (optional) The post ID whose custom fields will be retrieved.
初期値: Current post

Examples

Default Usage

Let's assume the current post has 3 values associated with the (custom) field my_key.

You could show them through:

<?php

  $mykey_values = get_post_custom_values('my_key');
  foreach ( $mykey_values as $key => $value ) {
    echo "$key  => $value ('my_key')<br />"; 
  }

?>
0 => First value ('my_key')
1 => Second value ('my_key')
2 => Third value ('my_key')

Related

カスタムフィールド: the_meta(), get_post_meta(), add_post_meta(), update_post_meta(), delete_post_meta(), get_post_custom(), get_post_custom_values(), get_post_custom_keys() (post_meta 関数の例 /en も参照)


関数リファレンステンプレートタグ目次もご覧ください。

最新英語版: WordPress Codex » Function Reference/get post custom values最新版との差分