wp_get_attachment_image()

基本構文と使い方（引数・実行結果）

指定した添付画像（管理画面からメディアに登録された画像）のimg要素を取得する。

wp_get_attachment_image($attachment_id,$size,$icon,$attr);

Copy

wp_get_attachment_image($attachment_id,$size,$icon,$attr);

引数	必須/任意	引数に指定するもの
第１引数 $attachment_id	必須	画像の`ID` （整数）
第２引数 $size	任意	画像サイズを下記から指定。 `thumbnail`（設定→メディアのサムネイルサイズ） `medium`（設定→メディアの中サイズ） `medium_large`（横幅768px） `large`（設定→メディアの大サイズ） `full`（オリジナルサイズ）初期値：`thumbnail`（テーマ次第）あるいは配列での指定も可能。例：`[500,300]`（横500px、縦300pxに収める）
第３引数 $icon	任意	第１引数で指定したIDが画像ではない場合のフォールバックとして、アイコンを取得するかどうか。表示する場合`true`、表示しない場合`false` 初期値：`false` trueにすると、例えばメディアにアップロードしたExcelファイルを読み込もうとするとWordPressに標準で登録されているExcelアイコンを取得します。
第４引数 $attr	任意	取得するimg要素に属性を追加する `文字列` / `配列`で指定初期値：`''`（空の文字列）例：`['class' => 'img-service', 'alt' => 'サービス概略図']`

戻り値（返す値）：指定した添付画像（管理画面からメディアに登録された画像）のimg要素
※表示するにはechoします。
img要素ではなく、画像情報（URLなど）のみを取得したい場合は、wp_get_attachment_image_src()を使います。

下記例ではID30のlargeサイズの画像にclass属性（値：img）とalt属性（値：サービス概略図）を追加して表示します。

echo wp_get_attachment_image(30, 'large', false, ['class' => 'img-service', 'alt' => 'サービス概略図']);

Copy

echo wp_get_attachment_image(30, 'large', false, ['class' => 'img-service', 'alt' => 'サービス概略図']);

【引数とは】
テンプレートタグ（=関数）を実行する際に、引数を渡すことができるテンプレートタグがあります。引数は、関数の中で使われるので、渡す引数の値によって実行結果が変わってきます。何を処理したいのか、どのようなデータを取得したいのかによって渡す引数が変わります。

【引数について】

指定できる引数の数はテンプレートタグによって異なります。（引数なしもあり）
引数ごとに必須 / 任意が決まっています。（必須は必ず指定、任意は指定しなければ初期値）
引数名(例：$post)は仕様の便宜上の名前と考えてください。（この名前自体はテンプレートタグ実行に関係しません。各引数に何を指定するのかを理解していればOKです。）

※当サイトでは初期値とデフォルト値の言葉の定義を区別せず、原則統一して初期値を採用しています。

テンプレートタグ	説明
wp_get_attachment_image_src()	指定した添付画像（管理画面からメディアに登録された画像）の情報を取得する。
get_template_directory_uri()	テーマディレクトリのURLを取得します。子テーマ利用時も常に親テーマのURLを取得します。
get_theme_file_uri()	テーマディレクトリのURLを取得します。子テーマ利用時は子テーマディレクトリのURLを取得します。
home_url()	トップページのURLを取得します。

Akiyuki Tanaka

2014年にフリーランス（Webデザイナー／コーダー）として独立。2016年にWeb制作会社ソーイ株式会社を設立し、現在までWeb制作・開発の現場に携わってきました。

初学者だった頃は、学習に苦労し随分と遠回りしました。かつての自分と同じような人に提供できるものがあるのではないかと考え、YouTubeでの講義配信を経て、より体系的で実践的な学習環境を提供する、独自の学習プラットフォーム unazuki を立ち上げました。

制作と教育、両方の現場に立ってきた経験を活かし、「とりあえずコードが書ける」ではなく、考えて作れるWeb制作者を増やすことを目指しています。