• 赤色のリンクは、まだ日本語Codexに存在しないページ・画像です。英語版と併せてご覧ください。(詳細

このWikiはいつでも誰でも編集できます

テンプレートタグ/get attachment link

提供: WordPress Codex 日本語版
移動先: 案内検索

個別添付ファイルページの URI を返します。

使い方

<?php get_attachment_link( $id ); ?>

パラメータ

$id
整数) (オプション添付ファイル(メディア)の ID。
初期値: ループ内で使われる場合は現在の投稿の ID。

用例

デフォルトの使い方

この関数はパーマリンクを表示しないので、この例では PHPの echo コマンドを使用します。

<?php 
$attachment_id = 1; // 添付のID
$attachment_page = get_attachment_link( $attachment_id ); 
?>
<a href="<?php echo $attachment_page; ?>"><?php echo get_the_title( $attachment_id ); ?></a>

添付イメージとタイトルをリストとして表示

特定のページに添付された画像を箇条書きで表示するには以下の例を用います。

<ul>
<?php if ( have_posts() ) : while ( have_posts() ) : the_post();    

  $args = array(
    'post_type' => 'attachment',
    'numberposts' => -1,
    'post_status' => null,
    'post_parent' => $post->ID
  );

  $attachments = get_posts( $args );
    if ( $attachments ) {
      foreach ( $attachments as $attachment ) {
        echo '<li>';
        the_attachment_link( $attachment->ID, true );
        echo '<p>';
        echo apply_filters( 'the_title', $attachment->post_title );
        echo '</p></li>';
      }
    }

  endwhile; endif; ?>
</ul>

戻り値

"pretty" なパーマリンク構造の場合、この関数は以下の様な形式を返します。

  • http://wp.example.net/path_to_post/post_name/attachment_name

デフォルトの "Ugly" なパーマリンク構造、もしくは WordPress が "pretty" な URI を作れなかった場合、この関数は以下の様な形式を返します。この時、n は添付ファイルの ID を表します。

  • http://wp.example.net/?attachment_id=n

注釈

この関数の出力は 'attachment_link' フィルターを通して変更することができます。

添付ファイルへの直リンクが(個別添付ファイルページの代わりに)必要な場合、wp_get_attachment_url( id ) をを用いてください。

: wp_get_attachment_link() が HTML のハイパーリンクを返すのに対して、get_attachment_link は URI を返します。

変更履歴

  • 2.0 : 新規導入。

ソースファイル

get_attachment_link()wp-includes/link-template.php にあります。

添付ファイル関数: get_children(), get attached media(), the_attachment_link(), get_attachment_link(), wp_get_attachment_link(), wp_get_attachment_image(), wp_get_attachment_image_src(), wp_get_attachment_url(), wp_get_attachment_thumb_file(), wp_get_attachment_thumb_url(), is_attachment(), wp_get_attachment_metadata()


最新英語版: WordPress Codex » Function Reference/get attachment link最新版との差分