函数描述
返回一个链接到附件文章或页面的 HTML 链接,可以是以下任何一个。
- 指定尺寸的图片
- 代表附件的图标
- 附件标题
- 自定义文本
如果附件不存在,此函数将返回字符串 Missing Attachment.
使用方法
<?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” and “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()。
© 版权声明
1. 资源都是经过站长或作者收集测试后修改发布分享。转载请在文内以超链形式注明出处,谢谢合作!
2. 本站除原创内容,其余所有内容均收集自互联网,仅限用于学习和研究目的,本站不对其内容的合法性承担任何责任。如有版权内容,请通知我们或作者删除,其版权均归原作者所有,本站虽力求保存原有版权信息,但因众多资源经多次转载,已无法确定其真实来源,或已将原有信息丢失,所以敬请原作者谅解!
3. 本站用户所发布的一切资源内容不代表本站立场,并不代表本站赞同其观点和对其真实性负责,若您对本站所载资源作品版权归属存有异议,请留言附说明联系邮箱,我们将在第一时间予以处理 ,同时向您表示歉意!为尊重作者版权,请购买原版作品,支持您喜欢的作者,谢谢!
4. 本站一律禁止以任何方式发布或转载任何违法的相关信息,访客如有发现请立即向站长举报;本站资源文件大多存储在云盘,如发现链接或图片失效,请联系作者或站长及时更新。
THE END
喜欢就支持一下吧
相关推荐