説明
mixed wp_get_attachment_image_src( int $attachment_id [ , mixed $size = 'thumbnail' [ , bool $icon = false ] ] )
添付ファイルの表示用データを取得する。
パラメータ
- $attachment_id添付ファイルIDを指定
- $sizeサイズを文字列（'thumbnail'、'post-thumbnail'、'small'、'medium'、'large'など）または配列（幅と高さのピクセル値）で指定（省略時は'thumbnail'）。
- $iconアイコン画像を使用する場合はtrue、使用しない場合はfalseを指定（省略時はfalse）
返り値
添付ファイルの表示用データを配列で返す。配列は、イメージファイルのURL、幅、高さの順に格納されている。表示用データを取得できなかった場合はfalseを返す。注意
添付ファイルが画像ファイルの場合とそれ以外のデータファイルの場合では振る舞いが異なる。画像ファイルの場合は、アップロード時に指定した表示用イメージの情報を取得でき、4番目の要素には縮小イメージ（true）か元イメージ（false）かを示す。画像ファイル以外の場合は、/wp-includes/images/crystalにあるアイコン（アーカイブ、音楽、動画、文書、テキストなど）の情報を取得できる。使用例
- 画像ファイルの添付ファイルIDが100の表示用データを取得する。<?php $data = wp_get_attachment_image_src( 100 ); ?>
- 画像ファイル以外の添付ファイルIDが200の表示用アイコンのデータを取得する。<?php $data = wp_get_attachment_image_src( 100, 'none', true ); ?>
フィルター
[2.5.0]パラメータ$attachment_idでイメージ情報が取得できず$iconがtrueの場合にicon_dirフィルターを呼び出す。パラメータ$icon_dirは'/wp-includes/images/media'ディレクトリのフルパス名が格納されている。$icon_dir = apply_filters( 'icon_dir', $icon_dir );
[4.3.0]取得したイメージ情報を返す直前にwp_get_attachment_image_srcフィルターをを呼び出す。パラメータ$imageはイメージ情報が、その他のパラメータには本関数が受け取った内容が格納される。
return apply_filters( 'wp_get_attachment_image_src', $image, $attachment_id, $size, $icon );
アクション
実行するアクションはありません。ソースファイル
/wp-includes/media.php最終更新 : 2015年12月23日 09:02
関連
お勧め
query_posts（WP_Queryクラス）で投稿タグを絞り込む（2011年9月14日 更新）
投稿タグの絞り込みは、カテゴリーに似ているけど微妙に違っている。今日は、昨日投稿した「query_posts（WP_Queryクラス）でカテゴリーを絞り込む」の続きとして、投稿タグの絞り込みついてまとめてみる。管理者ページに文言を表示する（2012年4月19日 更新）
お客様向けに管理者ページをカスタマイズする機会が増えてきている。カスタマイズするページや表示場所、表示内容によっていくつかの手段があるが、今回はページの冒頭部分に任意の文言を表示する方法を紹介する。oEmbedについて考えてみた（2018年5月27日 更新）
本サイト向けにテーマをリニューアルしようと思い一から作っている最中、ふと生成されているHTMLの中にあるoEmbedの記述が目についた。「この記述いつからだっけ」くらいに思いながらリンク先を開き、ちょっとモヤモヤしてしまった。
ショートコードを含んだページを表示する前に何か処理する（2014年5月28日 更新）
固定ページまたは投稿ページに独自のフォームを埋め込む。入力→登録の2段階のフォームなら著名なプラグイン「Contact Form 7」を利用すればいいのだが、クライアントの依頼は入力→確認→登録の3段階で組み込む要素が特化していたので、独自の実装方法を考えることになった。
WP_Postオブジェクトで投稿情報を直感的に使う（2012年10月4日 更新）
WordPress 3.5で登場するであろう WP_Postクラス。WordPressの投稿情報は、投稿情報本体のほか、カテゴリーや投稿タグ、カスタムフィールドなど、いくつかに分散して記録され、それぞれの情報を取得する際は、いくつかの関数をしていた。新しいWP_Postクラスにより、その習慣とおさらばできるかもしれない。