説明
array wp_list_pluck( array $list, mixed $field [ , mixed $index_key = null ] )
配列内のオブジェクトまたは連想配列から特定の値だけを抽出する。
パラメータ
- $list配列を指定。
- $fieldオブジェクトのプロパティ名または連想配列のキーを指定。
- $index_key格納先に指定するオブジェクトのプロパティ名または連想配列のキーを指定([4.0.0]で追加)。
返り値
指定されたプロパティ(または要素)だけの配列を返す。注意
配列の中身がオブジェクトと配列のどちらでも利用できる。
パラメータ$index_keyは、4.0.0で追加されたもので、返り値となる配列のキーをすることができる。ただし、$index_keyがオブジェクトのプロパティ名または連想配列のキーでない場合は、返り値となる配列のキーは0から始まる数値となる。
使用例
- 投稿情報の配列から投稿タイトルを抽出する。<?php $titles = wp_list_pluck( $posts, 'post_title' ); ?>
- 投稿情報の配列から投稿タイトルを抽出し、投稿IDがキーの配列に格納する。<?php $titles = wp_list_pluck( $posts, 'post_title', 'ID' ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/functions.php最終更新 : 2014年09月07日 17:41
関連
お勧め
プラグインのロード順を制御する(2014年6月9日 更新)
これまでプラグインがどのような順番でロードされるか意識していなかったのだが、とある自作プラグインを他のプラグインよりも先にロードさせたくなったので調べてみた。
Emojin:プラグイン作ってみました(2015年3月21日 更新)
ちょっと前のTLでiOSの絵文字を含んだ投稿を保存すると、絵文字以降の文章がすべて消えた状態で保存されるといったツイートを見かけた。少し検索してみると、MySQLのデータベースの文字セットが「utf8」の場合、iOSの絵文字のような4バイトの文字を正常に保存できず、それ以降の文章も保存されないというものらしい。対処方法としてデータベースの文字セットを「utf8mb4」に変更するのが有効らしいのだが、他に回避策がないか考えてみた。Contact Form 7に確認フェーズを(2012年12月16日 更新)
Contact Form 7はWordPressによるサイト製作でお世話になることが多いプラグインの1つ。ただ、クライアント様によっては、入力、確認、送信の3フェーズにしたいという要望があり、そんな時は別の方法を採用していたのですが、JavaScript(jQuery)を使ってページ遷移しなくてもいいなら確認フェーズは用意できるかなと思い、作り込んでみた。プラグインのヘッダー情報を国際化対応しよう(2018年5月27日 更新)
バージョン4.8がリリースされてひと段落。あらためてプラグイン一覧ページを見てみると「Akismet」が「Akismet Anti-Spam (アンチスパム)」と表示されていた。説明文だけじゃなくプラグイン名も国際化対応できたのね。
メタボックスをクラシックエディターのみで表示する(2019年1月15日 更新)
投稿画面向けにメタボックスを使ったプラグインがあり、それがブロックエディターで意図した通りに機能しなかった。この対処方法を考える過程でエディタータイプに応じてメタボックスを出し分けできる方法が見つかったので紹介したい。