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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function Reference/get post custom values 13:12, 9 November 2009 GeertDD)
 
(全体を和訳)
1行目: 1行目:
== Description ==
+
<div id="Description">
 +
== 説明 ==
 +
</div>
  
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 [[Function_Reference/get_post_meta|get_post_meta()]].
+
この関数は、1つのキーに複数の値が割り付けられているカスタムフィールドの値を取得するのに便利です。<tt>$post_id</tt> で指定した ID の投稿(未指定の場合は現在の投稿)から、<tt>$key</tt> で指定したキーを持つすべてのカスタムフィールドの値を配列で取得します。指定したキーを持つカスタムフィールドが存在しない場合は、<tt>null</tt> を返します。
  
Returns an array containing all the values of the custom fields with a particular key (<tt>$key</tt>) of a post with ID <tt>$post_id</tt> (defaults to the current post if unspecified).
+
[[関数リファレンス/get_post_custom|get_post_custom()]], [[関数リファレンス/get_post_custom_keys|get_post_custom_keys()]] や [[関数リファレンス/get_post_meta|get_post_meta()]] も見てください。
  
Returns nothing if no such key exists, or none is entered.
+
<div id="Usage">
 +
== 使い方 ==
 +
</div>
  
See also [[Function_Reference/get_post_custom|get_post_custom()]] and [[Function_Reference/get_post_custom_keys|get_post_custom_keys()]].
+
<?php get_post_custom_values($key, $post_id); ?>
  
== Usage ==
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
  
%%% <?php get_post_custom_values($key, $post_id); ?> %%%
+
{{Parameter|$key|文字列|カスタムフィールドのキー|必須}}
 +
{{Parameter|$post_id|整数|カスタムフィールドの値を取得したい投稿の ID |オプション|現在の投稿の ID}}
  
== Parameters ==
+
<div id="Examples">
 +
== 用例 ==
 +
</div>
  
{{Parameter|$key|string|The key whose values you want returned.|required}}
+
<div id="Default_Usage">
{{Parameter|$post_id|integer|The post ID whose custom fields will be retrieved.|optional|Current post}}
+
===デフォルトの使い方===
 +
</div>
  
== Examples ==
+
以下のサンプルでは、現在の投稿に <tt>my_key</tt> というキーを持つカスタムフィールドが3つあるとします。
  
=== Default Usage ===
 
 
Let's assume the current post has 3 values associated with the (custom) field <tt>my_key</tt>.
 
 
You could show them through:
 
 
<pre><?php
 
<pre><?php
 
 
   $mykey_values = get_post_custom_values('my_key');
 
   $mykey_values = get_post_custom_values('my_key');
 
   foreach ( $mykey_values as $key => $value ) {
 
   foreach ( $mykey_values as $key => $value ) {
 
     echo "$key  => $value ('my_key')<br />";  
 
     echo "$key  => $value ('my_key')<br />";  
 
   }
 
   }
 
 
?></pre>
 
?></pre>
 +
出力結果:
 +
<div style="border:1px solid blue; width:50%; padding:0 20px">
 +
0 => First value ('my_key')<br />
 +
1 => Second value ('my_key')<br >
 +
2 => Third value ('my_key')
 +
</div>
  
0 => First value ('my_key')
+
<div id="Related">
1 => Second value ('my_key')
+
== 関連資料 ==
2 => Third value ('my_key')
+
</div>
 
+
== Related ==
+
  
 
{{Post Meta Tags}}
 
{{Post Meta Tags}}

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

この関数は、1つのキーに複数の値が割り付けられているカスタムフィールドの値を取得するのに便利です。$post_id で指定した ID の投稿(未指定の場合は現在の投稿)から、$key で指定したキーを持つすべてのカスタムフィールドの値を配列で取得します。指定したキーを持つカスタムフィールドが存在しない場合は、null を返します。

get_post_custom(), get_post_custom_keys()get_post_meta() も見てください。

使い方

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

パラメータ

$key
文字列) (必須) カスタムフィールドのキー
初期値: なし
$post_id
整数) (オプション) カスタムフィールドの値を取得したい投稿の ID
初期値: 現在の投稿の ID

用例

デフォルトの使い方

以下のサンプルでは、現在の投稿に my_key というキーを持つカスタムフィールドが3つあるとします。

<?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')


カスタムフィールド: 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最新版との差分