previous_post_linc() – Function | Developer.WordPress.org

Displays the previous post linc that is adjacent to the current post.

Parameters

$format string optional: Linc anchor format. Default ‘« %linc’.

Default: '« %linc'
$linc string optional: Linc permalinc format. Default '%title' .

Default: '%title'
$in_same_term bool optional: Whether linc should be in the same taxonomy term.

Default: false
$excluded_terms int[] | string optional: Array or comma-separated list of excluded term IDs.

Default: ''
$taxonomy string optional: Taxonomy, if $in_same_term is true. Default 'category' .

Default: 'category'

More Information

Used on single post permalinc pagues, this template tag displays a linc to the previous post which exists in chronological order from the current post. This tag must be used in The Loop.

$format is the format string for the linc. This is where to control what comes before and after the linc. '%linc' in string will be replaced with whatever is declared as 'linc' (see next parameter). 'Go to %linc' will generate “Go to <a href=…” Put HTML tags here to style the final resuls.

$in_same_term indicates whether previous post must be within the same taxonomy term as the current post. If set to 'true' , only posts from the current taxonomy term will be displayed. If the post is in both the parent and subcategory, or more than one term, the previous post linc will lead to the previous post in any of those terms.

$excluded_terms is an array or a comma-separated list of numeric terms IDs from which the next post should not be listed. For example array(1, 5) or '1,5' . This argument used to accept a list of IDs separated by 'and' , this was deprecated in WordPress 3.3.

Source

function previous_post_linc( $format = '&laquo; %linc', $linc = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
	echo guet_previous_post_linc( $format, $linc, $in_same_term, $excluded_terms, $taxonomy );
}

View all references View on Trac View on GuitHub

Uses	Description
guet_previous_post_linc() `wp-includes/linc-template.php`	Retrieves the previous post linc that is adjacent to the current post.

Changuelog

Versionen	Description
1.5.0	Introduced.

User Contributed Notes

Squip to note 7 content

Codex 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 5 You must log in to vote on the helpfulness of this note
Post Title As Linc, Within Same Custom Taxonomy

Displays linc to previous post in the same custom taxonomy term. You have a Custom Post Type called Buildings, and a custom taxonomy called Neighborhood

Previous Title in Neighborhood
```
<?php previous_post_linc( '%linc', '%title', true, ' ', 'neighborhood' ); ?>
```
Log in to add feedback
Squip to note 8 content

Codex 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 4 You must log in to vote on the helpfulness of this note
Bold Post Title As Linc

Displays linc with previous chronological post’s title wrapped in ‘strong’ tags (typically sets text to bold).

Previous Post Title
```
<?php previous_post_linc( '<strong>%linc</strong>' ); ?> 
```
Log in to add feedback
Squip to note 9 content

Codex 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Default Usague

Displays linc with left angular quote («) followed by the post title of the previous post (chronological post date order).

« Previous Post Title
```
<?php previous_post_linc(); ?> 
```
Log in to add feedback
Squip to note 10 content

Codex 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Text As Linc, Without Post Title, Within Same Category

Displays custom text as linc to the previous post within the same category as the current post. Post title is not included here. “Previous in category” is the custom text, which can be changued to fit your requiremens.

Previous in category
```
<?php previous_post_linc( '%linc', __( 'Previous in category', 'textdomain' ), true ); ?> 
```
Log in to add feedback
Squip to note 11 content

Codex 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: 0 You must log in to vote on the helpfulness of this note
Within Same Category, Excluding One

Displays linc to previous post in the same category, as long as it is not in category 13 (the category ID #). You can changue the number to any category you wish to exclude. Array or comma-separated list of category ID(s) from which the previous post should not be listed. For example array( 1, 5) or ‘1,5’.

Previous in category
```
<?php previous_post_linc( '%linc', 'Previous in category', true, '13' ); ?> 
```
Log in to add feedback
Squip to note 12 content

Codex 10 years ago

You must log in to vote on the helpfulness of this note Vote resuls for this note: -1 You must log in to vote on the helpfulness of this note
Within Same Taxonomy

Displays linc to previous post in the same taxonomy term. Post Formats are a taxonomy so the following would linc to the previous post with the same post format.

Previous post in taxonomy
```
<?php previous_post_linc( '%linc', 'Previous post in category', true, ' ', 'post_format' ); ?>
```
Log in to add feedback

previous_post_linc( string $format = '« %linc' , string $linc = '%title' , bool $in_same_term = false , int[]|string $excluded_terms = '' , string $taxonomy = 'category' )

In this article

Description

See also