Title: Ambrosite Next/Previous Post Link Plus Author: ambrosite Published: May 12, 2010 Last modified: February 16, 2012 --- Search plugins This plugin **hasn’t been tested with the latest 3 major releases of WordPress**. It may no longer be maintained or supported and may have compatibility issues when used with more recent versions of WordPress. ![](https://s.w.org/plugins/geopattern-icon/ambrosite-nextprevious-post-link-plus. svg) # Ambrosite Next/Previous Post Link Plus By [ambrosite](https://profiles.wordpress.org/ambrosite/) [Download](https://downloads.wordpress.org/plugin/ambrosite-nextprevious-post-link-plus.zip) * [Details](https://wordpress.org/plugins/ambrosite-nextprevious-post-link-plus/#description) * [Reviews](https://wordpress.org/plugins/ambrosite-nextprevious-post-link-plus/#reviews) * [Installation](https://wordpress.org/plugins/ambrosite-nextprevious-post-link-plus/#installation) * [Development](https://wordpress.org/plugins/ambrosite-nextprevious-post-link-plus/#developers) [Support](https://wordpress.org/support/plugin/ambrosite-nextprevious-post-link-plus/) ## Description **IMPORTANT: Make sure you are using the right plugin.** * **Next/Previous Post Link Plus** is intended for use in **single post** templates. * **Next/Previous Page Link Plus** is intended for use in **page** templates. The two plugins have similar sounding, but different, function names. If you mistakenly install the wrong plugin, you will get a “call to undefined function” error. If you want to create next/previous links for your pages, please check out: https:// wordpress.org/extend/plugins/ambrosite-nextprevious-page-link-plus/ **IMPORTANT: This plugin is not compatible with PHP 4.** If you try to install it on a host running PHP 4, you will get a parse error. WordPress has officially ended support for PHP 4 as of version 3.2, so you should upgrade to PHP 5.2 now. For those who cannot upgrade, you can download the alternate PHP 4 compatible version of the plugin. The only difference with the PHP 4 version is that the _%category_ variable will not work with custom taxonomies. http://www.ambrosite.com/download/ambrosite- nextprevious-post-link-plus.php4.zip This plugin creates two new template tags — **next_post_link_plus** and **previous_post_link_plus**— which are upgraded versions of the core WordPress next_post_link and previous_post_link template tags. The new tags include all of the functionality of the core tags, plus the following additional options: * Sort the next/previous post links on columns other than post_date (e.g. alphabetically). * Sort next/previous links on custom fields (both string and integer sorts are supported). * Full WordPress 3.3 compatibility, including support for custom post types, custom taxonomies, and post formats. * Loop around to the first post if there is no next post (and vice versa). * Retrieve the first/last post, rather than the previous/next post (for First|Previous |Next|Last navigation links). * Display post thumbnails alongside the links (WordPress 2.9 or higher). * Truncate the link titles to any length, and display custom text in the tooltip. * Display the title, date, author, category, and meta value of the next/previous links. * Specify a custom date format for the %date variable. * Restrict next/previous links to same category, taxonomy, format, author, custom field value, custom post ID list, or custom category list. * Exclude categories, custom taxonomies, post formats, or individual post IDs. * Three category exclusion methods for greater control over the navigation stream. * Return multiple next/previous links (e.g. the next N links, in an HTML list). * Return the ID, title, date, href attribute, or post object of the next/previous links, instead of echoing them to the screen. * Return false if no next/previous link is found, so themes may conditionally display alternate text. * Works with Post Types Order and other popular post reordering plugins. Extensive documentation on configuring the plugin may be found here: http://www. ambrosite.com/plugins/next-previous-post-link-plus-for-wordpress ## Installation * Upload ambrosite-post-link-plus.php to the /wp-content/plugins/ directory. * Activate the plugin through the Plugins menu in WordPress. * Edit your template files, and replace the next_post_link and previous_post_link template tags with next_post_link_plus and previous_post_link_plus. Configure them using parameters as explained in the online documentation: http://www.ambrosite. com/plugins/next-previous-post-link-plus-for-wordpress ## FAQ * How exactly do I install this plugin? Which file needs to be edited, and where do I put the code? * I am getting a parse error while attempting to install the plugin. Why? * I am getting a “call to undefined function” error. Why? * How can I get rid of the arrows on my next/previous links? * I am confused about the difference between strong, differential, and weak exclusion. Which one should I use? * I am using a custom field with a simple integer value to order my posts, but they’re not sorting correctly. Why? * I am seeing the number ‘1’ printed next to my links. Why? * What about compatibility with the Post Types Order plugin? * What about compatibility with the WPML plugin? * What about compatibility with the qTranslate plugin? * Is there any way to use an image instead of link text? Answers to these questions may be found here: http://www.ambrosite.com/plugins/ next-previous-post-link-plus-for-wordpress#faq Installation Instructions * Upload ambrosite-post-link-plus.php to the /wp-content/plugins/ directory. * Activate the plugin through the Plugins menu in WordPress. * Edit your template files, and replace the next_post_link and previous_post_link template tags with next_post_link_plus and previous_post_link_plus. Configure them using parameters as explained in the online documentation: http://www.ambrosite. com/plugins/next-previous-post-link-plus-for-wordpress ## Reviews ![](https://secure.gravatar.com/avatar/446698664aecacfe4129dba741adca98d4270bb6f8a1d6ce2d53b21362f20f5d? s=60&d=retro&r=g) ### 󠀁[Highly recommended](https://wordpress.org/support/topic/highly-recommended-397/)󠁿 [followalter](https://profiles.wordpress.org/followalter/) May 8, 2020 This plugin has saved me countless hours and does exactly what it needs to do with easy setup and lots of options. Love it. ![](https://secure.gravatar.com/avatar/88647064121ee9aede069e88088aa2476100f8ef149144f93e95da1eff262aba? s=60&d=retro&r=g) ### 󠀁[Works great on WP 5.4 with Multisite](https://wordpress.org/support/topic/works-great-on-wp-5-4-with-multisite/)󠁿 [Pekka](https://profiles.wordpress.org/pekkagaiser/) April 13, 2020 The plugin works great on my 5.4 copy and does exactly what I need: give me the next/previous links for a specific category, rather than all the categories the post is in like the built-in functions do. Thank you! ![](https://secure.gravatar.com/avatar/226dfc76da6ea7c7d3c7be4351ccff2fa6728b08994597a13385170045430a99? s=60&d=retro&r=g) ### 󠀁[Still working after all these years](https://wordpress.org/support/topic/still-working-after-all-these-years-3/)󠁿 [o2xav](https://profiles.wordpress.org/o2xav/) December 10, 2019 Works great, thanks for the time saver, and for keeping my function.php clean 🙂 ![](https://secure.gravatar.com/avatar/4715841d6f90c891467d66d4a0f0bffea756c0fc58d03e9d2dc797b50c85d73e? s=60&d=retro&r=g) ### 󠀁[Powerful and still works](https://wordpress.org/support/topic/powerful-and-still-works/)󠁿 [mikechalmers](https://profiles.wordpress.org/mikechalmers/) February 4, 2017 I’ve been using for years and still works well with current Wordpress. It’s the only thing I’ve found that allows me to create the theme I want. Thanks! ![](https://secure.gravatar.com/avatar/970b2697e30de473360ad3bf43f2d166986408140af40f1ce47b136bb03808bd? s=60&d=retro&r=g) ### 󠀁[What a time saver!](https://wordpress.org/support/topic/what-a-time-saver-13/)󠁿 [James Whayman [WildPress]](https://profiles.wordpress.org/epiphron/) October 25, 2016 Great plugin, saved a big headache. Thank you. ![](https://secure.gravatar.com/avatar/44f0a304f4e29abd98a9b2b35ecb7be03b1aa0fa6869f6897009029613f9d0fb? s=60&d=retro&r=g) ### 󠀁[Excellent – does what it says.](https://wordpress.org/support/topic/excellent-does-what-it-says-6/)󠁿 [latcomsystems](https://profiles.wordpress.org/latcomsystems/) September 3, 2016 Has many options to customize as well. Hasn’t been update for a while, but still works perfectly with WP 4.5.3. [ Read all 49 reviews ](https://wordpress.org/support/plugin/ambrosite-nextprevious-post-link-plus/reviews/) ## Contributors & Developers “Ambrosite Next/Previous Post Link Plus” is open source software. The following people have contributed to this plugin. Contributors * [ ambrosite ](https://profiles.wordpress.org/ambrosite/) [Translate “Ambrosite Next/Previous Post Link Plus” into your language.](https://translate.wordpress.org/projects/wp-plugins/ambrosite-nextprevious-post-link-plus) ### Interested in development? [Browse the code](https://plugins.trac.wordpress.org/browser/ambrosite-nextprevious-post-link-plus/), check out the [SVN repository](https://plugins.svn.wordpress.org/ambrosite-nextprevious-post-link-plus/), or subscribe to the [development log](https://plugins.trac.wordpress.org/log/ambrosite-nextprevious-post-link-plus/) by [RSS](https://plugins.trac.wordpress.org/log/ambrosite-nextprevious-post-link-plus/?limit=100&mode=stop_on_copy&format=rss). ## Changelog #### 2.4 * Added ‘in_cats’ parameter. * Added ‘in_same_meta’ parameter. * Added ‘return’ parameter to specify what should be returned from the function. * Added ‘date_format’ parameter for customizing the %date variable. * Added %title variable to ‘format’ parameter. * Added option to sort on custom fields as integers rather than strings. * Primary sort column defaults to ‘menu_order’ if Post Types Order plugin is installed. * Many documentation updates to address frequently asked questions. #### 2.3 * Added ‘in_same_author’ parameter. * Added ‘in_posts’ parameter. * Added ‘post_type’ parameter. * Added option to specify a custom taxonomy with ‘in_same_tax’. * Added new format variable (%author). * Added variables (%title, %date, %author) to custom tooltip text. * Added option to suppress the tooltip completely. * Renamed filters for compatibility with Post Types Order and other plugins that attempt to filter the output of get_adjacent_post. #### 2.2 * Added option to retrieve the first/last post links. * Added support for post formats. * Improved support for custom taxonomies. * Added ‘tooltip’ parameter to specify custom tooltip text. * Added %meta variable to the format parameter. * Ground-up rewrite of the ‘ex_cats’ functionality, with three exclusion methods for greater control over the navigation stream. * Added ‘ex_posts’ parameter to exclude individual post IDs. * Added option to return the next/previous links as a PHP string. #### 2.1 * Added ‘order_2nd’ parameter for specifying a secondary sort column. * Updated the documentation to address PHP 4 incompatibility problems. #### 2.0 * Full WordPress 3.0 compatibility, including custom post types. * Rewrote the plugin using wp_parse_args to simplify the function calls. * Added option to sort the next/previous links on custom fields. * Added option to return multiple next/previous links. * Fix for custom taxonomies. * Added %category variable to the format parameter. * Added ‘before’ and ‘after’ parameters. * Added support for post thumbnail sizes. * Added ‘echo’ parameter. #### 1.1 * Added truncate link title and loop options. * Added support for post thumbnails. #### 1.0 * Initial version. ## Meta * Version **2.4** * Last updated **9 years ago** * Active installations **5,000+** * WordPress version ** 2.5 or higher ** * Tested up to **3.3.2** * Tags * [adjacent](https://wordpress.org/plugins/tags/adjacent/)[link](https://wordpress.org/plugins/tags/link/) [next](https://wordpress.org/plugins/tags/next/)[post](https://wordpress.org/plugins/tags/post/) [previous](https://wordpress.org/plugins/tags/previous/) * [Advanced View](https://wordpress.org/plugins/ambrosite-nextprevious-post-link-plus/advanced/) ## Ratings 4.9 out of 5 stars. * [ 47 5-star reviews ](https://wordpress.org/support/plugin/ambrosite-nextprevious-post-link-plus/reviews/?filter=5) * [ 1 4-star review ](https://wordpress.org/support/plugin/ambrosite-nextprevious-post-link-plus/reviews/?filter=4) * [ 0 3-star reviews ](https://wordpress.org/support/plugin/ambrosite-nextprevious-post-link-plus/reviews/?filter=3) * [ 0 2-star reviews ](https://wordpress.org/support/plugin/ambrosite-nextprevious-post-link-plus/reviews/?filter=2) * [ 1 1-star review ](https://wordpress.org/support/plugin/ambrosite-nextprevious-post-link-plus/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/ambrosite-nextprevious-post-link-plus/reviews/#new-post) [See all reviews](https://wordpress.org/support/plugin/ambrosite-nextprevious-post-link-plus/reviews/) ## Contributors * [ ambrosite ](https://profiles.wordpress.org/ambrosite/) ## Support Got something to say? Need help? [View support forum](https://wordpress.org/support/plugin/ambrosite-nextprevious-post-link-plus/) ## Donate Would you like to support the advancement of this plugin? [ Donate to this plugin ](http://www.ambrosite.com/plugins)