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 = '' )

使用示例

• 示例1

  将附件链接到文章
  本例将附件链接到附件页面。

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

• 示例2

  显示Medium尺寸的附件
  WordPress的默认图像尺寸为“thumbnail”、“medium”、“large”和“full”（原始尺寸）。这些图片尺寸可以在WordPress媒体管理面板在 设置 > 媒体 中配置。

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

• 示例3

  将文本链接到附件
  此示例返回一个HTML超链接，其中“我的链接文本”链接到附件文件。

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

• 示例4

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

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

• 示例5

  更改图标目录
  WordPress可以使用媒体图标来表示博客和管理界面上的附件文件（如果这些图标可用）。对于图像，它返回缩略图。对于其他媒体类型，它会在目录wp-includes/images/crystal/中查找按媒体类型命名的图像文件（例如audio.jpg）。

  这个例子展示了如何将这个目录更改为主题wp-content/themes/yourtheme/images中名为“images”的文件夹。创建文件夹并将“媒体类型图像”放入其中。要告诉WordPress目录已更改，请将其放入当前主题的functions.php文件中：

  add_filter( 'icon_dir', 'wpdocs_theme_icon_directory' );
  add_filter( 'icon_dir_uri', 'wpdocs_theme_icon_uri' );
  
  /**
   * Get the path to the icon directory
   */
  function wpdocs_theme_icon_directory( $icon_dir ) {
  	return get_stylesheet_directory() . '/images';
  }
  
  /**
   * Get the URI of the icon directory
   */
  function wpdocs_theme_icon_uri( $icon_dir ) {
  	return get_stylesheet_directory_uri() . '/images'; 
  }
  

• 示例6

  我试图找出如何链接到“附件页”而不是“媒体文件”，我花了很长时间才理解$permalink参数。我只是通过一个用户提供的示例来解决这个问题。也许你可以让它的名称与管理中在将图像添加到页面/文章时使用的术语相对应，使其更清楚：“链接到”-具有“媒体文件”、“附件页”或“自定义URL”（由用户输入）选项。