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”.
WP Render Blogroll Links works using a “shortcode”. Shortcodes are snippets of pseudo code that are placed in blog posts, pages and on some forums to easily render HTML output.
The following is the basic form of a shortcode:
[shortcodename]
To facilitate customization of shortcodes, parameters are used. Shortcode parameters are entered in the following format:
[shortcodename parametername=parametervalue]
The “wp-blogroll” shortcode including an example parameter called “catname” looks like this:
[wp-blogroll catname=News]
Below is a list of all the supported parameters and their functions.
| Parameter name | Parameter options | Description |
|---|---|---|
| always_show_names | 0 or 1 (Default:0) | This option when set to 1 will show link titles even if the link has an image defined. |
| catid | ID(s) | Use this parameter to specify what categories should be shown by category ID. For example [wp-blogroll catid=12] |
| catname | Name(s) | Use this parameter to specify what categories should be shown by name. For example [wp-blogroll catname=News]. If the catname has spaces, simply wrap the name in quotes. Example: [wp-blogroll catname="Social Media"] |
| catorder | ASC, DESC (Default: ASC) | Indicates the category sort direction in ascending or descending. |
| catorderby | id, name, count, slug or term_group (Default:name) | This indicates in what order the categories should be ordered by. |
| excludecat | ID of a link category | This will exclude the set categories from displaying their links. Multiple values may be entered separated by comma (,). Example: [wp-blogroll excludecat=34,35] |
| forcerel | Relationship (Default:blank) | Forces a relationship tag on all links. For example rel=”external” can be achieved using [wp-blogroll forcerel=external] |
| limit | n | Limits the number of links displayed per category. For example, to show a maximum of 20 links per category, use [wp-blogroll limit=20] |
| notitle | 0 or 1 (Default:0) | This removes categorization and as a result removes the category titles |
| order | ASC, DESC (Default: DESC) | Indicates the link sort direction in ascending or descending. |
| orderby | id, url, name, target, description, owner, rating, updated, rel, notes, rss, length, rand | This indicates in what order the links displayed should be ordered by. |
| rss_image | Relative path. Default is ‘/wp-includes/images/rss.png’ | A relative path the icon that is to be used as RSS link for links. For example: /wp-includes/images/wlw/wp-icon.png |
| show_images | 0 or 1 (Default:1) | By default links that have images defined will display them. To disable this, select 0 as the value. |
| show_names_under_images | 0 or 1 (Default:0) | In combination with the always_show_names parameter, this option puts the titles of the links with images, under their images by adding a BR tag. |
| show_rss | 0 or 1 (Default:0) | Indicates whether links that have RSS feeds associated with them should show them. |
| showdash | 0 or 1 (Default:0) | This indicate you want a dash ( – ) between the link and its description. (This will also add a space before and after the dash.) |
| showbrk | 0 or 1 (Default:0) | This indicate you want a line break between the link and its description. |
| showcatdesc | 0 or 1 (Default:0) | Use this parameter to show the description set for each category. |
| showdesc | 0 or 1 (Default:0) | Use this parameter to show the description set for each link. |
| showhide | 0 or 1 (Default:0) | Indicates whether the links should remain hidden until the category is clicked on. |
To get your desired result, you are also free to use (almost) any combination of the parameters.
Example:
[wp-blogroll limit=2 orderby=name order=ASC excludecat=4,5]
All proceeds go to Tanin’s DSLR Camera Foundation help keep this website online.