Posts By Category Widget

Description

This widget displays posts in the category, order, and quantity of your choosing. It supports custom templates!

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.

Templates

The default template is just plain-ol’ HTML5, without any CSS; it’s meant to fit right into any theme without modification.

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:

1. In the root of your theme’s directory, create a new file called catswidget.php (or copy template.php from posts-by-cat-widget/views to your theme’s root, and rename it catswidget.php, if you’d rather use the default as a starting point).
2. Craft your loop. Just make sure you use the $posts variable, like this:if ( $posts -> have_posts() ) :
while ( $posts -> have_posts() ) :
$posts -> the_post(); ?>
// Your markup here
endwhile;
endif;
3. The widget is just a simple custom loop, so you’ll have access to whatever data WP_Query has access to inside the loop.

TODO

• Perhaps we could use it to query custom post types/taxonomies, not just Posts
• Add hooks/filters
• Add ability to extend admin

Installation

1. Upload posts-by-cat-widget to the /wp-content/plugins/ directory
2. Activate the plugin through the ‘Plugins’ menu in WordPress
3. Use the “Category Widget” in any of your sidebars/widget areas

Reviews

Contributors & Developers

Changelog

1.0.4

• Update to 3.8

1.0.2

• Plugin wasn’t installing properly in the WP dashboard…maybe updating its headers will fix the issue.

1.0.1

• Minor updates to readme

1.0

• Release