Add RSS Feed Link Icons to WordPress Category Listings
by Jeff Starr on Monday, November 20, 2006 – 11 Responses
This brief tutorial explains two methods for adding RSS feed link icons to category listings. Let’s say that you have a list of category links, where each link targets a specific category view. Now let’s say that, next to each category link, you would like to provide a icon that links to that particular category’s syndicated feed. So, rather than cluttering up your page with two sets of category links — one for category views and another for category feeds — consolidate links and simplify your site by providing both sets of links in a logical, streamlined format.
Method One: A Static Category/Category-Feed List via wp_list_cats
Category Links via "wp_list_cats" The easiest way to create a set of category/category-feed links is to use the native WordPress function, wp_list_cats. This function creates a customizable set of static category links that may be used in or out of the WordPress loop.
Category links created this way are static in that the same categories are displayed for every type of page view. Thus, if configured to display categories "A", "B", and "C", the wp_list_cats function will create links for A, B, and C for post views, page views, archive views, category views, and every other view-type for that matter.
Nonetheless, despite this limitation, wp_list_cats provides an easy way to create a category feed icon links next their respective category links. Simply add the following to the location of your choice within your WP-powered document:
<?php wp_list_cats('feed_image=http://domain.com/path/feed-icon.gif&feed=XML Feed&optioncount=1&children=0'); ?>In this code example, we are using the following parameters:
feed_image=http://domain.com/path/feed-icon.gif- This parameter creates the feed icon link next to each category link. Change the domain, path, and file name according to your particular setup.
feed=XML Feed- This parameter produces the requisite
alt&titleattributes for the specified feed icon (if any), and also producestitleattributes for link anchor tags. optioncount=1- This parameter indicates whether or not the function writes the category post count next to the link. "1" = yes, please display category post counts, "2" = no, please do not display post counts.
children=0- This parameter instructs the function to include or exclude subcategories in the set of category links. "1" = yes, please show all subcategories, "2" = no, please omit any subcategories from the category list.
This function also provides several handy parameters that are not discussed here. Please see the WordPress Codex1 for complete information concerning wp_list_cats.
Method Two: A Dynamic Category/Feed List via Category LiveBookmarks
A more sophisticated, comprehensive method of providing users with category/feed links is delivered via Monzilla Media’s essential plugin, Category LiveBookmarks Plus 2. Category LiveBookmarks Plus (CLB+) automatically produces a highly customizable set of dynamic category/feed links anywhere within your WP-powered blog. Plus, in addition to creating a custom set of feed links, CLB+ also creates contextually relevant LiveBookmark autodiscovery feed links to the head element of your document (see plugin page for more details). Here are a few examples of the different format options available via CLB+:
Left-aligned feed links
Text-based feed links
Right-aligned feed links
Of course, more configurations are possible, as well as many other customizable settings that enable users to create an ideal set of dynamically changing feed links throughout your site. Simply install the plugin and change the settings within the plugin file to customize your own set of category/feed links. Further, the CLB+ plugin creates a dynamic set of category/feed links that changes according to page view-type in order to provide only relevant feeds, as referenced via the particular page contents.
Regardless of which method you use, consolidating your category links with your category feed links will reduce clutter, streamline navigation, and promote simplicity. Thanks for listening — God Bless!
Focused on clean code and quality content, Perishable Press is the online home of Jeff Starr, author, artist, designer, developer, and all-around swell guy. 
11 Responses
August Klotz – #1
Perishable,
Is it possible to display the post counts for each category using the CLB+ plugin (as displayed using
wp_list_cats)?Perishable – #2
August,
Yes, of course, there are settings to display the number of posts in each category for any of the various category/feed link configurations.
altoyes – #3
hi folks
thankyou for this - iam using method one -it works well for me.
one thing i cant work out how to place the image alt within your code - which is required to keep xhtml valid code.
see below my validation error.
alto
« [ edit: removed validation error ] »
Perishable – #4
alto,
We have updated the article with some fresh information that will solve your problem. Read the first method once more and look for the new "feed=" attribute. We have used it in the past and it works like a charm — 100% strict XHTML validation and everything!
mc – #5
Hi
I’m using method one, but the rss image appears beneath the category instead of next to it.
Any ideas on how to solve this problem?
Perishable – #6
hmm, interesting..
it would help to see a live occurrence of the situation. could you provide a link to an example? i would be more than happy to help!
mc – #7
Thanks. I have implemented it now on my homepage so you can have a look there.
I’m not very familiar with coding, but the only place I could find in my implementation where wp_list_cats is used, is in the widgets.php file, which is where I replaced the code. But as you can see on my site, the icons and number of categories appear beneath, instead of next to the category name.
Thanks
Perishable – #8
aha!
wp_list_cats()is deprecated as of WordPress 2.1. Try replacingwp_list_cats()withwp_list_categories()and let me know how it goes..mc – #9
hi. I’ve made the change. The only difference now is that the category names are indented, but icons still beneath. The number of post per category doesn’t display anymore, which is correct - I deselected the show # posts option.
Could it me something with the style sheet or the fact that it’s a fluid?
Thx
Perishable – #10
Yes, it is probably CSS-related. It appears that somehow the anchor (
<a>) elements are being displayed with CSSblockattributes, which will cause any element to “break” the flow of the line (unless other rules are applied). I would try targeting the links in that section (and perhaps images as well, for that matter) via CSS and apply either of the following properties:display: inline;(or)
float: left; clear: none;That should definitely do the trick..
mc – #11
Many thanks for your assistance.
I’ll have a look.