{"id":26661,"date":"2013-12-10T04:37:17","date_gmt":"2013-12-10T04:37:17","guid":{"rendered":"https:\/\/wordpress.org\/plugins-wp\/widget-posts-by-category\/"},"modified":"2013-12-17T00:10:10","modified_gmt":"2013-12-17T00:10:10","slug":"widget-posts-by-category","status":"publish","type":"plugin","link":"https:\/\/ve.wordpress.org\/plugins\/widget-posts-by-category\/","author":62133,"comment_status":"closed","ping_status":"closed","template":"","meta":{"_crdt_document":"","version":"1.0.4","stable_tag":"1.0.4","tested":"3.7.41","requires":"3.7","requires_php":"","requires_plugins":"","header_name":"Widget - Posts By Category","header_author":"Vincent Maglione","header_description":"","assets_banners_color":"eec096","last_updated":"2013-12-17 00:10:10","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"http:\/\/wordpress.org\/plugins\/widget-posts-by-category\/","header_author_uri":"http:\/\/bigsweaterdesign.com","rating":5,"author_block_rating":0,"active_installs":80,"downloads":5537,"num_ratings":2,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","changelog"],"tags":[],"upgrade_notice":[],"ratings":{"1":0,"2":0,"3":0,"4":0,"5":"2"},"assets_icons":[],"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":"818185","resolution":"1544x500","location":"assets"},"banner-772x250.png":{"filename":"banner-772x250.png","revision":"818185","resolution":"772x250","location":"assets"}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0","1.0.1","1.0.2","1.0.3","1.0.4"],"block_files":[],"assets_screenshots":[],"screenshots":[],"jetpack_post_was_ever_published":false},"plugin_section":[],"plugin_tags":[89,166,65154,162],"plugin_category":[43],"plugin_contributors":[83928],"plugin_business_model":[],"class_list":["post-26661","plugin","type-plugin","status-publish","hentry","plugin_tags-category","plugin_tags-posts","plugin_tags-themeable","plugin_tags-widget","plugin_category-customization","plugin_contributors-volfro","plugin_committers-volfro"],"banners":{"banner":"https:\/\/ps.w.org\/widget-posts-by-category\/assets\/banner-772x250.png?rev=818185","banner_2x":"https:\/\/ps.w.org\/widget-posts-by-category\/assets\/banner-1544x500.png?rev=818185","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/widget-posts-by-category_eec096.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"<!--section=description-->\n<p>This widget displays posts in the category, order, and quantity of your choosing. It supports custom templates!<\/p>\n\n<p>After installation, drag-and-drop the new \"Category Widget\" to a widget area, choose the categories you wish to display, and tell it the order and quantity in which you wish to display them.<\/p>\n\n<h3>Templates<\/h3>\n\n<p>The default template is just plain-ol' HTML5, without any CSS; it's meant to fit right into any theme without modification.<\/p>\n\n<p>However, if you're a theme developer and you wish to use custom markup or WP functions inside your template, here's how to customize it:<\/p>\n\n<ol>\n<li>In the root of your theme's directory, create a new file called <code>catswidget.php<\/code> (or copy <code>template.php<\/code> from <code>posts-by-cat-widget\/views<\/code> to your theme's root, and rename it <code>catswidget.php<\/code>, if you'd rather use the default as a starting point).<\/li>\n<li>Craft your loop. Just make sure you use the <code>$posts<\/code> variable, like this:<code>if ( $posts -&gt; have_posts() ) : \n        while ( $posts -&gt; have_posts() ) :\n            $posts -&gt; the_post(); ?&gt;\n            \/\/ Your markup here\n        endwhile;\n    endif;<\/code><\/li>\n<li>The widget is just a simple custom loop, so you'll have access to whatever data WP_Query has access to inside the loop.<\/li>\n<\/ol>\n\n<h3>TODO<\/h3>\n\n<ul>\n<li>Perhaps we could use it to query custom post types\/taxonomies, not just Posts<\/li>\n<li>Add hooks\/filters<\/li>\n<li>Add ability to extend admin<\/li>\n<\/ul>\n\n<!--section=installation-->\n<ol>\n<li>Upload <code>posts-by-cat-widget<\/code> to the <code>\/wp-content\/plugins\/<\/code> directory<\/li>\n<li>Activate the plugin through the 'Plugins' menu in WordPress<\/li>\n<li>Use the \"Category Widget\" in any of your sidebars\/widget areas<\/li>\n<\/ol>\n\n<!--section=changelog-->\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>Update to 3.8<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Plugin wasn't installing properly in the WP dashboard...maybe updating its headers will fix the issue.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Minor updates to readme<\/li>\n<\/ul>\n\n<h4>1.0<\/h4>\n\n<ul>\n<li>Release<\/li>\n<\/ul>","raw_excerpt":"A simple, themeable widget which displays posts in the category, order, and quantity of your choosing.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/26661","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=26661"}],"author":[{"embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/volfro"}],"wp:attachment":[{"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=26661"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=26661"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=26661"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=26661"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=26661"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ve.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=26661"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}