{"id":48053,"date":"2009-04-23T09:17:01","date_gmt":"2009-04-23T09:17:01","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/wp-render-blogroll-links\/"},"modified":"2011-01-15T15:10:07","modified_gmt":"2011-01-15T15:10:07","slug":"wp-render-blogroll-links","status":"closed","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/wp-render-blogroll-links\/","author":595987,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.1.8","stable_tag":"trunk","tested":"3.0.5","requires":"2.8","requires_php":"","requires_plugins":"","header_name":"WP Render Blogroll Links","header_author":"Tanin Ehrami","header_description":"","assets_banners_color":"","last_updated":"2017-11-28 20:17:55","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_s-xclick&hosted_button_id=6331357","header_plugin_uri":"http:\/\/0xtc.com\/2009\/04\/22\/wp-render-blogroll-links-plugin.xhtml","header_author_uri":"http:\/\/0xtc.com\/","rating":5,"author_block_rating":0,"active_installs":900,"downloads":69168,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"1"},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.1.0","1.2.0","1.2.1","1.2.2","1.2.3","1.2.4","1.3","1.3.1","1.4.0","1.5.0","1.5.1","1.5.2","1.5.3","1.6.0","1.7.0","2.0.1","2.1.2","2.1.5"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[2657,495,175,170,975],"plugin_category":[43,56],"plugin_contributors":[79777],"plugin_business_model":[],"class_list":["post-48053","plugin","type-plugin","status-closed","hentry","plugin_tags-blogroll","plugin_tags-bookmarks","plugin_tags-links","plugin_tags-page","plugin_tags-template","plugin_category-customization","plugin_category-social-and-sharing","plugin_contributors-0xtc","plugin_committers-0xtc"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/wp-render-blogroll-links.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>Outputs your Blogroll links to a Page or Post. Add <strong><code>[wp-blogroll]<\/code><\/strong> 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.<\/p>\n\n<p>Check the Frequently Asked Questions for detailed usage instructions.<\/p>\n\n<p>The output can easily be styled with CSS. Each category with its links is encapsulated in a DIV  with a classname called <strong><code>\"linkcat\"<\/code><\/strong>. All the links are attributed with the class <strong><code>\"brlink\"<\/code><\/strong>.<\/p>\n\n<p><strong>Additional features:<\/strong><\/p>\n\n<ul>\n<li>Order links the way you like them<\/li>\n<li>Order link categories the way you like them<\/li>\n<li>Can create selection of individual categories by name or ID(s).<\/li>\n<li>Show descriptions of the links next or under them.<\/li>\n<li>Show category descriptions under category titles.<\/li>\n<li>Hide category titles.<\/li>\n<li>Option to remove titles from categories\n.<\/li>\n<li>Option to force nofollow, external or any other relationship (rel) to your links.<\/li>\n<\/ul>\n\n<p>For advanced usage instructions please read the FAQ.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload\/extract the <code>WP-Render-Blogroll<\/code> folder to your <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Place <code>[wp-blogroll]<\/code> in the post or page you want to use for links.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt>Installation Instructions<\/dt>\n<dd><ol>\n<li>Upload\/extract the <code>WP-Render-Blogroll<\/code> folder to your <code>\/wp-content\/plugins\/<\/code> directory.<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress.<\/li>\n<li>Place <code>[wp-blogroll]<\/code> in the post or page you want to use for links.<\/li>\n<\/ol><\/dd>\n<dt>How can I set the classname of the links?<\/dt>\n<dd><p>Link classnames can be set using the <strong><code>linkclass<\/code><\/strong> parameter.<\/p>\n\n<p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li>Set the classname for links to <strong><code>blue<\/code><\/strong>:\n\n<ul>\n<li><strong><code>[wp-blogroll linkclass=blue]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>Can it be altered to call a specific category (or categories) in the blogroll?<\/dt>\n<dd><p>To specify one or more categories of links, add the <strong><code>catid<\/code><\/strong> or <strong><code>catname<\/code><\/strong> parameter to the tag.<\/p>\n\n<p><strong>Examples:<\/strong><\/p>\n\n<ul>\n<li>For all links in the \"News\" category:\n\n<ul>\n<li><strong><code>[wp-blogroll catname=News]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul>\n\n<p>If your category name has a space in it, simply wrap the name in quotes:<\/p>\n\n<ul>\n<li><p>For all links in the \"Social Media\" category:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll catname=\"Social Media\"]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>For all links in the category ID 39:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll catid=39]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>For all links in categories 39 and 37:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll catid=39,37]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul>\n\n<p>PS: It is not advisable to use both catid and catname simultaneously.<\/p><\/dd>\n<dt>I don't like category titles. How can I remove them?<\/dt>\n<dd><p>You can remove category titles by adding the <strong><code>notitle<\/code><\/strong> parameter to the tag.<\/p>\n\n<p><strong>Examples:<\/strong><\/p>\n\n<ul>\n<li><p>For all links in all categories but no titles:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll notitle=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>For all links in all categories with descriptions next to them <strong>but no titles<\/strong>:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll showdesc=1 notitle=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>Is it possible to show link descriptions as text rather than just title attributes?<\/dt>\n<dd><p>To do this simply add <strong><code>showdesc=1<\/code><\/strong> to the tag. You may also want to use the <strong><code>showbrk=1<\/code><\/strong> parameter to indicate you want a line break between the link and its description.<\/p>\n\n<p><strong>Examples:<\/strong><\/p>\n\n<ul>\n<li><p>For all links with descriptions next to them:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll showdesc=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>For all links in category 39 with descriptions <strong>next to<\/strong> them:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll catid=39 showdesc=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>For all links with descriptions <strong>under them<\/strong>:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll showdesc=1 showbrk=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>Is there a way to limit the number of links being shown?<\/dt>\n<dd><p>You can limit the number of links shown (per category) by adding <strong><code>limit=x<\/code><\/strong> to the tag where \"x\" is the number of items you wish to show.<\/p>\n\n<p><strong>Examples:<\/strong><\/p>\n\n<ul>\n<li><p>Show 1 link per category:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll limit=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>Show a maximum of 20 links per category:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll limit=20]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>Show a maximum of 3 links per category ordered by name in ascending order:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll limit=2 orderby=name order=ASC]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>Is there any way to change the order that the items display within the category?<\/dt>\n<dd><p>Yes.<\/p>\n\n<p>From version 1.2.3 onward, the plugin supports <strong><code>order<\/code><\/strong> and <strong><code>orderby<\/code><\/strong> parameters.<\/p>\n\n<p><strong><code>orderby<\/code><\/strong><\/p>\n\n<p>String Value. Defaults is 'name'.<\/p>\n\n<p>Valid options:<\/p>\n\n<ul>\n<li><code>id<\/code><\/li>\n<li><code>url<\/code><\/li>\n<li><code>name<\/code><\/li>\n<li><code>target<\/code><\/li>\n<li><code>description<\/code><\/li>\n<li><code>owner<\/code> - <em>User who added bookmark through bookmarks Manager.<\/em><\/li>\n<li><code>rating<\/code><\/li>\n<li><code>updated<\/code><\/li>\n<li><code>rel<\/code> - <em>bookmark relationship (XFN).<\/em><\/li>\n<li><code>notes<\/code><\/li>\n<li><code>rss<\/code><\/li>\n<li><code>length<\/code> - <em>The length of the bookmark name, shortest to longest.<\/em><\/li>\n<li><code>rand<\/code> - <em>Display bookmarks in random order.<\/em><\/li>\n<\/ul>\n\n<p><strong><code>order<\/code><\/strong><\/p>\n\n<p>String value. Default is ASC. Sets ascending or descending order for the orderby parameter.<\/p>\n\n<p>Valid values:<\/p>\n\n<ul>\n<li><code>ASC<\/code><\/li>\n<li><code>DESC<\/code><\/li>\n<\/ul>\n\n<p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li>For all links ordered by name in descending order:\n\n<ul>\n<li><strong><code>[wp-blogroll orderby=name order=DESC]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>Is there a way to change the order of the categories as they appear?<\/dt>\n<dd><p>Yes.<\/p>\n\n<p>From version 1.5.2 onward, the plugin supports the <strong><code>catorder<\/code><\/strong> and <strong><code>catorderby<\/code><\/strong> parameters.<\/p>\n\n<p><strong><code>catorderby<\/code><\/strong><\/p>\n\n<p>By default the categories are ordered by 'name'.<\/p>\n\n<p>Valid options:<\/p>\n\n<ul>\n<li><code>id<\/code><\/li>\n<li><code>name<\/code> (Default)<\/li>\n<li><code>slug<\/code><\/li>\n<li><code>term_group<\/code> (untested)<\/li>\n<\/ul>\n\n<p><strong><code>catorder<\/code><\/strong><\/p>\n\n<p>String value. Default is ASC. Sets ascending or descending order for the catorderby parameter.<\/p>\n\n<p>Valid values:<\/p>\n\n<ul>\n<li><code>ASC<\/code><\/li>\n<li><code>DESC<\/code><\/li>\n<\/ul>\n\n<p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li><p>Order categories by name descending:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll catorderby=name catorder=DESC]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>Order categories by number of links ascending:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll catorderby=count catorder=ASC]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>Is it possible to show the descriptions of the categories under their names?<\/dt>\n<dd><p>Yes.<\/p>\n\n<p>From version 1.4.0 onward, category descriptions can be shown under the titles using the <strong><code>showcatdesc=1<\/code><\/strong> parameter.<\/p>\n\n<p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li>Show category descriptions under titles:\n\n<ul>\n<li><strong><code>[wp-blogroll showcatdesc=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>Is it possible to exclude categories?<\/dt>\n<dd><p>Yes.<\/p>\n\n<p>From version 1.5.3 onward, categories can be excluded using the <strong><code>excludecat<\/code><\/strong> parameter.<\/p>\n\n<p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li><p>Show all category of links but not the category with ID 34:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll excludecat=34]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>Show all category of links but not the categories with ID 34 and 35:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll excludecat=34,35]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>Is there a way to force rel=\"nofollow\" attributes to links?<\/dt>\n<dd><p>Yes.<\/p>\n\n<p>From version 1.5.0 onward, links can be forced to have any <strong><code>rel<\/code><\/strong> you want no matter what they originally were set to.<\/p>\n\n<p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li><p>Show all links while forcing all links to have <strong><code>rel=\"external\"<\/code><\/strong>:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll forcerel=external]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>Show all links while forcing all links to have <strong><code>rel=\"nofollow external\"<\/code><\/strong>:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll forcerel=\"nofollow external\"]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>My links have images, but I also want to show their titles\/names<\/dt>\n<dd><p>To do this, version 1.6.0 introduced the <code>always_show_names=1<\/code> and <code>show_names_under_images=1<\/code> parameters.<\/p>\n\n<p>The <code>always_show_names=1<\/code> parameter makes sure that the names of the links show up even if you're using images.<\/p>\n\n<p>The <code>show_names_under_images=1<\/code> parameter can be used along with <code>always_show_names=1<\/code> to put the link names under the link images rather than next to them.<\/p>\n\n<p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li><p>Show the names of the links that have images next to their images:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll always_show_names=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<li><p>Show the names of the links that have images under their images:<\/p>\n\n<ul>\n<li><strong><code>[wp-blogroll always_show_names=1 show_names_under_images=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>Some of my links have images, but I'm too lazy to remove them manually. How do I hide the images and just show the link names?<\/dt>\n<dd><p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li>Don't show any images even if some of my links have images because I was too lazy to remove them manually:\n\n<ul>\n<li><strong><code>[wp-blogroll show_images=0]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>How do I make a link to the RSS feed of a url?<\/dt>\n<dd><p>From version 1.7.0 onward, the RSS feeds of websites you're linking to can be shown using the <strong><code>show_rss<\/code><\/strong> parameter. A small icon will appear next to the link indicating an RSS feed that can be subscribed to.<\/p>\n\n<p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li>Render a link to the RSS feeds of sites that have RSS feeds defined:\n\n<ul>\n<li><strong><code>[wp-blogroll show_rss=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>The default RSS icon: How do I change it?<\/dt>\n<dd><p>In combination with the <strong><code>show_rss<\/code><\/strong> parameter, the <strong><code>rss_image<\/code><\/strong> 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.<\/p>\n\n<p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li>Render a link to the RSS feeds of sites that have RSS feeds defined with a custom icon:\n\n<ul>\n<li><strong><code>[wp-blogroll show_rss=1 rss_image=\/wp-includes\/images\/wlw\/wp-icon.png]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>Can I make this plugin work with the Live Blogroll plugin?<\/dt>\n<dd><p>Yes. Simply add the livelinks=1 parameter and the Live Blogroll plugin will attempt to get the latest updates from the sites.<\/p>\n\n<p><strong>Example:<\/strong><\/p>\n\n<ul>\n<li>Add Live Blogroll support to links:\n\n<ul>\n<li><strong><code>[wp-blogroll livelinks=1]<\/code><\/strong><\/li>\n<\/ul><\/li>\n<\/ul><\/dd>\n<dt>How can I further customize the output format?<\/dt>\n<dd><ul>\n<li>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.<\/li>\n<li>Option 2: Go to the <a href=\"http:\/\/0xtc.com\/2009\/04\/22\/wp-render-blogroll-links-plugin.xhtml\" title=\"WP Render Blogroll Links\">plugin's page<\/a> and contact the author.<\/li>\n<\/ul><\/dd>\n<dt>This plugin has saved me time and headaches. How can I possibly thank you enough?<\/dt>\n<dd><ul>\n<li>To send donations go to <code>Settings<\/code> -&gt; <code>WP Blogroll Links<\/code>. There's a donate box you can use to thank us as much as you would like :)<\/li>\n<\/ul><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.1.8<\/h4>\n\n<ul>\n<li>Image URL bugfix.<\/li>\n<\/ul>\n\n<h4>2.1.7<\/h4>\n\n<ul>\n<li>Showdash\/Showbrk bugfix.<\/li>\n<\/ul>\n\n<h4>2.1.6<\/h4>\n\n<ul>\n<li>Added showdash option.<\/li>\n<\/ul>\n\n<h4>2.1.5<\/h4>\n\n<ul>\n<li>Minor bugfix for Live Blogroll users.<\/li>\n<\/ul>\n\n<h4>2.1.4<\/h4>\n\n<ul>\n<li>Updated documentation for catname.<\/li>\n<\/ul>\n\n<h4>2.1.3<\/h4>\n\n<ul>\n<li>Officially supporting Wordpress 3.0.1<\/li>\n<li>Added option for donations.<\/li>\n<\/ul>\n\n<h4>2.1.2<\/h4>\n\n<ul>\n<li>Officially supporting Wordpress 3.x.<\/li>\n<li>Removed useless postbox bit in the script that was causing javascript errors.<\/li>\n<\/ul>\n\n<h4>2.1.1<\/h4>\n\n<ul>\n<li>Added support for the Live Blogroll plugin.<\/li>\n<\/ul>\n\n<h4>2.1.0<\/h4>\n\n<ul>\n<li>Added linkclass support for setting link classnames.<\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>No new functional changes in this version.<\/li>\n<li>Tested plugin on Wordpress 3.0-RC1<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>Added an admin page with documentation.<\/li>\n<li>Show\/hide of links per click on category<\/li>\n<li>Bookmarklet for links<\/li>\n<\/ul>\n\n<h4>1.x.x<\/h4>\n\n<ul>\n<li>Added limit support<\/li>\n<li>Added option to show category descriptions<\/li>\n<li>Added SEO option to force relations. (will render rel=\"external\", rel=\"nofollow\" to links)<\/li>\n<li>Allowing interoperability with plugins like FAVIROLL<\/li>\n<li>added support for setting category order<\/li>\n<li>you can now exclude categories<\/li>\n<li>You can show the link names even if the links have images.<\/li>\n<li>You can hide all link images.<\/li>\n<li>Links that have RSS feeds can optionally show them.<\/li>\n<li>RSS feed default icon can be changed.<\/li>\n<\/ul>","raw_excerpt":"Create a links page with a simple shortcode \/ tag. No additional templates needed.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/48053","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=48053"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/0xtc"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=48053"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=48053"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=48053"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=48053"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=48053"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=48053"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}