函数描述

返回一个链接到附件文章或页面的 HTML 链接，可以是以下任何一个。

1. 指定尺寸的图片
2. 代表附件的图标
3. 附件标题
4. 自定义文本

如果附件不存在，此函数将返回字符串 Missing Attachment.

使用方法

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

默认使用方法

<?php echo wp_get_attachment_link( 13 ); ?>

如果需要在模板中动态获取附件ID，我们可以使用 get_children().

参数

$id

(
integer) (
可选) 附件 ID

默认: 在主循环中使用时（必须为显示附件的主循环），该参数为当前文章 ID。

$size

(
string/array) (
可选) 需要显示的图片附件的尺寸：可是一下尺寸名称 (thumbnail, medium, large, 或 full), 或一个两个元素的数组，两个元素分别为图片的宽度和高度的像素值，如：array(32,32)，在WordPress 2.5中，此参数对媒体图标无效，只能显示原始尺寸的媒体图标。

默认: ‘thumbnail’

$permalink

(
boolean) (可选) 直接链接到附件文件（默认），或链接到附件页面。

默认: ‘False’

$icon

(
boolean) (可选) 使用媒体图标表代替媒体。

默认: ‘False’

$text

(
string/boolean) (
可选) 显示链接到附件的文本链接。

默认: ‘false’

使用示例

显示中等尺寸的附件

在WordPress中，默认的图片尺寸有：”thumbnail”, “medium”, “large” and “full” （上传的原始图片），这些尺寸可以在WordPress管理面板的“设置 > 媒体”中修改。

<?php 
    $id = 9; // ID of an attachment 
    echo wp_get_attachment_link( $id, 'medium' ); 
?>

链接附件到文章

此示例将链接附件到一片文章。

<?php 
    $id = 9; // 附件 ID
    echo wp_get_attachment_link( $id, 'thumbnail', true ); 
?>

链接自定义文本到附件

此示例返回一个HTML链接， 链接”点击下载附件” 到附件。

<?php 
    $id = 9; // 附件 ID
    echo wp_get_attachment_link( $id, '' , false, false, '点击下载附件' ); 
?>

链接文章标题到附件

此示例将返回一个HTML链接，链接文章标题到附件。

<?php 
    $id = 9; // 附件 ID
    echo wp_get_attachment_link( $id, '' ); 
 ?>

修改图标目录

WordPress 在管理界面中，如果媒体图标可用，可以使用媒体图标代表附件，对图片附件来说，返回图片的缩略图，对其他类型的媒体来说，在wp-includes/images/crystal/ 中查找代表该媒体文件类型的媒体图标（如audio.jpg）。

此示例为我们演示了怎么使用我们主题目录中的媒体图标替换默认的媒体类型图标。在主题目录中创建文件夹: wp-content/themes/yourtheme/images. 然后把媒体中类型图标放在这个目录中，然后把下面一段代码放到主题的functions.php中，告诉WordPress媒体图标目录修改了。

add_filter( 'icon_dir', 'my_theme_icon_directory' );
add_filter( 'icon_dir_uri', 'my_theme_icon_uri' );

function my_theme_icon_directory( $icon_dir ) {
	return get_stylesheet_directory() . '/images';
}

function my_theme_icon_uri( $icon_dir ) {
	return get_stylesheet_directory_uri() . '/images'; 
}

注意

如果只需要图片（不是链接），使用 wp_get_attachment_image()。