説明
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最終更新 : 2018年05月27日 10:50
関連
お勧め
管理画面でツールバー（Admin bar）を非表示にする（2013年3月5日 更新）
WordPress使ってちょっと変わったサイトを構築する際、管理画面のツールバーを表示させたくないケースがある。一般に公開するサイト側であれば、 show_admin_bar関数で非表示にできるのだが、管理画面ではこれを使ってもツールバーは消えてくれない。サイドバーの初期化はwidgets_initアクションで（2011年7月14日 更新）
ウィジェットを使ってみたくなり新テーマ「Twenty Eleven」を覗いてみると、codexに記載されていた内容と少し違っている。これって「Twenty Ten」ですでに変更されていたんだね。タイトルが一致する投稿を検索する（2014年2月20日 更新）
WordPressが提供する投稿ページの文字列検索機能の実現には、 query_posts関数（WP_Queryクラス）が大きな役割を担っている。ここで紹介するのは、高機能ゆえに使いこなすのが難しいquery_posts関数（WP_Queryクラス）の使用法の一例である。
投稿ページでユニークなテンプレートを選択しよう（2018年5月27日 更新）
4.7の変更点に「投稿タイプテンプレート」がある。これは従来固定ページ（'page'）向けに任意のテンプレートを適用できる機能が拡張されたもので、投稿ページ（'post'）はもちろんカスタム投稿タイプのページにも適用可能になっている。
WordPressの鼓動（2013年10月1日 更新）
WordPressでは、Ajaxを利用する方法の1つとして add_action関数を利用することができる。この方法を調べている過程で、'heartbeat'というおもしろそうなAjaxアクションがあったので、紹介しておく。