previous_image_link( string|array $size = 'thumbnail', string $text = false )
Displays previous image link that has the same post parent.
Description Description
See also See also
Parameters Parameters
- $size
-
(string|array) (Optional) Image size. Accepts any valid image size, an array of width and height values in pixels (in that order), 0, or 'none'. 0 or 'none' will default to 'post_title' or
$text.Default value: 'thumbnail'
- $text
-
(string) (Optional) Link text.
Default value: false
Source Source
File: wp-includes/media.php
function previous_image_link( $size = 'thumbnail', $text = false ) {
adjacent_image_link( true, $size, $text );
}
Expand full source code Collapse full source code View on Trac
Changelog Changelog
| Version | Description |
|---|---|
| 2.5.0 | Introduced. |
User Contributed Notes User Contributed Notes
You must log in before being able to contribute a note or feedback.
Basic Examples
Default Usage
Working example
Choose a Recognized Image Size
Define a Custom Image Size
Please note that passing an array as the first parameter will not create a new image; It will use the web browser to re-size the thumbnail to fit into the given dimensions. Although this works in a pinch, it produces a rather distorted view of the image due to the fact that browsers have no way of re sampling the re-sized image.
Use the Image’s Title as Link Text
If a Boolean false is used as the first parameter, The function will use the image’s title value (as set through the Media Library).
Use a Custom String as Link Text
To specify a custom string as the link text, pass a Boolean false as the first parameter and the custom text as a string to the second parameter.