Italy is falling  and I’m riding it upside down

archives \ about / contact \ code / le penne altrui


< previously: Lighter Menus // following: Plastic Tunes >
 

March 12th 2007. Better nearby post links

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 formatting.
As a matter of fact it is pretty typical for previous and next posts titles to claim a little too much room in any blog template, and the only workaround in wordpress so far is to replace the title of the posts with generic phrases like 'next post', 'previous post' and so on.
Now with this plugin you can use the title of the posts to link to them and still be able to fit them nicely in your template.

Download

» version 1.0
~ 522 downloads since July 27th, 2007

(Version 1.0 has been adapted to Wordpress 2.5. If you notice that the exclusion of categories is broken, it is not this plugin's fault. It's wordpress 2.5 fault. See here.)

Install

extract, upload to the plugins folder of your wordpress install, activate. See "Usage".

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 '|')

Usage

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.

For example, for a post entitled "post with a too darn long title to fit into my neat template", using the following tag:
<?php my_prev_post_link('%link', '&laquo; %title',false,'',25,'previous post: ') ?>
will give a result like this one:

"previous post: « post with a title too..."


 
 


italyisfalling.com/category/wordpress-things/feed/ The plugins are apart from the rest of the website. Here's a > dedicated RSS feed < to keep you updated on them.


// recent comments:





 

10 Responses to “Better nearby post links” :



prash said

you, sir, rock!
this resolves my recent request on the wordpress forum.
http://wordpress.org/support/topic/107274
wonder why wordpress didn’t include such a useful feature!
thank you - it works beautifully!
-prash.



Scott Carpenter said

Excellent! Thank you.



Gijet said

Thanks for this plugins. I’ve installed and activated it. I used GlossyBlue theme on Wordpress 2.2.2. In the index of that theme, there’s code like below:

I changed code above to:

But, what happen? the output is NOT appear :( so please tell me.



corpodibacco said

Gijet, wordpress strips out the tags from the comments as you see (



Gerbs said

Great, works perfectly. Really cleans-up the design, thanks.



Matt said

I’ll be using this plugin on our new company website. Thank you very much. Nice work



The IT Monkey said

How would I implement this on the index page?

On the index page WP wants us to use the “posts_nav_link” call but this takes the user to the next PAGE. I need something that takes them to the previous POST but can be called from the index page.
The site I am working on has one post per page and the current navigation works fine with the exception of when someone uses stumble or bookmarks a particular post they are bookmarking that page, but tomorrow that post won’t be on that page.
I am at a loss.



Comme une image said

Nice simple plugin !

Just missing a default value for the last argument in your two functions
this way => function my_next_post_link($format= [...], $pre_link=”)

(btw, it’s “length” and not “lenght”)

I had to oper some minor change for int8 purpose (’next post:’ and ‘previous post:’ are hard-coded for the tooltips content, I just dropped them).
Also I replaced ‘…’ with ‘…’ (ellipsis), changed the truncation so that the max. number of character is really the one demanded, ellipis INCLUDED (which now count for 1 char).

(And I like your site design a lot : bravo !)



corpodibacco said

@Comme une image, It Monkey, anybody else reading: sorry guys, but these days I just can’t give any support to my plugins, nor update them etc. I know it sucks, and I hate it. But I don’t have the time. I hope I will find it later on. Meanwhile, again, I apologize…! And Thanks to everyone using the plugin! And thanks Comme une image, I am glad you like the design.



headjhonusau said

black google ocean house see england night we bag

Leave a Reply :


Italy is falling is an italian blog in english language // not entirely irresponsible // it was born on the first of july 2005 // it is based on wordpress 2.5.1 // it is ad-free // it resisted 36,346 spamming attempts // template, graphics and content are © italyisfalling.com 2008 according to this creative commons license // all is made with ~love