BNS Featured Category

Plugin with multi-widget functionality that displays most recent posts from specific category or categories (set with user options). Also includes user options to display: Category Description; Author and meta details; comment totals; post categories; post tags; and either full post, excerpt, or your choice of the amount of words (or any combination).

Download

Latest version: Download BNS Featured Category v2.1 [zip]

Installation

This section describes how to install the plugin and get it working.

1. Upload bns-featured-category.php to the /wp-content/plugins/ directory
2. Activate through the ‘Plugins’ menu.
3. Place the BNS Featured Category widget appropriately in the Appearance | Widgets section of the dashboard.
4. Set options to personal preferences:

• Widget Title
• Categories – separated by commas
• Show (first) Category Description (checkbox)
• Show Author and date/time details of post (checkbox)
• Show all categories attached to post (checkbox)
• Show all tags attached to post (checkbox)
• Show post in full or use default of post excerpt (checkbox)

– or -

1. Go to ‘Plugins’ menu under your Dashboard
2. Click on the ‘Add New’ link
3. Search for bns-featured-category
4. Install.
5. Activate through the ‘Plugins’ menu.
6. Place the BNS Featured Category widget appropriately in the Appearance | Widgets section of the dashboard.
7. Set options to personal preferences:

• Widget Title
• Categories – separated by commas
• Show (first) Category Description (checkbox)
• Show Author and date/time details of post (checkbox)
• Show all categories attached to post (checkbox)
• Show all tags attached to post (checkbox)
• Show post in full or use default of post excerpt (checkbox)

Read this article for further assistance: http://wpfirstaid.com/2009/12/plugin-installation/

Shortcode: bnsfc

Parameters are very similar to the plugin:

• ‘title’ => ”,
• ‘cat_choice’ => ’1′
• ‘use_current’ => false
• ‘count’ => ’0′
• ‘show_count’ => ’3′
• ‘offset’ => ’0′
• ‘sort_order’ => ‘desc’
• ‘use_thumbnails’ => true
• ‘excerpt_thumb’ => ’50′
• ‘show_meta’ => false
• ‘show_comments’ => false
• ‘show_cats’ => false
• ‘show_cat_desc’ => false
• ‘show_tags’ => false
• ‘only_titles’ => false
• ‘excerpt_length’ => ”

NB: Use the shortcode at your own risk!

FAQ

Q. Can I use this in more than one widget area?
A. Yes, this plugin has been made for multi-widget compatibility. Each instance of the widget will display, if wanted, differently than every other instance of the widget.

Q. How can I style the plugin output?
A. The plugin uses several “common” WordPress functions that create standard class and id elements that can be styled in the style.css file
* the classes generated by the post_class() function; and, the id generated by “post-” appended to the_ID() function wrap the general post output
* the plugin class post-details wraps the general meta details of the post, such as the Author, Categories, Tags, etc.
* the overall plugin may also be wrapped in a widget “container” class, or id, specific to the theme itself such as (but not limited to): widget, sidebar, left, right, etc.

As of version 1.9, you may create a custom stylesheet using the name bnsfc-custom-style.css; and save it to the BNS Featured Category plugin folder.
Elements you add into this file will not be overwritten with future plugin updates. With the addition of the display Category Description option an additional class was written into the plugin.
To style the category description displayed add the class ‘bnsfc-cat-desc’ to your bnsfc-custom-style.css file then use your choice of properties to style the text, for example:

.bnsfc-cat-desc {font-style: italic;}

= What style elements are specifically generated by the plugin?

The following CSS elements are generated by the plugin code:

• .bns-featured-category
• .bnsfc-link
• .bnsfc-cat-class-< category choice(s) >
• .bnsfc-cat-desc
• .bnsfc-clear
• .bnsfc-content

Additional style elements may be available but are most likely created through WordPress core functionality, the current active Theme, or another active plugin.

Q. Can I increase the maximum posts to display?
A. As of version 1.6.2 the Total Posts to Display is independent of the “posts per page” setting as set under Settings | Reading.

Changelog

2.1

• Added option to set post sort order – ascending, descending, and random
• Added ‘no excerpt at all’ checkbox option

