WordPress获取附件链接标签函数:wp_get_attachment_link

文 / @UTHEME

当提供的附件ID为图像附件时,WordPress函数wp_get_attachment_link与wp_get_attachment_image()函数的区别在于,wp_get_attachment_image()函数输出一个img元素,而wp_get_attachment_link()函数是一个包含img元素的链接标签,该链接指向附件URL。

wp_get_attachment_link( int|WP_Post $id, string|int[] $size = 'thumbnail', bool $permalink = false, bool $icon = false, string|false $text = false, array|string $attr = '' )

函数参数

$id

整数或对象

附件ID或WP_Post对象

$size

字符串或数字数组,默认值:thumbnail

指定图像大小,可以是已定义的缩略图名称,或包含宽度和高度的数组。

$permalink

布尔值,默认值:false

默认值下,链接的URL为附件文件的URL,如果值true,则为附件页面的链接。

$icon

布尔值,默认值:false

值为true时,如果附件为非图像文件,将显示对应的图标。

$text

字符串,默认值:false

要使用的链接文本,即锚文本。如果附件为图像,默认的锚文本是img图像标签,当指定$text值后,锚文本将变为指定的文本。

$attr

数组

属性数组,可以指定多个属性。

函数返回值

<a href="https://www.tiezhushuo.com/wp-content/uploads/2020/05/baidusrf-for-linux.webp">	
	<img width="768" height="430" src="https://www.tiezhushuo.com/wp-content/uploads/2020/05/baidusrf-for-linux.webp" class="attachment-full size-full" alt="百度输入法Linux版本" loading="lazy">
</a>

函数使用示例

<?php 
    $id = 9;
    echo wp_get_attachment_link($id, array('400', '300'), false, false, '点击这里'); 
?>

扩展阅读

wp_get_attachment_link()函数位于:wp-include/post-template.php

相关函数:

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