next_image_link() WordPress Function
The next_image_link() function allows you to display a link to the next image attachment in a WordPress post. This can be useful if you want to create a gallery of images and allow your readers to navigate through them.
next_image_link( string|int[] $size = 'thumbnail', string|false $text = false ) #
Displays next 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
More Information
- Whenever a series of images are linked to the attachment page, it will put a ‘next image link’ with the images when viewed in the attachment page.
- Typically uses in
attachment.php. In the WordPress default theme Twenty Eleven and Twenty Twelve, it is used inimage.php.next_image_link( $size, $text );
Source
File: wp-includes/media.php
function next_image_link( $size = 'thumbnail', $text = false ) {
echo get_next_image_link( $size, $text );
}
Expand full source codeCollapse full source codeView on TracView on GitHub
Changelog
| Version | Description |
|---|---|
| 2.5.0 | Introduced. |