wp_get_attachment_link:WordPress私的マニュアル

wp_get_attachment_link

(2.5.0以降)
wp_get_attachment_link - 添付ファイルへのリンクを示すHTMLテキストを取得する

説明

string wp_get_attachment_link( [ int $id = 0 [ , mixed $size = 'thumbnail' [ , bool $permalink = false [ , bool $icon = false [ , mixed $text = false ] ] ] ] ] )

添付ファイルへのリンクを示すHTMLテキストを取得する。

パラメータ

$id
投稿情報IDを指定（省略時は0）
$size
サイズとして'thumbnail'、'none'、数値の何れかを指定（省略時は'thumbnail'）
$permalink
パーマリンクを使用する場合はtrue、使用しない場合はfalseを指定（省略時はfalse）
$icon
アイコン画像を使用する場合はtrue、使用しない場合はfalseを指定（省略時はfalse）
$text
見出し文字を指定（省略時はfalse）

返り値

添付ファイルへのリンクを含むHTMLテキストを返す。パラメータ$idで指定された投稿情報が添付ファイルでない（post_typeが'attachment'以外）か、URLが取得できなかった場合は、'Missing Attachment'の翻訳テキストを返す。

注意

パラメータ$textが指定された場合、$sizeや$iconの指定に関わらず、$textで指定した文字が有効になる（''が指定された場合は、投稿情報のタイトルが適用される）。

使用例

添付ファイルの投稿情報IDが10のリンクを示すHTMLテキストを取得する。
<?php $link = wp_get_attachment_link( 10 ); ?>

参考

Code Reference: wp_get_attachment_link

お勧めコンテンツ

ショートコードを使ってテーマ内の画像URLを簡単に指定する（2011年5月2日登録）

投稿記事の中で画像パーツを使いたいときがある。画像パーツの配置場所は、/imgディレクトリのようなテーマ外の場合と、/wp-content/themes/mytheme/imagesディレクトリのようなテーマ内の場合があり、今回は後者のケース。ショートコードを使って投稿記事の画像ファイルのURLを記述する方法を紹介したい。

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

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

スマートフォン向けの振り分けを自前で行う（2011年11月2日登録）

PC向けのサイトをスマートフォン対応する場合、WPtouchやktai styleに代表されるスマートフォン対応のテンプレート切り替えプラグインを使用するのが一般的。そういったプラグインはテンプレート切り替え以外の機能も備えており、そういった機能は必ずしも必要ではない。そんなわけで、ここでは超シンプルなスマートフォン向けのテンプレート切り替えを実現する方法を紹介する。

公式サイトで公開しているプラグイン「Login rebuilder」をバージョンアップし、XML-RPCリクエストの管理機能を追加しました。Login rebuilderの主たる機能は、ログインページをサイト別にユニークなURLに変更し、ログインページへの不正アクセスを回避することです。WordPressのXML-RPCリクエストはピンバックや外部ツールやサイトなどとの連携に利用されていますが、今回追加した機能ではXML-RPCリクエストの処理に対していくつかの制限できるようにしています。

WordPressと組み込まれている主なJavaScriptライブラリのバージョン一覧（2015年4月10日登録）

WordPressの更新が遅れていたサイトを少し前に更新したところ、jQuery UI sortableを使って拡張したページに不具合が発生しました。WordPressの更新に伴って内部のjQuery UIが更新されたことに起因すると思われ、これを機にWordPressとそれに組み込まれたJavaScriptライブラリのバージョンを確認してみました。