wp_get_attachment_link 获取多媒体链接
文 / @WordPress主题
我是小本本,今天给大家介绍一下wp_get_attachment_link函数。
函数描述
返回一个链接到附件文章或页面的HTML链接,可以是以下任何一个。
- 指定尺寸的图片
- 代表附件的图标
- 附件标题
- 自定义文本
如果附件不存在,此函数将返回字符串 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()。
相关文章
-
如何创建WordPress古腾堡编辑器的区块(PHP+原生JS) 2024-01-10 01:01:06
-
搭建一个WordPress网站需要多少成本 2023-11-06 00:09:51
-
Symlink介绍(附:如何使用Symlink进行WordPress开发) 2023-11-05 23:38:32
-
让WordPress实现数据库同步的插件:HyperDB 2023-10-24 23:40:49
-
allegro电商平台值得做吗(附:2023年Allegro注册流程指南) 2023-10-08 21:53:39
-
印度跨境电商平台有哪些(附:印度跨境电商做什么产品好) 2023-10-08 21:34:23
-
跨境电商必看的几大海外二手电商平台 2023-10-08 18:04:42
-
WordPress同城互联网产品解决方案:UBASE 2023-10-03 16:40:39
-
WordPress网站的安全插件:wordfence 2023-09-14 09:25:18
-
WordPress 6.3 支持在手动更新插件和主题失败后回滚旧版本 2023-08-28 16:58:45