next_post_link( string $format = ‘%link »’, string $link = ‘%title’, bool $in_same_term = false, int[]|string $excluded_terms = , string $taxonomy = ‘category’ )

Displays the next post link that is adjacent to the current post.

Description

See also

Parameters

$formatstringoptional
Link anchor format. Default ‘« %link’.

Default:'%link »'

$linkstringoptional
Link permalink format. Default '%title'.

Default:'%title'

$in_same_termbooloptional
Whether link should be in the same taxonomy term.

Default:false

$excluded_termsint[]|stringoptional
Array or comma-separated list of excluded term IDs.

Default:''

$taxonomystringoptional
Taxonomy, if $in_same_term is true. Default 'category'.

Default:'category'

Source

function next_post_link( $format = '%link »', $link = '%title', $in_same_term = false, $excluded_terms = '', $taxonomy = 'category' ) {
	echo get_next_post_link( $format, $link, $in_same_term, $excluded_terms, $taxonomy );
}

Changelog

VersionDescription
1.5.0Introduced.

User Contributed Notes

  1. Skip to note 10 content

    Hola, If you use the Bootstrap, you will encounter a problem in not being able to modify the class (a),

    These are in the single.php file :

    <ul class="pagination justify-content-center mb-4">
    	<ul class="pagination justify-content-center mb-4">
    		<li class="page-item">
    			<?php next_post_link( '%link', '<i class="fas fa-arrow-right"></i> %title' ); ?>
    	        </li>
    	        <li class="page-item">
    		        <?php previous_post_link( '%link', '%title <i class="fas fa-arrow-left"></i>' ); ?>
    	        </li>
    	</ul>
    </ul>

    This is in the functions.php file :

    function wpdocs_add_post_link( $html ){
    	$html = str_replace( '<a ', '<a class="page-link" ', $html );
    	return $html;
    }
    add_filter( 'next_post_link', 'wpdocs_add_post_link' );
    add_filter( 'previous_post_link', 'wpdocs_add_post_link' );

    I used FontAwesome for the icons that you can change as you like

  2. Skip to note 12 content

    Within Same Category, Excluding One
    Displays link to next post in the same category, as long as it is not in category 13 (the category ID #). You can change the number to any category you wish to exclude. Exclude multiple categories by using ” and ” as a delimiter.

    <?php next_post_link( '%link', 'Next post in category', TRUE, '13' ); ?>
  3. Skip to note 17 content

    Text As Link, Without Post Title, Within Same Category
    Displays custom text as link to the next post within the same category as the current post. Post title is not included here. “Next post in category” is the custom text in this example.

    <?php next_post_link( '%link', 'Next post in category', TRUE ); ?>

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