=== Featured Category Ad Widget ===
Contributors: dschneidan
Tags: posts, category, featured, multi-widget, sponsored, denver post
Requires at least: 2.9
Tested up to: 3.8
Stable tag: 2.5

Displays sponsored content to match featured category widgets.

== Description ==

Based on BNS Featured Category Widget and esigned to create a Sponsored content block similar in style and design to the output of our modified BNS-Featured-Category widgets. Place widget second in "Main Lower" sidebar.

== Installation ==

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

1. Upload the folder `featured-category-ad-widget` to the `/wp-content/plugins/` directory
2. Activate through the 'Plugins' menu.
3. Place the Featured Category Ad Widget appropriately in the Appearance | Widgets section of the dashboard (Main Lower sidebar).
4. Set options to personal preferences, for example:

* 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)

----
= Shortcode: fcad =
Parameters are very similar to the plugin:

*   'title'             => '',
*   'cat_choice'        => '1'
*   'union'             => false
*   '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
*   'link_title'        => false
*   'show_tags'         => false
*   'only_titles'       => false
*   'excerpt_length'    => ''

NB: Use the shortcode at your own risk!

== Frequently Asked Questions ==

= Can I use this in more than one widget area? =

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.

= How can I style the plugin output? =

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.

Create a stylesheet using the name `fcad-custom-style.css`; and save it to the Featured Category Ad Widget 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 'fcad-cat-desc' to your fcad-custom-style.css file then use your choice of properties to style the text, for example:
`
.fcad-cat-desc {font-style: italic;}
`

= What style elements are specifically generated by the plugin?

The following CSS elements are generated by the plugin code:

* .fcad-featured-category
* .fcad-link
* .fcad-cat-class-< category choice(s) >
* .fcad-cat-desc
* .fcad-clear
* .fcad-content

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

== Screenshots ==
1. The options panel as it appears in default.

== Other Notes ==
* Copyright 2009-2013  Edward Caissie  (email : [email protected])

  This program is free software; you can redistribute it and/or modify
  it under the terms of the GNU General Public License version 2,
  as published by the Free Software Foundation.

  You may NOT assume that you can use any other version of the GPL.

  This program is distributed in the hope that it will be useful,
  but WITHOUT ANY WARRANTY; without even the implied warranty of
  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  GNU General Public License for more details.

  You should have received a copy of the GNU General Public License
  along with this program; if not, write to the Free Software
  Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA  02110-1301  USA

  The license for this software can also likely be found here:
  http://www.gnu.org/licenses/gpl-2.0.html
  
* Please note, support may be available on the WordPress Support forums; but, it may be faster to visit http://buynowshop.com/plugins/bns-featured-category/ and leave a comment with the issue you are experiencing.

== Upgrade Notice ==
Please stay current with your WordPress installation, your active theme, and your plugins.

== Changelog ==
= 0.1 =
* Released December 2013