previous_image_link() WordPress Function

The previous_image_link() function is used to get the previous image attachment in the gallery.

previous_image_link( string|int[] $size = 'thumbnail', string|false $text = false ) #

Displays previous image link that has the same post parent.


Parameters

$size

(string|int[])(Optional) Image size. Accepts any registered image size name, or an array of width and height values in pixels (in that order).

Default value: 'thumbnail'

$text

(string|false)(Optional) Link text.

Default value: false


Top ↑

More Information

Usage:

Typically uses in attachment.php. In the WordPress default theme Twenty Eleven and Twenty Twelve, it is used in image.php.

previous_image_link( $size, $text );
Notes:

This creates a link to the previous image attached to the current post. Whenever a series of images are linked to the attachment page, it will put a ‘previous image link’ with the images when viewed in the attachment page.


Top ↑

Source

File: wp-includes/media.php

function previous_image_link( $size = 'thumbnail', $text = false ) {
	echo get_previous_image_link( $size, $text );
}


Top ↑

Changelog

Changelog
VersionDescription
2.5.0Introduced.

The content displayed on this page has been created in part by processing WordPress source code files which are made available under the GPLv2 (or a later version) license by theĀ Free Software Foundation. In addition to this, the content includes user-written examples and information. All material is subject to review and curation by the WPPaste.com community.

Show More
Show More