KJ Coop

<p>This plugin will display a given number of random blogroll categories to show.<br />
It will show all the links in those categories.</p>
<h3>Usage</h3>
<p>Unless you’ve changed some defaults, your blogroll is most likely displayed by<br />
the following line of code in wp-content/themes/[your theme]/sidebar.php:
    </p>
<p>The simplest way to display a random category is just by replacing that line<br />
with a call to blogroll_random_category:
    </p>
<p>If you want to include a link to the whole blogroll, you can create a page in<br />
wordpress using the links template. Note the permalink. If you’ve already got a<br />
list of your pages in the sidebar, you’re in business. Otherwise you can add one<br />
with the following line of code:<br />
    <a href="[your permalink]" rel="nofollow ugc">See complete blogroll</a></p>
<p>If your blogroll is not set to be categorized, or if there is only one category,<br />
it will return the whole thing untouched.</p>
<h3>Advanced</h3>
<h3>Showing multiple categories</h3>
<p>If you want multiple categories returned, you can send the function that number.<br />
For example:</p>
<p>will return 5 randomized categories. If you only have 4 categories, it will<br />
return all of them in a random order.</p>
<h3>Retaining arguments sent to wp_list_bookmarks</h3>
<p>If you’re sending arguments to wp_list_bookmarks, you can send those to<br />
blogroll_random_category and it will pass them along to wp_list bookmarks. In<br />
this example, we’re showing all categories except #23:
    </p>
<p>The change below will show five random categories, none of which will be #23. If<br />
you only have four categories, this will return the three that are not #23:
    </p>
<h3>To show one category all the time and the rest randomize the rest</h3>
<p>In the sidebar you can explicitly call that category. When only one category is<br />
selected, this plugin knows to return it as it is. Any subsequent calls to<br />
blogroll_random_category ought to be instructed to exclude it in order to avoid<br />
the possibility that it happens to be randomly selected:</p>
<pre><code><?php wp_list_bookmarks('category=23'); ?>
<?php blogroll_random_category(5, 'exclude_category=23'); ?><h3>1.0</h3>* The first version.<h3>1.5</h3>* Whereas this plugin previously altered the behavior of wp_list_bookmarks in a
</code></pre>
<p>way that made it impossible to see the whole blogroll. Now it uses a separate<br />
  function call so that in some instances you can see random categories, but in<br />
  others you can see the whole blogroll.<br />
* Now possible to return multiple random categories without separate function<br />
  calls, thus eliminiating the possibility that two of the random categories<br />
  will be the same.</p>
<h3>1.5.1</h3>
<ul>
<li>The leading closing li tag was not actually getting trimmed off due to<br />
bad copying and pasting. That has been resolved.</li>
</ul>
<h3>A personal request</h3>
<p>If you use/enjoy this plugin, I’d love to hear from you. You’re under no<br />
obligation, but I’d enjoy knowing that somebody out there is enjoying my work.<br />
Promptly returning e-mail is not my strong suit, so you may never get the<br />
courtesy of a reply, but you can rest assured that I appreciated your effort.</p>
<p>I can be reached at kj@kjcoop.com.</p>


Random Blogroll Category

This plug in will select one or more random blogroll categories to show.

rajivpant

xenograg

<p>For people who maintain their Web site or blog using the WordPress blog content management system,<br />
blogroll-links is an open source WordPress plugin that uses WordPress’ built-in Blogroll feature and presents links to friends’ home pages and own pages on social networking sites using XFN in the links.</p>
<p>Features of this plugin</p>
<ul>
<li>It can show the links by category in blog posts and WordPress Pages.</li>
<li>It uses WordPress’ standard built-in Blogroll links database. There is no hassle of another list of links to maintain.</li>
<li>It can be used to show only the links assigned to a particular category, by stating the category slug as defined in that category’s setting in WordPress.</li>
<li>It honors the Show/Hidden setting as defined for each link in WordPress.</li>
<li>It displays the link in the same window or new window, as specified for each link in WordPress.</li>
</ul>
<p>To learn more about this plugin, please read my blog post about it titled<br />
<a href="http://www.rajiv.com/blog/2008/02/10/blogroll-links/" rel="nofollow ugc">Social Graphs API: WordPress Plugin: Blogroll Links</a></p>
<p><strong>Examples</strong></p>
<p>See this plugin in action at the following Posts and Pages powered by WordPress:</p>
<p><a href="http://www.rajiv.com/friends/" rel="nofollow ugc">www.rajiv.com/friends/</a></p>
<p>The two lists, first one of links to my own pages on various social networking sites and the second one of links to some of my friends’ pages are generated by this plugin. Yes, those social networks’ logo pictures are also taken by the plugin from the WordPress standard Blogroll links. Code:</p>
<pre><code><h3>My Pages on Social Networking Sites</h3>
</code></pre>
<p>Syntax:</p>
<pre><code>[blogroll-links categoryslug="rajiv-web" sortby="link_name" sortorder="desc"]
</code></pre>
<p>Old syntax for legacy support:<br />
    </p>
<pre><code><h3>Web Sites of Some People I Know</h3>
</code></pre>
<p>Syntax:</p>
<pre><code>[blogroll-links categoryslug="people" sortby="link_name" sortorder="desc"]
</code></pre>
<p><a href="http://www.rajiv.com/charity/" rel="nofollow ugc">www.rajiv.com/charity/</a></p>
<p>This list of charitable organizations with brief descriptions is generated by the plugin. Code:</p>
<p>Syntax:</p>
<pre><code>[blogroll-links categoryslug="charity"]
</code></pre>
<p><a href="http://www.rajiv.com/blog/2004/08/02/search-engines/" rel="nofollow ugc">www.rajiv.com/blog/2004/08/02/search-engines/</a></p>
<p>This list of search engines is maintained as Blogroll links in WordPress. Code:</p>
<p>Syntax:</p>
<pre><code>[blogroll-links categoryslug="search-engines"]
</code></pre>
<p><a href="http://www.rajiv.com/" rel="nofollow ugc">www.rajiv.com/</a></p>
<p>The featured links shown under the “What’s featured here?” section shows the links I’ve categorized as featured in WordPress’ Blogroll links. Code:</p>
<pre><code><a title="featured" name="featured"></a>

<h2>What's featured here?</h2>
</code></pre>
<p>Syntax:</p>
<pre><code>[blogroll-links categoryslug="featured" sortby="link_name" sortorder="desc"]
</code></pre>
<p>Thanks to Dave Grega, Adam E. Falk (xenograg) for their contributions to this code.</p>

Random Blogroll Category vs Blogroll Links