wp_get_attachment_image()

wp_get_attachment_image() は、指定した添付ファイルのIDに基づいて、HTMLの<img>タグを生成して画像を出力するためのテンプレートタグです。

機能の説明

wp_get_attachment_image() は、画像添付ファイルを取得し、<img>タグとして出力する関数です。

サイズを指定することで、サムネイルやフルサイズの画像を表示することができます。また、class属性やaltテキストなどを含めた柔軟なHTML出力が可能です。

シンプルなコード例

echo wp_get_attachment_image(123, 'thumbnail');

添付ファイルIDが123の画像をサムネイルサイズで表示します。

使い方の解説

引数

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

• $attachment_id: 表示したい画像の添付ファイルID
• $size: 画像サイズ（例: 'thumbnail', 'medium', 'full'など）
• $icon: アイコン表示（trueまたはfalse）
• $attr: HTML属性（連想配列でclassやaltを指定可能）

戻り値

HTMLの<img>タグを返します。

使用例

$attachment_id = 123;
echo wp_get_attachment_image($attachment_id, 'medium', false, array('class' => 'my-custom-class', 'alt' => 'カスタム画像'));

IDが123の画像をmediumサイズで表示し、カスタムクラスmy-custom-classと、alt属性に「カスタム画像」を追加します。

一緒に使うことが多い関連タグ

wp_attachment_is_image()

wp_attachment_is_image() は、指定したIDの添付ファイルが画像であるかどうかを判定するためのテンプレートタグです。

$attachment_id = 123;
if (wp_attachment_is_image($attachment_id)) {
    echo wp_get_attachment_image($attachment_id, 'large');
} else {
    echo '<p>このファイルは画像ではありません。</p>';
}

画像であればその画像をlargeサイズで表示し、画像でない場合はメッセージを表示します。

get_post_mime_type()

get_post_mime_type() は、指定した投稿や添付ファイルのMIMEタイプを取得する関数です。

$attachment_id = 123;
echo 'このファイルのMIMEタイプは: ' . get_post_mime_type($attachment_id);

添付ファイルIDが123のファイルのMIMEタイプ（例: 'image/jpeg'）を表示します。

複数の関連タグを組み合わせたコード

$attachment_id = 123;

if (wp_attachment_is_image($attachment_id)) {
    echo wp_get_attachment_image($attachment_id, 'full');
    echo '<p>この画像のMIMEタイプは: ' . get_post_mime_type($attachment_id) . '</p>';
}

画像ファイルであればfullサイズで表示し、そのMIMEタイプも一緒に表示します。

追加情報を取得したい場合

wp_get_attachment_metadata() で画像の詳細情報を取得

$metadata = wp_get_attachment_metadata(123);
print_r($metadata);

IDが123の画像メタデータ（幅や高さ、生成されたサムネイル情報など）を配列で取得し、表示します。

出力できる情報

• width：画像の幅
• height：画像の高さ
• file：画像ファイルのパス
• sizes：各サイズのサムネイル情報

想定されるトラブル

添付ファイルIDが間違っている

添付ファイルIDが正しく取得できていない可能性があります。

解決方法

• 管理画面でファイルIDを確認してください。
• get_the_ID() で現在のIDを正しく取得しているか確認します。

希望のサイズが表示されない

指定した画像サイズが登録されていない可能性があります。

解決方法

• add_image_size() で必要なサイズを追加します。
• Regenerate Thumbnailsプラグインでサムネイルを再生成します。

Q&A

$attachment_id = 123;
echo '<a href="' . get_attachment_link($attachment_id) . '">';
echo wp_get_attachment_image($attachment_id, 'thumbnail');
echo '</a>';

まとめ

wp_get_attachment_image() は、指定した添付ファイルIDを基に画像をHTMLタグで出力する便利なテンプレートタグです。

class属性やaltテキストを含めたカスタマイズが可能で、wp_attachment_is_image() や get_post_mime_type() などの関連タグと組み合わせて使うことで、柔軟な画像管理が実現できます。

サムネイルサイズのカスタマイズや、特定の条件に応じた画像表示に最適な関数です。