wp_get_attachment_metadata

（2.1.0以降）
wp_get_attachment_metadata - 添付ファイルのメタ情報を取得する

説明

mixed wp_get_attachment_metadata( [ int $post_id = 0 [ , bool $unfiltered = false ] ] )
添付ファイルのメタ情報を取得する。

パラメータ

  • $post_id
    添付ファイルの投稿IDを指定（省略時は0）。
  • $unfiltered
    フィルター処理を行わない場合はtrue、行う場合はfalseを指定（省略時はfalse）。

返り値

添付ファイルのメタ情報（連想配列）を返す。パラメータ$post_idが無効な場合はfalseを返す。メタ情報（連想配列）の内容は次の通り。
キー名型値
widthstring幅（ピクセル）
heightstring高さ（ピクセル）
hwstring_smallstring幅と高さの属性値（例："height='96' width='115'"）
filestringファイルパス名（アップロードディレクトリからの相対パス）
sizesArray他サイズのイメージ情報の連想配列。キー名はthumbnailやmediumなどで、その値は連想配列（キー名はfile、width、height）となる（注：このfileの値はディレクトリを含まないファイル名のみ）。
image_metaArrayイメージのメタ情報の連想配列。3.3.1のキー名は、aperture、credit、camera、caption、created_timestamp、copyright、focal_length、iso、shutter_speed、titleである。

注意

添付ファイルのメタ情報は、'_wp_attachment_metadata'という名前のカスタムフィールドに格納されており、 get_post_meta関数で取得できる。

使用例

  • IDが10の添付ファイルのメタ情報を取得する。
    <?php $meta = wp_get_attachment_metadata( 10 ); ?>

フィルター

パラメータ$unfilteredがfalseの場合は、パス名を返す前にwp_get_attachment_metadataフィルターが呼び出される。フィルター関数に渡る$dataには生のメタ情報が、$attachment_idには添付ファイルの投稿IDを格納されている。
return apply_filters( 'wp_get_attachment_metadata', $data, $attachment_id )

アクション

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

ソースファイル

/wp-includes/post.php

最終更新 : 2019年11月19日 12:15

関連

参考

Code Reference: wp_get_attachment_metadata

お勧め

ダッシュボードの「クイックドラフト」を「CodeMirror」に変更してみた（2019年11月5日 更新）

管理ページの「テーマエディター」では4.9以降「CodeMirror」が利用されている。今回はこの「CodeMirror」をプラグインで活用できないか調べた話である。

headタグのmeta（generator）タグを取り除く（2018年5月27日 更新）

標準的なWordPressのテーマで出力されるHTMLには、headタグ内に次のようなmetaタグが出力されている。 
<meta name="generator" content="WordPress 3.0.5" />

Blacklist keys manager：プラグイン作ってみました（2015年5月22日 更新）

少し前から明らかにスパムと思われるコメントが投稿され、そのモデレーションメールを受け取る回数が増えてきた。あまりにもあからさまなコメントばかりなので、何らかの対策ができないか考えてみました。

5.5の機能強化：テーマ変更時に要求バージョンを確認（2020年8月12日 更新）

WordPress 5.5 RC 2が公開され、来週には正式版がリリース。変更箇所が多い「WordPress 5.5 RC 2（以降RC 2）」のソースコードを眺めていると、テーマの切り替え前にWordPressとPHPのバージョンを確認するようになっていた。

投稿内容に応じてwpautopを制御する（2013年8月13日 更新）

投稿内容を表示する the_content関数では、 wpautop関数がフィルターの1つとして呼び出され、改行をbrタグに変換したり、pタグで調整したりする。この機能自体は便利なのだが、きちんとデザインされたHTMLソースを流し込んだ場合はこの機能は好ましくない。そんなわけで、記事内容に応じてwpautop関数を制御できないか考えてみた。