2.0

• Added BNS_Options_Scripts_and_Styles
• Added inline documentation indicating what conditions will partially collapse the widget options panel
• Added *-toggle variables for collapse effect
• Added code to remove spaces (if used) when multiple categories are chosen
• Added current_theme_supports check for post-thumbnails; no support = no thumbnail options

1.9.3

• Fixed problem with non-existent custom stylesheet (see 1.9.1)

1.9.2

• Added ‘offset’ option
• Add CSS to set background to none; and width to 100% when shortcode used

1.9.1

• Removed extra slash in wp_enqueue_scripts parameters
• Added ‘content_thumb’ and ‘show_full’ to shortcode options – back to beta
• Fixed 404 error when ‘bnsft-custom-style.css’ is not available

1.9

• released November 2011
• confirmed compatible with WordPress 3.3
• added phpDoc Style documentation
• added i18n support
• added bnsfc-style.css for plugin specific elements
• added wp_link_pages after the_content
• changed code blocks order to more logical sequence
• changed bnsfc_first_words to bnsfc_custom_excerpt (refactored documentation)
• changed options panel width to 200px to fit within Administration Panel Sidebar
• changed bns-cat-class- to bnsfc-cat-class- CSS prefix for category choices for consistency
• corrected documentation typos
• fix ‘only_titles’ form issue
• minor code and format clean-up
• updated ‘readme.txt’ Frequently Asked Questions
• updated screenshot image

1.8.5

• released May 2011
• confirmed compatible with WordPress version 3.2
• addressed some minor items in the readme (this file)
• cleaned up some text strings in the code
• minor variable changes – load_bnsfc_widget(), bnsfc_custom_excerpt()

1.8.4 / 1.8.4.1

• released April 2011
• confirmed compatible with WordPress 3.1.1
• added option to use current category of post in single view

1.8.3

• released December 11, 2010
• Confirm compatible with WordPress 3.1 (beta)
• Change ‘the_time’ to date-format option
• Only show number of comments if not password protected

1.8.2

• released Sept 21, 2010
• added new and improved shortcode functionality – still may be considered beta

1.8.1

• removed shortcode function due to error issues

1.8

• released Sept 19, 2010
• increased minimum required WordPress version to 2.9
• add post_thumbnail support
• added experimental shortcode support – currently best used to generate the only content on a post or page

1.7.2

• released: 29 Aug 2010
• compatibility check for WordPress 3.0.1
• no other modifications

1.7.1

• released: July 5, 2010
• cleaned up code to meet WP Standards
• added wp_reset_query();

1.7

• compatible with WordPress version 3.0
• updated license declaration

1.6.3

• removed the_ID() function as redundant
• added category related span around widget title

1.6.2.3

• compatible with WordPress version 2.9.2
• updated license declaration

1.6.2.2

• clarified the plugin release under a GPL license

1.6.2.1

• compatibility check for 2.9.1 completed

1.6.2

• Total Posts to Display can now exceed the posts_per_page option value.

1.6.1

• Minor correction to variable structure to allow for multiple instances of the plugin with independent post counts

1.6

• added option to display the description for the (first) category choice as taken directly from the Categories panel under Posts in the Dashboard
• wrapped Category Description in its own class: ‘bnsfc-cat-desc’
• corrected issue with checkbox not displaying its state correctly
• Updated the screenshot to show the most recent version of the options panel

1.5.1

• modified excerpt function name to make more unique to plugin

1.5

• added option to set the quantity of the first words of the post to display instead of the default excerpt.
• modified description to reflect new functionality
• slightly increased the size of option panel to better display controls

1.4

• added version control compared against $wp_version
• added horizontal rule to option panel for clarity

1.3

• code cleanup and error trapping
• added dynamic reference of maximum posts based on blog Settings | Reading “posts per page”

1.2

• code clean up
• changed the_content(__(‘Read more …’)) to the_content() as a more “default” version

1.1

• added option for Post Titles only
• added <div style="overflow-x: auto"> wrapper to allow for images wider than the widget area

1.0

• Initial Release.