WordPress.org

Template Tags/previous image link

Description

This creates a link to the previous image attached to the current post.

Usage

<?php previous_image_link( [string $size = 'thumbnail'], [string $text = false] ); ?>

Examples

Default Usage

<?php previous_image_link(); ?>

Working example

 <div class="alignleft"><?php previous_image_link() ?></div>

Choose a Recognized Image Size

  <?php previous_image_link( 'thumbnail' ); ?>
  <?php previous_image_link( 'medium' ); ?>
  <?php previous_image_link( 'large' ); ?>
  <?php previous_image_link( 'fullsize' ); ?>

Define a Custom Image Size

  <?php previous_image_link( array( 37, 37 ) ); ?>

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).

  <?php previous_image_link( false ); ?>
  <?php previous_image_link( 0 ); ?>

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.

  <?php previous_image_link( false, 'Previous Image' ); ?>

Parameters

$size

(string) (optional) Optional, default is thumbnail. Size of image, either array or string. 0 or none will default to post_title or $text.

Default: None

$text

(string) (optional) Optional, default is false. If included, link will reflect $text variable.

Default: None

Change Log

Since: 2.5.0