Documentation - How To - Next Post Link

Share on FacebookTweet about this on TwitterShare on Google+Share on LinkedInPrint this page

Next Post Link

Being used mainly on single post template, this tag display a link to a next post relative to the current post, from a sort list.

This tag must be used within the query loop.

The default WordPress function used for next navigational link is next_post_link. This is very limited in functionality and there is no possibility to apply a sort list and a specific taxonomy term to which the post is related to.

An improvement for that function is next_post_type_link

Arguments:
next_post_type_link($format, $link, $argv);

If $argv is empty the archive order will be used.

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

$link
(string) Link text to display. Defaults to next post’s title (‘%title’).

$argv(array) List of function arguments:
sort_id – the sort id, which order apply
taxonomy – use a specified sort taxonomy
term_id – use a specified sort taxonomy term

Examples

Return next post link using order from taxonomy ‘Features’ within term_id 10

$args   =   array(
                        'sort_id'   =>  25,
                            'taxonomy'  =>  'features',
                            'term_id'   =>  10
                        );
next_post_type_link( '%link', __( '<span class="meta-nav">Next Post</span> %title', 'twentyfourteen' ), $args );

Using WPML return next post link using order from taxonomy ‘Features’ within term_id 10

$args   =   array(
                        'sort_id'   =>  25,
                            'taxonomy'  =>  'features',
                            'term_id'   =>  apply_filters( 'wpml_object_id', 10, 'category', TRUE  )
                        );
next_post_type_link( '%link', __( '<span class="meta-nav">Next Post</span> %title', 'twentyfourteen' ), $args );