WP Render Blogroll Links

Link classnames can be set using the linkclass parameter. Example:

• Set the classname for links to blue:
• [wp-blogroll linkclass=blue]

To specify one or more categories of links, add the catid or catname parameter to the tag. Examples:

• For all links in the "News" category:
• [wp-blogroll catname=News]

• For all links in the "Social Media" category:
• [wp-blogroll catname="Social Media"]
• For all links in the category ID 39:
• [wp-blogroll catid=39]
• For all links in categories 39 and 37:
• [wp-blogroll catid=39,37]

You can remove category titles by adding the notitle parameter to the tag. Examples:

• For all links in all categories but no titles:
• [wp-blogroll notitle=1]
• For all links in all categories with descriptions next to them but no titles:
• [wp-blogroll showdesc=1 notitle=1]

To do this simply add showdesc=1 to the tag. You may also want to use the showbrk=1 parameter to indicate you want a line break between the link and its description. Examples:

• For all links with descriptions next to them:
• [wp-blogroll showdesc=1]
• For all links in category 39 with descriptions next to them:
• [wp-blogroll catid=39 showdesc=1]
• For all links with descriptions under them:
• [wp-blogroll showdesc=1 showbrk=1]

You can limit the number of links shown (per category) by adding limit=x to the tag where "x" is the number of items you wish to show. Examples:

• Show 1 link per category:
• [wp-blogroll limit=1]
• Show a maximum of 20 links per category:
• [wp-blogroll limit=20]
• Show a maximum of 3 links per category ordered by name in ascending order:
• [wp-blogroll limit=2 orderby=name order=ASC]

Yes. From version 1.2.3 onward, the plugin supports order and orderby parameters. orderby String Value. Defaults is 'name'. Valid options:

• id
• url
• name
• target
• description
• owner - User who added bookmark through bookmarks Manager.
• rating
• updated
• rel - bookmark relationship (XFN).
• notes
• rss
• length - The length of the bookmark name, shortest to longest.
• rand - Display bookmarks in random order.

• ASC
• DESC

• For all links ordered by name in descending order:
• [wp-blogroll orderby=name order=DESC]

Yes. From version 1.5.2 onward, the plugin supports the catorder and catorderby parameters. catorderby By default the categories are ordered by 'name'. Valid options:

• id
• name (Default)
• slug
• term_group (untested)

• ASC
• DESC

• Order categories by name descending:
• [wp-blogroll catorderby=name catorder=DESC]
• Order categories by number of links ascending:
• [wp-blogroll catorderby=count catorder=ASC]

Yes. From version 1.4.0 onward, category descriptions can be shown under the titles using the showcatdesc=1 parameter. Example:

• Show category descriptions under titles:
• [wp-blogroll showcatdesc=1]

Yes. From version 1.5.3 onward, categories can be excluded using the excludecat parameter. Example:

• Show all category of links but not the category with ID 34:
• [wp-blogroll excludecat=34]
• Show all category of links but not the categories with ID 34 and 35:
• [wp-blogroll excludecat=34,35]

Yes. From version 1.5.0 onward, links can be forced to have any rel you want no matter what they originally were set to. Example:

• Show all links while forcing all links to have rel="external":
• [wp-blogroll forcerel=external]
• Show all links while forcing all links to have rel="nofollow external":
• [wp-blogroll forcerel="nofollow external"]

To do this, version 1.6.0 introduced the always_show_names=1 and show_names_under_images=1 parameters. The always_show_names=1 parameter makes sure that the names of the links show up even if you're using images. The show_names_under_images=1 parameter can be used along with always_show_names=1 to put the link names under the link images rather than next to them. Example:

• Show the names of the links that have images next to their images:
• [wp-blogroll always_show_names=1]
• Show the names of the links that have images under their images:
• [wp-blogroll always_show_names=1 show_names_under_images=1]

Example:

• Don't show any images even if some of my links have images because I was too lazy to remove them manually:
• [wp-blogroll show_images=0]

From version 1.7.0 onward, the RSS feeds of websites you're linking to can be shown using the show_rss parameter. A small icon will appear next to the link indicating an RSS feed that can be subscribed to. Example:

• Render a link to the RSS feeds of sites that have RSS feeds defined:
• [wp-blogroll show_rss=1]

In combination with the show_rss parameter, the rss_image parameter can be used to indicate a custom icon for the RSS links. You must upload the image and link to it using a relative path. Example:

• Render a link to the RSS feeds of sites that have RSS feeds defined with a custom icon:
• [wp-blogroll show_rss=1 rss_image=/wp-includes/images/wlw/wp-icon.png]

Yes. Simply add the livelinks=1 parameter and the Live Blogroll plugin will attempt to get the latest updates from the sites. Example:

• Add Live Blogroll support to links:
• [wp-blogroll livelinks=1]

• Option 1: Open WP-Render-Blogroll.php in your favorite editor an joyfully customize away! Your changes will be lost the next time you update.
• Option 2: Go to the plugin's page and contact the author.

• To send donations go to Settings -> WP Blogroll Links. There's a donate box you can use to thank us as much as you would like :)