wp_get_attachment_image:WordPress私的マニュアル

wp_get_attachment_image

(2.5.0以降)
wp_get_attachment_image - アタッチメント情報のHTMLテキストを取得する

説明

string wp_get_attachment_image( int $attachment_id [ , mixed $size = 'thumbnail' [ , bool $icon = false [ , mixed attr = '' ] ] ] )

アタッチメント情報のHTMLテキストを取得する。

パラメータ

$attachment_id
アタッチメント情報のIDを指定。
$size
サイズを文字列（'thumbnail'、'post-thumbnail'、'small'、'medium'、'large'など）または配列（幅と高さのピクセル値）で指定（省略時は'thumbnail'）。
$icon
アイコン画像を使用する場合はtrue、使用しない場合はfalseを指定（省略時はfalse）。
$attr
添付画像の属性を文字列または連想配列で指定（省略時は''）。

返り値

アタッチメント情報が存在する場合は、そのHTMLテキストを返す。アタッチメント情報が設定されていない場合は''を返す。

注意

パラメータ$iconでtrueを指定した場合、アタッチメント情報のタイプに応じたアイコン画像（/wp-includes/images/crystal/*.png）が適用される。

使用例

IDが25のアタッチメント情報のHTMLテキストを取得する。
<?php $html = wp_get_attachment_image( 25 ); ?>
IDが25のアタッチメント情報のHTMLテキストを幅120ピクセルと高さ80ピクセルを指定して取得する。
<?php $html = wp_get_attachment_image( 25, array( 120, 80 ) ); ?>
IDが25のアタッチメント情報のHTMLテキストをclass属性を追加して取得する。
<?php $html = wp_get_attachment_image( 25, 'post-thumbnail', false, array( 'class'=>'alignleft' ) ); ?>

フィルター

パラメータ$attrを適用する前にwp_get_attachment_image_attributesフィルターが実行される。$attrにはデフォルトの属性値が加わった連想配列が、$attachmentには添付画像の投稿情報が格納さてる。

$attr = apply_filters( 'wp_get_attachment_image_attributes', $attr, $attachment );

アクション

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

ソースファイル

/wp-includes/media.php

参考

Code Reference: wp_get_attachment_image

参考

お勧めコンテンツ

Blacklist keys manager：プラグイン作ってみました（2013年9月13日登録）

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

the_date関数で投稿日を確実に表示する（2011年12月20日登録）

投稿記事の投稿日時を表示する際、the_date関数を使用することが多いだろう。このthe_date関数はphpのdate関数と同じパラメータを指定することで、好みの日時フォーマットで投稿日時を表示できるのだが、ある条件の場合に投稿日時を表示しない。最初にこの現象に遭遇したときは、ちょっと悩まされた。

絵文字画像がPNGからSVGへ（2016年8月15日登録）

WordPressでは絵文字に対応していないブラウザ環境で絵文字を表示する仕組みをバージョン4.2から提供。絵文字に対応しているブラウザとそん色がない表示を実現する。

xmlrpc.phpへのアクセスについてちょっと考えた（2015年7月10日登録）

少し前のことですが、こちらのサーバーを何度かダウンさせてしまったのですが、その原因はxmlrpc.phpへアクセスが集中したことによってサーバーが過負荷となってしまったというものでした。すぐにサーバー性能を上げることはできないため、xmlrpc.phpのアクセスを全部拒否するという暫定対応してしまいました。

headタグのmeta（generator）タグを取り除く（2011年2月18日登録）

標準的なWordPressのテーマで出力されるHTMLには、headタグ内に次のようなmetaタグが出力されている。

<meta name="generator" content="WordPress 3.0.5" />