wp_get_attachment_link 获取多媒体链接

文 / @WordPress主题

我是小本本,今天给大家介绍一下wp_get_attachment_link函数。

函数描述

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

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

如果附件不存在,此函数将返回字符串 MissingAttachment.

使用方法

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

默认使用方法

<?php echo wp_get_attachment_link(13); ?>

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

函数参数

参数 数据类型 是否必需 描述 默认值
$id 整数 在主循环中使用时(必须为显示附件的主循环),该参数为当前附件ID 0
$size 字符串|数组 图片尺寸名称或数组 thumbnail
$permalink 布尔值 链接到附件文件或附件页面 false
$icon 布尔值 是否显示为图标 flase
$attr 字符串|数组 附加参数 空字符串

使用示例

显示中等尺寸的附件

在WordPress中,默认的图片尺寸有:"thumbnail","medium","large"和"full"(上传的原始图片),这些尺寸可以在WordPress管理面板的“设置>媒体”中修改。

$id = 9;//附件ID
echo wp_get_attachment_link($id, 'medium');

链接附件到文章

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

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

链接自定义文本到附件

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

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

链接文章标题到附件

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

$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()。

添加UTHEME为好友
扫码添加UTHEME微信为好友
· 分享WordPress相关技术文章,主题上新与优惠动态早知道。
· 微信端最大WordPress社群,限时免费入群。