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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(不自然な言い回しを是正)
(マージ残を入れて和訳。)
 
(他の1人の利用者による、間の2版が非表示)
9行目: 9行目:
 
</div>
 
</div>
  
  <?php $custom_fields = get_post_custom($post_id); ?>
+
  <?php get_post_custom( $post_id ); ?>
  
 
<div id="Parameters">
 
<div id="Parameters">
15行目: 15行目:
 
</div>
 
</div>
  
{{Parameter|$post_id|整数|カスタムフィールド情報を取得したい投稿の ID|オプション|現在の投稿の ID}}
+
{{Parameter|$post_id|整数|カスタムフィールド情報を取得したい投稿の ID。|オプション|現在の投稿}}
  
 
<div id="Examples">
 
<div id="Examples">
25行目: 25行目:
 
</div>
 
</div>
  
以下の例では <tt>$custom_fields</tt> に '''現在の''' 投稿のすべてのカスタムフィールド情報を配列で取得します。
+
以下の例は、変数 <tt>$custom_fields</tt> に '''現在の''' 投稿のすべてのカスタムフィールド情報を(多次元の)配列で取得します。
  
 
  <?php $custom_fields = get_post_custom(); ?>
 
  <?php $custom_fields = get_post_custom(); ?>
31行目: 31行目:
 
=== カスタムフィールドの配列からデータを取得する ===
 
=== カスタムフィールドの配列からデータを取得する ===
  
以下のサンプルは、ID ''72'' の投稿から ''my_custom_field'' というキーを持つカスタムフィールドの値を配列ですべて取得します。ここでは、このキーを持つカスタムフィールドは3つあり、値はそれぞれ "犬", "47", "その他の値" とします。
+
以下のサンプルは、ID ''72'' の投稿から ''my_custom_field'' というキーを持つすべてのカスタムフィールドの値を取得します。ここでは、このキーを持つカスタムフィールドは 3 つあり、値はそれぞれ「犬」、「47」、「その他の値」とします。
  
<?php  
+
<pre><?php
   $custom_fields = get_post_custom(72);                 // 指定した投稿のすべてのカスタムフィールド情報を取得
+
 
   $my_custom_field = $custom_fields['my_custom_field']; // 'my_custom_field' というキーを持つカスタムフィールドの値を取得
+
   $custom_fields = get_post_custom( 72 );
   foreach ( $my_custom_field as $key => $value )
+
   $my_custom_field = $custom_fields[ 'my_custom_field' ];
     echo $key . " => " . $value . "&lt;br /&gt;";  
+
   foreach ( $my_custom_field as $key => $value ) {
?>
+
     echo $key . " => " . $value . "<br />";
 +
  }
 +
 
 +
?>
 +
</pre>
  
 
出力結果:
 
出力結果:
<div style="border:1px solid blue; width:50%; padding:0 20px">
+
<div style="border:1px solid blue; width:50%; padding:0 20px"><tt>
 
0 => 犬<br/>
 
0 => 犬<br/>
 
1 => 47<br/>
 
1 => 47<br/>
 
2 => その他の値
 
2 => その他の値
 +
</tt></div>
 +
 +
== 参考 ==
 +
 +
この関数は多次元の配列を返します(つまり、単一の値が並んだ配列が期待される場合でも、配列の配列が用意されます)。それだけでなく、カスタムフィールドの値に配列が格納されていると、シリアル化された値を返します。配列をカスタムフィールドへ入れる可能性があるなら、<tt>[[関数リファレンス/maybe unserialize|maybe_unserialize()]]</tt> /[[:en:Function Reference/maybe unserialize|en]] の使用をお忘れなく。
 +
 +
<div id="Source_Code">
 +
== ソースコード ==
 
</div>
 
</div>
 +
 +
<tt>get_post_custom()</tt> は {{Trac|wp-includes/post.php}} にあります。
 +
 +
<div id="Changelog">
 +
== 更新履歴 ==
 +
</div>
 +
 +
* 新規導入: 1.5.0
  
 
<div id="Related">
 
<div id="Related">
54行目: 74行目:
  
 
{{Tag Footer}}
 
{{Tag Footer}}
{{原文|Function Reference/get post custom|75380}}
+
 
[[Category:Functions]]
+
{{原文|Function Reference/get post custom|138528}} <!-- 13:20, 28 November 2013 Barrykooij 版 -->
 +
 
 
[[en:Function Reference/get post custom]]
 
[[en:Function Reference/get post custom]]
 +
[[ru:Справочник_по_функциям/get post custom]]

2015年8月25日 (火) 21:49時点における最新版

指定した記事や固定ページから、すべてのカスタムフィールドの情報を配列で取得します。get_post_custom_keys()get_post_custom_values() も参照してください。

使い方

<?php get_post_custom( $post_id ); ?>

パラメータ

$post_id
整数) (オプション) カスタムフィールド情報を取得したい投稿の ID。
初期値: 現在の投稿

用例

デフォルトの使い方

以下の例は、変数 $custom_fields現在の 投稿のすべてのカスタムフィールド情報を(多次元の)配列で取得します。

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

カスタムフィールドの配列からデータを取得する

以下のサンプルは、ID 72 の投稿から my_custom_field というキーを持つすべてのカスタムフィールドの値を取得します。ここでは、このキーを持つカスタムフィールドは 3 つあり、値はそれぞれ「犬」、「47」、「その他の値」とします。

<?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 => 犬
1 => 47
2 => その他の値

参考

この関数は多次元の配列を返します(つまり、単一の値が並んだ配列が期待される場合でも、配列の配列が用意されます)。それだけでなく、カスタムフィールドの値に配列が格納されていると、シリアル化された値を返します。配列をカスタムフィールドへ入れる可能性があるなら、maybe_unserialize() /en の使用をお忘れなく。

ソースコード

get_post_custom()wp-includes/post.php にあります。

更新履歴

  • 新規導入: 1.5.0


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