WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

get_the_attachment_link()

get_the_attachment_link( int $id, bool $fullsize = false, array $max_dims = false, bool $permalink = false ): string

In this article

Back to top

This function has been deprecated. Use wp_get_attachment_link() instead.

Retrieve HTML content of attachment image with link.

Description

See also

Parameters

$idintoptional
Post ID.
$fullsizebooloptional
Whether to use full size image.

Default:false

$max_dimsarrayoptional
Max image dimensions.

Default:false

$permalinkbooloptional
Whether to include permalink to image.

Default:false

Return

string

Source

function get_the_attachment_link($id = 0, $fullsize = false, $max_dims = false, $permalink = false) {
	_deprecated_function( __FUNCTION__, '2.5.0', 'wp_get_attachment_link()' );
	$id = (int) $id;
	$_post = get_post($id);

	if ( ('attachment' != $_post->post_type) || !$url = wp_get_attachment_url($_post->ID) )
		return __('Missing Attachment');

	if ( $permalink )
		$url = get_attachment_link($_post->ID);

	$post_title = esc_attr($_post->post_title);

	$innerHTML = get_attachment_innerHTML($_post->ID, $fullsize, $max_dims);
	return "<a href='$url' title='$post_title'>$innerHTML</a>";
}

View all references View on Trac View on GitHub

Changelog

VersionDescription
2.5.0Use wp_get_attachment_link()
2.0.0Introduced.

User Contributed Notes

You must log in before being able to contribute a note or feedback.