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

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

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

提供: WordPress Codex 日本語版
移動先: 案内検索
(en:Function_Reference/get_post_custom_keys 20:48, 7 July 2009 Ramiy)
 
(全体を和訳)
1行目: 1行目:
== Description ==
+
<div id="Description">
 +
== 説明 ==
 +
</div>
  
Returns an array containing the keys of all custom fields of a particular post or page. See also [[Function_Reference/get_post_custom|get_post_custom()]] and [[Function_Reference/get_post_custom_values|get_post_custom_values()]]
+
指定した記事や固定ページから、すべてのカスタムフィールドのキーを配列で取得します。[[関数リファレンス/get_post_custom|get_post_custom()]] [[関数リファレンス/get_post_custom_values|get_post_custom_values()]] も見てください。
  
== Usage ==
+
<div id="Usage">
 +
== 使い方 ==
 +
</div>
  
%%% <?php get_post_custom_keys($post_id); ?> %%%
+
<?php get_post_custom_keys($post_id); ?> %%%
  
== Parameters ==
+
<div id="Parameters">
 +
== パラメータ ==
 +
</div>
  
{{Parameter|$post_id|integer|The post ID whose custom field keys will be retrieved.|optional|Current post}}
+
{{Parameter|$post_id|整数|カスタムフィールドのキー配列を取得したい投稿の ID|オプション|現在の投稿の ID}}
  
== Examples ==
+
<div id="Examples">
 +
== 用例 ==
 +
</div>
  
=== Default Usage ===
+
<div id="Default_Usage">
 +
===デフォルトの使い方===
 +
</div>
  
The following example will set a variable (<tt>$custom_field_keys</tt>) as an array containing the keys of all custom fields in the current post, and then print it.  Note: the '''if''' test excludes values for WordPress internally maintained custom keys such as ''_edit_last'' and ''_edit_lock''.
+
以下のサンプルは、現在の投稿からすべてのカスタムフィールドのキーの配列を <tt>$custom_field_keys</tt> に取得し、表示します。注:コード中の '''if''' WordPress が内部処理で使用している ''_edit_last'' ''_edit_lock'' などのようなキーを取り除いています。
  
 
<pre><?php
 
<pre><?php
28行目: 38行目:
 
?></pre>
 
?></pre>
 
   
 
   
If the post contains custom fields with the keys ''mykey'' and ''yourkey'', the output would be something like:
+
投稿に ''mykey'' ''yourkey'' のキーを持つカスタムフィールドがある場合、出力は以下のようになります:
<div style="border:1px solid blue; width:50%; margin: 20px; padding:20px">
+
<div style="border:1px solid blue; width:50%; padding:0 20px">
 
0 => mykey<br />
 
0 => mykey<br />
 
1 => yourkey<br />
 
1 => yourkey<br />
 
</div>
 
</div>
  
'''''Note:''' Regardless of how many values (custom fields) are assigned to one key, that key will only appear once in this array.''
+
''''':''' 1つのキーに複数の値が割り当てられている場合、つまり、同じキーを持つ複数のカスタムフィールドが存在する場合でも、そのキーは取得する配列に1回しか含まれません。''
  
== Related ==
+
<div id="Related">
 +
== 関連資料 ==
 +
</div>
  
 
{{Post Meta Tags}}
 
{{Post Meta Tags}}

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

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

使い方

<?php get_post_custom_keys($post_id); ?> %%%

パラメータ

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

用例

デフォルトの使い方

以下のサンプルは、現在の投稿からすべてのカスタムフィールドのキーの配列を $custom_field_keys に取得し、表示します。注:コード中の if は WordPress が内部処理で使用している _edit_last_edit_lock などのようなキーを取り除いています。

<?php

  $custom_field_keys = get_post_custom_keys();
  foreach ( $custom_field_keys as $key => $value ) {
    $valuet = trim($value);
      if ( '_' == $valuet{0} )
      continue;
    echo $key . " => " . $value . "<br />";
  }
?>

投稿に mykeyyourkey のキーを持つカスタムフィールドがある場合、出力は以下のようになります:

0 => mykey
1 => yourkey

注: 1つのキーに複数の値が割り当てられている場合、つまり、同じキーを持つ複数のカスタムフィールドが存在する場合でも、そのキーは取得する配列に1回しか含まれません。


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