the_attachment_link() – Function | Developer.WordPress.org

Displays an attachment page link using an image or icon.

Parameters

$postint|WP_Postoptional: Post ID or post object.
$fullsizebooloptional: Whether to use full size.
Default:false
$deprecatedbooloptional: Deprecated. Not used.
Default:false
$permalinkbooloptional: Whether to include permalink.
Default:false

More Information

Outputs an HTML hyperlink to an attachment file or page, containing either

A full-size image or thumbnail for image attachments; or
The attachment’s title (as text) for non-image attachments

If no attachment can be found, the function displays the string Missing Attachment.

Use wp_get_attachment_link() instead if you just want to get the hyperlink, not print it.

Source

function the_attachment_link( $post = 0, $fullsize = false, $deprecated = false, $permalink = false ) {
	if ( ! empty( $deprecated ) ) {
		_deprecated_argument( __FUNCTION__, '2.5.0' );
	}

	if ( $fullsize ) {
		echo wp_get_attachment_link( $post, 'full', $permalink );
	} else {
		echo wp_get_attachment_link( $post, 'thumbnail', $permalink );
	}
}

View all references View on Trac View on GitHub

Uses	Description
wp_get_attachment_link()`wp-includes/post-template.php`	Retrieves an attachment page link using an image or icon, if possible.
_deprecated_argument()`wp-includes/functions.php`	Marks a function argument as deprecated and inform when it has been used.

Changelog

Version	Description
2.0.0	Introduced.

User Contributed Notes

Skip to note 2 content

Codex 9 years ago

You must log in to vote on the helpfulness of this noteVote results for this note: 0You must log in to vote on the helpfulness of this note
Examples
```
<?php

// Show an image at full size linked to the attachment file
the_attachment_link( 4, true );

// Show a thumbnail linked to the attachment page
the_attachment_link( 4, false, false, true );

?>
```
Log in to add feedback

the_attachment_link( int|WP_Post $post, bool $fullsize = false, bool $deprecated = false, bool $permalink = false )

In this article

Parameters

More Information

Source

Changelog

User Contributed Notes

the_attachment_link( int|WP_Post $post, bool $fullsize = false, bool $deprecated = false, bool $permalink = false )

In this article

Parameters

More Information

Source

Related

Changelog

User Contributed Notes