- 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細)
関数リファレンス/get post custom keys
提供: WordPress Codex 日本語版
< 関数リファレンス
指定した記事や固定ページから、すべてのカスタムフィールドのキーを配列で取得します。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 />"; } ?>
投稿に mykey と yourkey のキーを持つカスタムフィールドがある場合、出力は以下のようになります:
0 => mykey
1 => yourkey
注: 1つのキーに複数の値が割り当てられている場合、つまり、同じキーを持つ複数のカスタムフィールドが存在する場合でも、そのキーは取得する配列に1回しか含まれません。
ソースファイル
get_post_custom_keys() は wp-includes/post.php
にあります。
関連資料
カスタムフィールド:
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 (最新版との差分)