This Wordpress plugin outputs your Blogroll links to a Page or Post. Add [wp-blogroll] to a Page or Post and all your Wordpress links/Blogrolls will be rendered. This extremely simple plug-in enables you to create your own Links page without having to write a custom template.
The output can easily be styled with CSS. Each category with its links is encapsulated in a DIV with a classname called “linkcat”. All the links are attributed with the class “brlink”.
Changelog
- Added a changelog section to the readme.txt
- Added support for notitle parameter – Allows user to remove titles from categories.
1.3.1
Added limit support
1.4.0
Added option to show category descriptions
1.5.0
Added SEO option to force relations. (will render rel=”external”, rel=”nofollow” to links)
1.5.1
Allowing interoperability with plugins like FAVIROLL
1.5.2
Added support for setting category order
Author: Tanin
Tanin in an information technology consultant specializing in complex heterogeneous environments. He can be reached through multiple social networking sites including Twitter.
Unlike some other people I could mention, I will refrain from referring to myself in the third person. My name is Tanin Ehrami. You may know me from such plug-ins as 
Hi, Looks good… Can it be altered to call a specific category (or categories) in the blogroll? Something like this: [wp-blogroll (cat_ID='1,3')]
No, but it sounds like a nice feature to add to the next version.
Well, the newest version is out with category selection options!
AWESOMENESS! Works perfectly. Five Stars on WP Plugs for you
Is there anything I can do to make it work in Text widgets?
For text widgets add the following code to your template’s functions.php
add_filter(‘widget_text’, ‘do_shortcode’);
See this site for detailed instructions:
http://englishmike.net/2008/07/07/wordpress-quick-tips-3adding-a-shortcode-to-a-sidebar-widget/
You could also download the Sidebar Shortcodes plugin:
http://wordpress.org/extend/plugins/sidebar-shortcodes/
Thats great – thanks again! This seems to replace of 2 plugins I was using before.
I love this plugin – but I would love it even more if there was a possibility to show the link descriptions as text instead of a title-element.
Or is there a way to do that and I just didn’t find it?
I’ll think about it.
Newest version will be out in a few minutes with description selector!
wow, that was quick, thanks a lot
Hi, thanks for your lovely plugin – I like it very much.
On my site I tried to put some text before the linklist, but it allways shows after the list. What can I do to change this.
Thanks in advance
C. Michael Mette
Michael,
Sorry about that. Issue is resolved in 1.2.2. Will be available in a few minutes/hours.
Hi Tanin,
this was the fastest response I ever got! Thankx a lot!!!
No problem. Thanks for pointing out the bug.
Great plug-in. The only question I have is about spacing between the category header and the blogroll itself. The spacing is off and I cannot figure out how to fix it. Can you look at it and let me know how to fix it?
it’s the page link that says “inspiration”
Great plug-in. I’m using it on my page “inspiration” but the spacing is off. I’m not sure if it’s a setting issue or a css issue. I’m not sure how to fix it and would appreciate any help you could offer.
Thanks!
Tina
Add this to the end of your style.css
.linkcat h2 {margin: 1em 0;}
Love the plugin! Is there any way to change the order that the items display within the category?
Ordering delight in version 1.2.3
Just a question. I want to be able to assign a separate page for each category of links. That part I have no problem with. I do, however, have a problem with the category title appearing directly under the page name which is the same. Is there anything within the plugin code that I can tweak to remove that redundancy?
Babs, you can do one of two things:
1. Add the following string to the very start of the wp_list_bookmarks function
categorize=0&title_li= &or
2. Add the following string to your style.css :
.linkcat h2 {display:none}I would recommend using method 2. That way you don’t have to worry about the plugin being updated and your customization being reverted.
Thanks Tanin!
Because of this plugin, The Link-o-Rama lives again!
I tried to use your plugin on a template page. I just couldn’t get it to work. I used [wp-blogroll catname=flash] as code to use the plugin. Maybe that was wrong, can you tell me how to use your plugin in template files? Is it even possible?
I have been looking for a plug in like this for ages. This means I can now have a mini directory/links page on my blog, without having a site wide blogroll. Great. I think, now I have this plugin, there’s not much that WP can’t do in terms of full CMS capability. I used to use Joomla for larger web projects, but I’m thinking now that most elements can now be completely handled by Wordpress.
Toronto Real Estate Agent
Hi,
Thanks for the plugin. For some odd reason the plugin is not working for me. I have installed it and activated it. I put the code [wp-blogroll showdesc=1] in posts or pages but the same code shows on the page instead of the links. Can you tell me what I am missing. Many thanks
@ Real Madrid,
What version of Wordpress are you running? Also, try entering the code without the visual editor (select “html” instead of “visual” in the editor)
Great plugin. Any chance you could make a version that when showing a single category does not show the category name. Maybe it could be an option, otherwise it is the perfect plugin for me. Great work thanks.
@ esryl
You can do one of two things:
categorize=0&title_li= &(Space between “title_li=” and “&” is intentional)
or
.linkcat h2 {display:none}Just released version 1.3. It supports notitle=1 to hide category titles.
Example:
[wp-blogroll notitle=1]
I just found my favourite plugin developer ever
Thank you very very much for the update. Heres one step closer to the camera 
@ esryl
Thank you very much for the donation. (You’re first, btw). If you want to be listed on the (soon to be published) contributors page, include your website in your next comment and I’ll add you.
Tanin, thank you very much for this great plugin!
Q: Is there a way to limit the number of links being shown?
I have certain random links showing up on certain pages and want to limit how many appear.
1.3.1 will have limit tag support. (It’s being published as we speak.)
I think your plugin is super awesome, the best way to output links, all others suck and your built in CSS works perfect with all the WP 2.8 themes I use. Thanks
@Matt
Thanks. Glad you like it.
Thanks for this very good idea, works perfectly for me. Just one question: I’ve been trying to add links’ favicons, but it doesn’t seem to work with differents categories on different pages.
Is there a simple code line I could add, or could this be an option to your plugin one day?
The code at this time does not support favicons.
Great plugin (as others have mentioned)
Is there a way to have the category description show up under the Link Category name? If not, I can use the page name, and .linkcat h2 {display:none} but being able to do it through the parameters would be super awesome.
Tanin – thanks again for WP Render Blogroll Links! Sent you a little donation.
This option may get included in an upcoming version (still in development)
Thanks for the donation!
@Lynn
Versions 1.4.0 and later have the option for category description to be used under the category names.
Hi, thanks for the great plugin. but is there a way to add “nofollow” tags to links?
@hifa,
Good idea. I’ll add an option for that in the next release.
Just released version 1.5.0.
It supports forcing a relation to all links by using forcerel=relationship
Example:
[wp-blogroll forcerel=nofollow]Thank you very much for quick update with nofollow link
been looking for a plugin like this for ages and beautifully implemented too I might add. Thank You!
Thanks.
I followed the instructions but I’m receiving this message on the page itself
Fatal error: Call to undefined function: esc_url() in /home/content/……./wp-render-blogroll-links/WP-Render-Blogroll.php on line 39
Any suggestions?
What version of Wordpress are you using? I suspect that you are running on a version that’s older than 2.8. If so, please upgrade to the latest build.
Hi,
after upgrading to 2.8.3 the plug seems not work anymore
Hello Tannin,
Thanks for such a great plugin! I have a question… Is it possible not to apply list styles oble on the links page?
Thanks
Jens, I’m running the same combination on this site. Can you post the error you get on your site? also, check if the plugin re-activated after the upgrade!
Masya, do you can apply any style you want using your own CSS files. The plug-in only renders the xHTML.
I delted the site and made it new…after this all is working
Thank you for this!
greatscript.
it woult be great to have an attrib for hiding the catname (if i want to show only one cat)
thx, mat
… and maybe a attrib for a cat prefix…
to have category “Customers” printed as “> Customers” for example
thx
Matthias, I can’t promise anything on the category prefix thing, but if you want to show only one category without its title, try the following:
[wp-blogroll catid=39 notitle=1]
Replace 39 with the ID of the link category you want to show. The notitle=1 will make sure the category title remains hidden.
Hi,
Great plugin, thanks. is there any way to display the blogroll in a horizontal list instead of a Vertical list?
ie: 1,2,3
and not
1
2
3
Thanks
Ronny, I do the exact same thing on this site using CSS. The trick is to float the .linkcat li objects to left.
Hello Tanin,
I’m the developer of the FaviRoll plugin (http://wordpress.org/extend/plugins/faviroll/).
Some users ask me, if it’s possible to use the plugin with your plugin, too.
Yes, it is, but only, if the user remove the “//” in line 164 in WP-Render-Blogroll.php.
Do you see a possibilty thar the plugins may work together in a “official” way.
My idea is, that you spend your plugin an option button, or something like that.
regards
1.5.1 will have interoperability enabled by default.
I would recommend preserving the brlink class for people that use both plugins, but that’s up to you.
- Tanin
Ok, I’ll presve brlink class with my next update.
Thanks for your cooperation.
regards
Thanks a lot!
Tanin,
By far the easiest blogroll script available; awesome work!
Is it possible to change the order in which categories are displayed? (not the items inside the categories – I know this is already possible). Finally does this blogroll plugin display images (if an image is available inside ‘Add New Link’ > ‘Advanced’ section?
Thank you,
AJ
not as of this hour, but catorder and catorderby will be implemented in version 1.5.2
btw, images should already work.
Hi,
Great plugin! One thing I noticed…the plugin properly uses CSS for fonts in Firefox, but uses Courier New in IE? Is this something just on my site? Any idea how to fix this?
Awesome plugin! Using this already on our website.
Glad you like it.
- Tanin
@Adam,
The plugin doesn’t generate any CSS. It’s something in your site’s CSS that’s making it do that.
I’m impressed. Both with the plugin and your speedy reactions!
It would be great if it could include a possibilty to exclude categories. I have a long list, of which I need to exclude only 3 (instead of including 10).
@milly
soon..very soon…In 1.5.3….actually, it should be uploading to Wordpress.org as i’m typing this…
Works great, thank you
Great plug-in bro! fantastic
I am using this now [wp-blogroll showdesc=1 showbrk=1]
Tell me how can I get a space after each link and description?
Now it is all stuck together=
* British Philosophical Association
The British Philosophical Association (BPA) is the subject association for Philosophy as an academic discipline within Britain.
* Centre for Research in Modern European Philosophy, Middlesex University
The Centre for Research in Modern European Philosophy at Middlesex University is the leading centre for postgraduate level study and doctoral research in Continental Philosophy in the London area.
* University of Sussex, Philosophy department
Philosophy department of the University of Sussex
Thanks again
Cheers
PSG
@PSG You can adjust the space between the links using your template’s CSS file.
Try something like:
div.linkcat ul.blogroll li.brlink {margin-bottom:15px;}Hi there, congratulations on making such an effective plugin, it’s really great.
I’m wondering if it is possible to arrange lists of links into different columns? My links page displays 3 categories and I’d like to display them into 3 columns – one for each category. Is that possible? My php knowledge is not very good
Thanks again!
Thanks for making this, great plugin.
I’m trying to show both category descriptions and link descriptions, but having a problem. I’ve got…
[wp-blogroll showcatdesc=1 showdesc=1 showbrk=1]
If I try to put showcatdesc=1 at the end, the line breaks don’t work. Just wondering if the two don’t work together or have I done something wrong? If the two don’t work together, can they in a future release? Thanks!
@Dawn,
That should work just fine (I just tested the very string you posted). Can you link me to your blog so I can take a look at the code?
- Tanin
@mydancetheskull,
you may want to try putting something like this in your template’s CSS file:
div.linkcat {float:left;width:30%;clear:none;padding:0 10px;}
Hey Tanin,
Your plugin does *exactly* what I was looking for, and it’s incredibly easy. However, it’s generating a wide, blank horizontal box at the top of my Links page that I’d like to delete, and like ‘Adam’ said above, everything is coming out in Courier New. I’ve looked up and down my Stylesheet.CSS and every other file I can find and I cannot locate any language that seems to control the fonts of the blogroll or .linkcat, etc. Any suggestions on what I should be looking for? Thx!
@pop,
The box is there because you put the shortcode in a code tag. Look at your page in html mode and edit the code out.
That fixed both problems at once– man, I read up above from some others that you were fast, but you are THE MAN. 5 stars from me, thx!
Hi
This is a great plugin, I have images in my links is there any way I can
a)put the name of the link under the picture
b)have three links/pictures on one line instead of under each other.
Many Thanks
Lee
@Lee, can you provide a link to your blog/site? I can probably tell you what CSS code that will do that for you.
Hi, I have a problem of having the next category’s name displaying on the same line as the last category’s links. How could I fix this?
And is there a way to make each link’s box area wider?
Thanks.
Hi sry to ask you one more question. I tried to display two different categories on the same page by inserting two seperate statements:
[wp-blogroll catid=1]
[wp-blogroll catid=2]
But it appears that the title of the catid=2 displayed on the center of the page instead of the left. How could we fix that?
Thanks
Felix, you can also write
[wp-blogroll catid=1] [wp-blogroll catid=2]
as
[wp-blogroll catid=1,2]
It seems all your issues are CSS related. Can you provide a link so that I can take a look?
Hi, your plugin really rocks!!!
I now have a title + description on my page. But I want to add images. So I added the image location. But when I do that and refresh the page the title disappears?!?!?
Can I use a image + title + description?
Stefan
Stefan,
I found out what the problem is. It’s actually a “feature” that was brought in with an older version of a function.
The next version of the plugin will have a parameter that will allow you to always show titles.
- Tanin
@Tanin – thanks, I realized it was outputting the code correctly, just wasn’t visible because of my CSS.
Absolutely wonderful plugin! Definitely the best as yet!
However, I would like to have the choice of including some selection logic. Like e.g.:
**[wp-blogroll catname=News,Stockholm,Today logic=and]
such that only the links that fulfill all the stated categories are shown with the “and” logic.
If logic is “or” all links within the three categories would be shown, although only once.
Is it feasible?
Best regards
Michael
@Michael,
Thanks. Our team of crack programmers is looking into this feature request as I type.
I’d likethis plugin so much
the blogroll links ( banners ) sorts under each other such as that
http://www.stylisheve.com/blogroll
How can i sort it beside each other
and put 6 links (banners ) in each raw
Marwa, if seems you have de-activated the plugin. To get the items next to each other I would suggest using CSS to float the objects to the left. I do the same thing on this site.
try something like this:
.linkcat {clear:both}
.brlink {float:left; width:200px}
I'm excited to get this working! Seems it would be of great value to me. But I'm having a problem getting it to work. I installed it and activated it. Then I added
<?php [wp-blogroll] ?> to a page. that results in the following error:
Parse error: syntax error, unexpected '[' in /home/bh/public_html/news/wp-content/themes/bh/in-the-news.php on line 20 (the line [wp-blogroll] is on).
Have I misunderstood how to instantiate the plugin on a page?
thanks!
@Ron,
You're supposed to create a new post or page on your blog/site and enter [wp-blogroll] in your blog/page content.
Thanks for your reply! Actually, the reason I put the tag inside php is because, when I just put the tag in, say, a
, it just renders as text. Since trying your plug in, I've tried a couple others that have the square-bracket-style tag and tags within comment code, and nothing is showing up for me, even after verifying that the plugins are installed and activated. I'm fairly new at this, and I'm absolutely sure there is something I'm missing. For instance, I have a suspicion that I'm supposed to precede the tag with a PHP query_posts() function. I wish I knew.
Thanks for responding tho. I'll trying filling in the gap in my knowledge with more digging around until I happen upon the missing link.
Ah! One little element I didn't understand: placing a bracketed or comment tag *in a post* as part of the text *vs.* in a _template_. I've been trying to put these in templates!
@Ron
Yeah, this plug-in was specifically written so you wouldn't have to change templates.
Tanin, Thanks for the plugin – I think it will do what I was hoping. I didn't understand the readme though, as far as how to change the CSS so that the fonts match the rest of my site. I'm sure it's something simple, but I'm just not getting it. Out-of-the-box, it matches the colors on my site, but I'm getting a Courier style font, instead of the Arial used everywhere else on my site. Any ideas what I'm doing wrong? Thanks!
thank you so much – i really like this plugin. Is there any way to have this work with one of the feed reading blogroll plugins – I would like this to display the most recent post next to the link?
@Bill, the reademe implies that if you want to change the way the links show up, you edit your theme's CSS. There are a number of comments on this page that can help you out on how to do that.
@Lindsay, the plugin does allow for authors of other plugins to hook into its functions. For example the FaviRoll plugin by grobator hooks into this plugin to show icons next to the links. You could ask the author of the plugin that allows recent posts to show up to hook into this plugin so that the functionality becomes available to you. Hope that answers your question.
Hi Tanin,
First of all can I say thank you so much for such a wonderful plugin. I have spent many weeks looking for this – I really cant thank you enough. :]
Question :
Is there a way to display a second, third, fourth..etc page for limited links?
So just like with posts there would be a link to the next page once that category of links have reached their limit?
I may have already missed the solution within your FAQ so feel free to slap me if I have…sorry!
Also I have asked on some forums and people continue to tell me to use the do_shortcode function. Unfortunately I am not that advanced with PHP to know how to implement this.
Many thanks in advance.
I’m afraid adding server-side pagination for links isn’t possible without drastically re-designing the way Wordpress returns bookmarks.
As for the dp_shortcode, it’s the following snippet:
add_filter(‘widget_text’, ‘do_shortcode’);
See this site for detailed instructions:
http://englishmike.net/2008/07/07/wordpress-quick-tips-3adding-a-shortcode-to-a-sidebar-widget/
You could also download the Sidebar Shortcodes plugin:
http://wordpress.org/extend/plugins/sidebar-shortcodes/
Have tried to go through all the documentation carefully, saw a couple of requests for the following, but no response?
I created a "links" page in the theme template.
I added:
<?php
/*
Template Name: BlogRollLinks
*/
?>
<?php get_header(); ?>
<div id="wp-blogroll">
<h2>Recommended Links:</h2>
<ul class="wp-blogroll">
<?php wp-blogroll(); ?>
</div>
<?php get_footer(); ?>
But get error in line 10…
@George,
This plugin was written specifically so you wouldn’t have to change or create new templates. Creating a links “Page” means just going to Pages in your Wordpress administrative panel and click on “Add New” in the menu. Add the shortcode as documented in the readme.txt
This is such a great plugin. Is there a shortcode to use it to display the rss of a link? A list of possible shortcodes would be very helpful.
Many thanks
@fff, showing the RSS of a link is currently not possible, but how would you want it to look like if it were? Also, for a full list of the current options, please read the FAQ http://wordpress.org/extend/plugins/wp-render-blo...
Thanks for your reply. In an ideal world we would have the option of:
the standard rss icon as a link to subscribe,
a simple css-stylable text list of the rss articles,
and something very fancy, like a popup displaying the whole of the top, say, 5 feed results
But just having the first option would be nice.
The original goal of this plugin was to give users an easy way of creating an interface for their stored Links. The first suggestion shouldn’t be a problem. It could be done pretty quickly. But building in intelligence that would read the RSS feed and display its contents would be extending the functionality of this plugin beyond its originally intended scope and goals. What I will do is try to build capabilities in the plugin that would allow 3rd party developers to extend their existing RSS reading plugins to communicate and interact with this plugin. This would essentially allow reading content from the RSS feeds that are defined for links.
You are wonderful, thank you!
Can you make an option to show dates of when the links were added?
Hi there,
WONDERFUL plug in, does everything I need, and with great ease of use.
I was curious if you had plans on making collapsible categories in a future edition? I don't have enough links to necessitate just yet, but I am thinking of implementing a separate page of links for beading resources on my site.
Thanks so much for all your hard work.
Melissa, pugbeads.com
@Melissa. Category collapsibility may actually be useful in future releases, so be on the look-out for that.
Love the plugin!
1. Is there a way to order the categories other than by name or id? I have 10 categories and 2 of those I would like to force to show up at the end of the list. Right now, they just show up alphabetically and the 2 id category numbers are out of sequence.
2. How do I set an anchor to a category name?
@Jackson
1. You could create 2 wp-blogroll tags and use the catids to set them apart making the first block the one you want to highlight.
Example:
[wp-blogroll catid=4,5,6]
[wp-blogroll catid=1,2,3,7,8,8]
2. If you can convince me why category names need anchors, I'll write in an option in the next release to make it happen.
After working with it a little further, I discovered I need to make all the categories separate wp-blogroll tags. This lets me:
a – put them in the order that I want them
b – add the anchor text for each category in between
I think adding anchors to the category names would be good because in most cases, or at least in *my* case, I have a huge list of links for each category. If someone is only interested in the last category at the bottom of the list, I want to have an "anchor list" at the top of my page that will send them down to the proper category – so they don't have to scroll, and scroll, and scroll…
When setting this up with several wp-blogroll tags, it puts a huge amount of space before each category name. How can one get rid of that?
So sorry such a long explanation…thanks for your help.
@jackson,
Most spaces like that are created by CSS margins and paddings. Can you send me a link to your site?
How can I send you a message through here?
I think I fixed the spacing problem. In the HTML tab of the post box, I had hit enter after every line of wp-blogroll tags. This seemed to put a
after each tag. Once I ran it all together, the spaces were gone. I had 19 categories being displayed with 19 wp-blogroll tags.
I manually inserted the anchor names so that my list at the top would jump down to the proper category. It works great, thanks again for a great plugin Tanin!
@Jackson,
glad things worked out for you.
I have been using the plug-in successfully for sometime, but it recently stopped working. I am not sure if is result of an upgrade (WP 2.9.2) or interference from another plug-in. I went through and disabled virtually all my plug-in’s but no luck. Removed WP Render and re-installed. When I disable WP Render the links page displays [wp-blogroll catid=89 notitle=1] — so it appears that it is doing something when enabled, but I am not seeing anything in that category (or others that are configured).
Any ideas?
Hmm..weird. Can you check and see if the categories have new IDs since the upgrade?
Hi awesome plug in…just wondering…are there any template tags to use ? or just to post to pages or posts?
Thanks!!!
@Adam, you can call the plugin’s functions from within templates (in PHP), but that’s not really what this plugin was made for. For example, instead of writing this:
[wp-blogroll catid=39,37] (in a page or post)
you’d have to write something like this in the template code:
renderlinks_tc_hnd(array(‘catid’=>’39,37′),null);
Any luck with changing the category ID's ?