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

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

関数リファレンス/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 />";
}
?>

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

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最新版との差分