説明
array wp_media_personal_data_exporter( string $email_address [ , int $page = 1 ] )
メールアドレスに関連付けられたメディア（添付ファイル）情報を取得する。
パラメータ
- $email_addressメディア投稿者のメールアドレスを指定。
- $pageページ番号を指定（省略時は1）。
返り値
メディア情報を含んだ連想配列を返す。
メディア情報を含んだ多階層の連想配列を返す。
| キー | 内容 |
|---|---|
| 'done' | 指定されたページ番号が最終ページ以降の場合はtrue |
| 'data' | エクスポートデータ（連想配列）の配列 |
各エクスポートデータの内容は次の通り。
| キー | 内容 |
|---|---|
| 'group_id' | 'media' |
| 'group_label' | 'Media'の翻訳テキスト |
| 'item_id' | 'post-投稿ID' |
| 'data' | グループ固有データの配列 |
メディアのグループ固有データの内容は次の通り。
| キー | 内容 |
|---|---|
| 'name' | 'URL'の翻訳テキスト |
| 'value' | 添付ファイルのURL |
注意
メディア情報は投稿順（投稿IDの昇順）で最大50件分を取得する。
使用例
- メールアドレスに関連付けられたメディア情報を取得する。<?php $media = wp_media_personal_data_exporter( $email ); ?>
- メールアドレスに関連付けられたメディア情報の51件目以降を取得する。<?php $media = wp_media_personal_data_exporter( $email, 2 ); ?>
フィルター
実行するフィルターはありません。アクション
実行するアクションはありません。ソースファイル
/wp-includes/media.php最終更新 : 2018年05月27日 10:42
関連
お勧め
新「WordPress Events and News」ウィジェットが興味深い（2018年5月27日 更新）
4.8のベータ版ですぐに新機能とわかるのが管理者ダッシュボードの新「WordPress Events and News」ウィジェット。ユーザーが指定した地域近隣で開催されるイベント情報を表示してくれるウィジェットで、この中のフォームがちょっと興味深かった。なおこの記事はWordPress 4.8 beta-2をもとにしており、以降のバージョンで変更される可能性があることをあらかじめ断っておく。
meta_compare_key使ってみた（2019年3月19日 更新）
ブロックエディターの登場により、標準のカスタムフィールドを使う機会はかなり減った気がする。そんな中、5.1.0で追加されたのが、カスタムフィールド名（メタキー）に含まれる文字列を指定する'meta_compare_key'キーだ。
投稿一覧ページに「更新日時」カラムを追加してみた（2019年8月27日 更新）
サイトの特性によるが、「投稿」には繰り返し更新するものがある。そんなサイトでは投稿一覧ページに「更新日時」があった方が便利。というわけで、今回は投稿一覧にソートに対応した「更新日時」カラムを追加する方法を紹介する。
投稿一覧に「投稿フォーマット」フィルターが追加される（2019年4月12日 更新）
WordPress 5.2 Beta2（以降5.2Beta2）のソースコードを眺めていると、投稿一覧ページのフィルター機能に「投稿フォーマット」（select要素）が追加されていた。
get_postsとquery_postsを使い分け（2018年5月27日 更新）
get_postsと query_postsは、どちらも複数の投稿情報を取得することができる便利な関数である。パラメータとして指定できる内容も共通しているものが多く、query_postsがより詳細なパラメータを指定でき、高機能になっている。