Returns an HTML hyperlink to an attachment file or page, containing either

  1. An image at some specified size, for image attachments; or
  2. A media icon (as specified) representing the attachment; or
  3. The attachment's title (as text) or
  4. Your own text

If no such attachment exists, the function returns the string Missing Attachment.

wp_get_attachment_link() 描述


<?php wp_get_attachment_link$id$size$permalink$icon$text ); ?>

wp_get_attachment_link() 用法



(integer) (可选) ID of the desired attachment.

默认值: The current post ID, when used in The Loop (Must be a loop showing only attachments).


(string/array) (可选) Image size. Either a string keyword (thumbnail, medium, large or full) or a 2-item array representing width and height in pixels, e.g. array(32,32). As of Version 2.5, this parameter does not affect the size of media icons, which are always shown at their original size.

默认值: 'medium'


(boolean) (可选) Link directly to the attachment file/image (Default), or to the attachment page.

默认值: 'False'


(boolean) (可选) Use a media icon to represent the attachment.

默认值: 'False'


(string/boolean) (可选) Displays a text link to the attachment.

默认值: 'false'

wp_get_attachment_link() 参数


Show Medium Size Attachment.

The default image sizes of WordPress are "thumbnail", "medium", "large" and "full" (the image you uploaded). These image sizes can be configured in the WordPress Administration Media panel under Settings > Media.

Link Attachment to Post

This example will link the attachment to an attachment Page.

Link Text to Attachment

This example returns an HTML hyperlink with "My link text" linking to an attachment file.

Link Post Title to Attachment

This example returns an HTML hyperlink with the post title linking to an attachment file.

Change Icon Directory

WordPress can use media icons to represent attachment files on your blog and in the Admin interface, if those icons are available. For images it returns the thumbnail. For other media types It looks for image files named by media type (e.g. audio.jpg) in the directory: wp-includes/images/crystal/.

This example shows how you can change this directory to a folder called "images" in your theme: wp-content/themes/yourtheme/images. Create the folder and put the "media type images" in there. To tell WordPress the directory has changed put this in the current theme's functions.php file:

wp_get_attachment_link() 示例


Use wp_get_attachment_image() if you want the image only (not a hyperlink).

wp_get_attachment_link() 注意


添加于 版本: 2.5.0

wp_get_attachment_link() 历史


wp_get_attachment_link() 函数的代码位于 wp-includes/post-template.php.

wp_get_attachment_link() 源文件