Previous Post Link

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

Used on single post permalink pages, this template tag displays a link to the previous post which exists in chronological order from the current post.

This tag must be used in The Loop.

The default WordPress function for this is previous_post_link. However this offer a very limited capability and there is no way to receive the previous post within a taxonomy term and using the custom defined order.

An improvement for that function is previous_post_type_link


previous_post_type_link($format, $link, $argv);

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


$format(string) Format string for the link. This is where to control what comes before and after the link. '%link' in 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 '&laquo; %link'.

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

$argv(array) List of function arguments:
sort_id – the sort id which order will be used
taxonomy – use the specified sort taxonomy
term_id – use the specified sort taxonomy term


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

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


Usign WPML return previous post link using order from taxonomy ‘Features’ within term_id 10 (default language)

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


API Index

  • Alex Smart

    undated. gee, thanks.