get_post_custom_values

説明

array get_post_custom_values( [ string $key = '' [ , int $post_id = 0 ] ] )
カスタムフィールドの値を取得する。

パラメータ

  • $key
    カスタムフィールドの名前を指定(省略時は'')。
  • $post_id
    投稿情報のIDを指定(省略時は0)。

返り値

カスタムフィールドの値を配列で返す。ただし、投稿情報にカスタムフィールドが登録されていない場合はnullを返す。

注意

パラメータ$post_idを省略した場合は、現在の投稿情報のカスタムフィールドが対象となる。
get_post_meta関数で、パラメータ$singleにfalseを指定した場合に似ているが、$keyで指定したカスタムフィールドが登録されていない場合の返り値が異なる。

使用例

  • 現在の投稿情報のカスタムフィールド'drink'の値を取得する。
    <?php $val = get_post_custom_values( 'drink' ); ?>
  • 投稿IDが10のカスタムフィールド'drink'の値を取得する。
    <?php $val = get_post_custom_values( 'drink', 10 ); ?>

フィルター

直接実行するフィルターはありません。

アクション

直接実行するアクションはありません。

ソースファイル

/wp-includes/post.php

最終更新 : 2013年10月07日 15:19



お勧め

ログアウト後はいつもサイトトップ(2015年5月7日 更新)

ログアウト後に表示(リダイレクト)されるページは、標準ではログインページ(wp-login.php)である。4.2.0ではログアウト処理後のページリダイレクト前に呼び出されるフィルターが追加された。

公式ディレクトリに登録するならajax.googleapis.comのライブラリは利用しない(2015年3月21日 更新)

数日前、投稿一覧ページの絞り込みドロップダウンメニューを複数選択可能にするプラグイン「Posts filter multiselect」を公開したのですが、その際に指摘されたポイントを紹介します。

4.4では投稿ページも専用テンプレートが適用できる(2015年11月7日 更新)

従来、特定の固定ページには専用テンプレートを適用できるのですが、投稿ページに適用させるためにはアクションやフィルターを利用する必要がありました。4.4では特定の投稿ページに標準で専用テンプレートを適用できるようになりそうです。

xmlrpc.phpへのアクセスについてちょっと考えた(2015年7月11日 更新)

少し前のことですが、こちらのサーバーを何度かダウンさせてしまったのですが、その原因はxmlrpc.phpへアクセスが集中したことによってサーバーが過負荷となってしまったというものでした。すぐにサーバー性能を上げることはできないため、xmlrpc.phpのアクセスを全部拒否するという暫定対応してしまいました。

3.8の「アクティビティ」ウィジェットに投稿以外の情報も表示する(2014年1月17日 更新)

ちょうど1月前の「ダッシュボードの「概要」にカスタム投稿タイプ件数を表示する」にて、WordPress 3.8新ダッシュボードの「概要」ウィジェットにカスタム投稿タイプの投稿数を表示する方法を紹介したが、今回のその続編で「アクティビティ」ウィジェットを拡張する方法を紹介する。