{"id":7278,"date":"2009-11-19T08:53:51","date_gmt":"2009-11-19T08:53:51","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/random-blogroll-category\/"},"modified":"2010-06-28T03:11:32","modified_gmt":"2010-06-28T03:11:32","slug":"random-blogroll-category","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/random-blogroll-category\/","author":5254027,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.5","stable_tag":"trunk","tested":"2.8.5","requires":"2.5","requires_php":"","requires_plugins":"","header_name":"Random Blogroll Category","header_author":"KJ Coop","header_description":"","assets_banners_color":"","last_updated":"2010-06-28 03:11:32","external_support_url":"","external_repository_url":"","donate_link":"https:\/\/www.paypal.com\/cgi-bin\/webscr?cmd=_s-xclick&hosted_button_id=9832383","header_plugin_uri":"http:\/\/kjcoop.com\/portfolio\/random_blogroll_category.php","header_author_uri":"http:\/\/kjcoop.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":1242,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":0},"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":[],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[2657,89,244],"plugin_category":[],"plugin_contributors":[94606],"plugin_business_model":[],"class_list":["post-7278","plugin","type-plugin","status-publish","hentry","plugin_tags-blogroll","plugin_tags-category","plugin_tags-random","plugin_contributors-kjcoop","plugin_committers-kjcoop"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/random-blogroll-category.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>This plugin will display a given number of random blogroll categories to show.\nIt will show all the links in those categories.<\/p>\n\n<h3>Usage<\/h3>\n\n<p>Unless you've changed some defaults, your blogroll is most likely displayed by\nthe following line of code in wp-content\/themes\/[your theme]\/sidebar.php:\n    <\/p>\n\n<p>The simplest way to display a random category is just by replacing that line\nwith a call to blogroll_random_category:\n    <\/p>\n\n<p>If you want to include a link to the whole blogroll, you can create a page in\nwordpress using the links template. Note the permalink. If you've already got a\nlist of your pages in the sidebar, you're in business. Otherwise you can add one\nwith the following line of code:\n    <a href=\"[your permalink]\">See complete blogroll<\/a><\/p>\n\n<p>If your blogroll is not set to be categorized, or if there is only one category,\nit will return the whole thing untouched.<\/p>\n\n<h3>Advanced<\/h3>\n\n<h3>Showing multiple categories<\/h3>\n\n<p>If you want multiple categories returned, you can send the function that number.\nFor example:\n    \nwill return 5 randomized categories. If you only have 4 categories, it will\nreturn all of them in a random order.<\/p>\n\n<h3>Retaining arguments sent to wp_list_bookmarks<\/h3>\n\n<p>If you're sending arguments to wp_list_bookmarks, you can send those to\nblogroll_random_category and it will pass them along to wp_list bookmarks. In\nthis example, we're showing all categories except #23:\n    <\/p>\n\n<p>The change below will show five random categories, none of which will be #23. If\nyou only have four categories, this will return the three that are not #23:\n    <\/p>\n\n<h3>To show one category all the time and the rest randomize the rest<\/h3>\n\n<p>In the sidebar you can explicitly call that category. When only one category is\nselected, this plugin knows to return it as it is. Any subsequent calls to\nblogroll_random_category ought to be instructed to exclude it in order to avoid\nthe possibility that it happens to be randomly selected:<\/p>\n\n<pre><code>&lt;?php wp_list_bookmarks('category=23'); ?&gt;\n&lt;?php blogroll_random_category(5, 'exclude_category=23'); ?&gt;&lt;h3&gt;1.0&lt;\/h3&gt;* The first version.&lt;h3&gt;1.5&lt;\/h3&gt;* Whereas this plugin previously altered the behavior of wp_list_bookmarks in a\n<\/code><\/pre>\n\n<p>way that made it impossible to see the whole blogroll. Now it uses a separate\n  function call so that in some instances you can see random categories, but in\n  others you can see the whole blogroll.\n* Now possible to return multiple random categories without separate function\n  calls, thus eliminiating the possibility that two of the random categories\n  will be the same.<\/p>\n\n<h3>1.5.1<\/h3>\n\n<ul>\n<li>The leading closing li tag was not actually getting trimmed off due to \nbad copying and pasting. That has been resolved.<\/li>\n<\/ul>\n\n<h3>A personal request<\/h3>\n\n<p>If you use\/enjoy this plugin, I'd love to hear from you. You're under no\nobligation, but I'd enjoy knowing that somebody out there is enjoying my work.\nPromptly returning e-mail is not my strong suit, so you may never get the\ncourtesy of a reply, but you can rest assured that I appreciated your effort.<\/p>\n\n<p>I can be reached at kj@kjcoop.com.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload 'random-blogroll-category.php' to the '\/wp-content\/plugins\/' directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<\/ol>\n\n<!--section=faq-->\n<p>None yet.<\/p>","raw_excerpt":"This plug in will select one or more random blogroll categories to show.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/7278","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=7278"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/kjcoop"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=7278"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=7278"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=7278"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=7278"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=7278"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=7278"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}