WordPress.org
Get WordPress
WordPress.org

WordPress Developer Resources

previous_post()

previous_post( string $format = '%', string $previous = 'previous post: ', string $title = 'yes', string $in_same_cat = 'no', int $limitprev = 1, string $excluded_categories = '' )

In this article

Back to top

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

Prints a link to the previous post.

Description

See also

Parameters

$formatstringoptional

Default:'%'

$previousstringoptional

Default:'previous post: '

$titlestringoptional

Default:'yes'

$in_same_catstringoptional

Default:'no'

$limitprevintoptional

Default:1

$excluded_categoriesstringoptional

Default:''

Source

function previous_post($format='%', $previous='previous post: ', $title='yes', $in_same_cat='no', $limitprev=1, $excluded_categories='') {	_deprecated_function( __FUNCTION__, '2.0.0', 'previous_post_link()' );	if ( empty($in_same_cat) || 'no' == $in_same_cat )	$in_same_cat = false;	else	$in_same_cat = true;	$post = get_previous_post($in_same_cat, $excluded_categories);	if ( !$post )	return;	$string = '<a href="'.get_permalink($post->ID).'">'.$previous;	if ( 'yes' == $title )	$string .= apply_filters('the_title', $post->post_title, $post->ID);	$string .= '</a>';	$format = str_replace('%', $string, $format);	echo $format; }

View all references View on Trac View on GitHub

Hooks

apply_filters( ‘the_title’, string $post_title, int $post_id )

Filters the post title.

UsesDescription
get_previous_post()wp-includes/link-template.php

Retrieves the previous post that is adjacent to the current post.

_deprecated_function()wp-includes/functions.php

Marks a function as deprecated and inform when it has been used.

get_permalink()wp-includes/link-template.php

Retrieves the full permalink for the current post or post ID.

apply_filters()wp-includes/plugin.php

Calls the callback functions that have been added to a filter hook.

Show 2 moreShow less

Changelog

VersionDescription
2.0.0Use previous_post_link()
1.5.0Introduced.

User Contributed Notes

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