Better Adjacent Post Links

September 09, 2009

Better Adjacent Post Links Plugin

Adds two enhanced commands to replace wordpress 'previous post' and 'next post' functions. Works with Wordpress 2.8+.

If you are used to link the ‘previous’ and ‘next’ posts on a wordpress blog using their own title, you have probably noticed how more often than not too long titles can cause broken lines, hence unpredictable results in terms of page layout.

The only workaround in wordpress so far was to replace the title of the posts with generic phrases like ‘next post’, ‘previous post’ and so on. With this plugin you can use the title of the post itself, and trim it as needed.

Features:

  • limits the length of the previous and next post titles to the number of characters you want
  • where necessary, truncates the title to the last space, adding three dots
  • shows the entire title of the post in the tooltip (mysteriously wordpress never considers the tooltips of the links)
  • sets the string that conditionally will appear before the link title, only if the link title itself is present (previously in wordpress you either had to add a string outside of the ‘next/previous post’ tag, thus causing it to appear in the page even if the link was not present, or you had to add the string inside the link generated by wordpress, with ugly results: for example if the string was just a simple dividing character like ‘|’)

Installation

Extract, upload to the plugins folder of your wordpress install, activate.

How to use:

This plugin adds two specific functions to your wordpress install: my_prev_post_link and my_next_post_link.
These two functions are very similar to, and support the same variables of the original wordpress tags they are meant to replace (please refer to the relative wordpress codex pages for their use), previous_post_link and next_post_link.
My replacement functions anyway come with two additional variables: $string_lenght and $pre_link. Not that you really needed to know how they were called.

The first variable indicates the maximum length for the title (default is 22 characters). The second the string to be displayed before the link (only if the link itself is present).

So, you’ll just have to replace <?php next_post_link(); ?> in your template with <?php my_next_post_link() ?>, obviously indicating between the brackets the variables you want to specify. Again, refer to the wordpress codex for usage of variables: only keep in mind that my two additional variables, $string_lenght and $pre_link, are the second last and last variable of the function.

Changelog

1.1

Fixed a bug that caused the next link not to be generated. Thanks to Rebecca and Zak for poiting the bug out.

Details

  • Version: 1.1
  • Active installations: 100
  • WordPress Version: 2.0.2
  • Tested up to: 2.8.4

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars