Posts By Category Widget

December 17, 2013

Posts By Category Widget Plugin

A simple, themeable widget which displays posts in the category, order, and quantity of your choosing.

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

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

Details

  • Version: 1.0.4
  • Active installations: 100
  • WordPress Version: 3.7
  • Tested up to: 3.7.41

Ratings


5 Stars
4 Stars
3 Stars
2 Stars
1 Stars