=== AVH Extended Categories Widgets ===
Contributors: petervanderdoes
Donate link: http://blog.avirtualhome.com/wordpress-plugins/
Tags: extended, categories, widget, top categories
Requires at least: 2.3
Tested up to: 3.0-Beta1
Stable tag: 3.2.1

The AVH Extended Categories Widgets gives you three widgets for displaying categories.
== Description ==

The AVH Extended Categories Widgets gives you three widgets for displaying categories.

1. Replacement of the default category widget to allow for greater customization.

1. A top categories widget. Shows the top X categories. This requires WordPress 2.8 or higher.

1. A Category Group widget. Shows categories from a group which is associated with the post/page that the visitor is looking at. Categories can be added to a group. Multiple groups can be made and every post/page can be associated with a different group. This requires WordPress 2.8 or higher.

The replacement widget gives you the following customizable options:

* Title of the widget.
* Display as List or Drop-down.
* Show number of posts (Count) after the category.
* Hide empty categories.
* Show categories hierarchical.
* Show categories up to a certain depth. (Requires WordPress 2.8 or higher).
* Sort by ID, Name, Count, Slug.
* Sort ascending or descending.
* Show RSS link after the category as text or image.
* Select which categories to show. (Requires WordPress 2.5.1 or higher).

The Top Categories widget gives you the following customizable options:

* Title of the widget.
* How many categories to show.
* Display as List or Drop-down.
* Show number of posts (Count) after the category.
* Sort by ID, Name, Count, Slug.
* Sort ascending or descending.
* Show RSS link after the category as text or image.
* Select which categories to show. (Requires WordPress 2.5.1 or higher).

The Category Group widget gives you the following customizable options:

* Title of the widget. Either per widget or per group.
* Display as List or Drop-down.
* Show number of posts (Count) after the category.
* Hide empty categories.
* Sort by ID, Name, Count, Slug.
* Sort ascending or descending.
* Show RSS link after the category as text or image.

You can set the following options for the Category Group Widget:

* Which group to show on the home page.
* Which group to show when no group is associated with a post. Useful for older posts that don't have the association.
* Set the default group when editing or creating a post.

You can also select not to show the Category Group widget by selecting the group: None
 
Translations:

* Czech - Čeština (cs_CZ) in Launchpad by Dirty Mind - http://dirtymind.ic.cz
* Spanish - Español (es_ES) in Launchpad
* Italian - Italiano (it_IT) in Launchpad - Gianni Diurno - http://gidibao.net
* French - Français (fr_FR) in Launchpad - BeAlCoSt - http://www.aclanester56.com/

== Installation ==

The AVH Extended Categories Widgets can be installed in 3 easy steps:

1. Unzip the extended-categories-widget archive and put the directory "extended-categories-widget" into your "plug-ins" folder (wp-content/plugins/).

1. Activate the plug-in

1. Go to the Presentation/Appearance->Widgets page and drag the widget into the sidebar of your choice. Configuration of the widget is done like all other widgets.


== Frequently Asked Questions ==

= What about support? =
I created a support site at http://forums.avirtualhome.com where you can ask questions or request features.

= Depth selection =
Starting with version 2.0 and WordPress 2.8 you can select how many levels deep you want to show your categories. This option only works when you select Show Hierarchy as well.

Here is how it works: Say you have 5 top level categories and each top level has a number of children. You could manually select all the Top Level categories you want to show but now you can do the following:
You select to display all categories, select to Show hierarchy and select how many levels you want to show, in this case Toplevel only.

= I want to help and translate the plug-in =
The .pot file is included with the plug-in.
If you have created a language pack, or have an update of an existing one, you can send the [gettext .po and .mo files](http://codex.wordpress.org/Translating_WordPress) to me so that I can include them in future releases.
I'll keep a list of translators and their websites here in the readme.txt and on my website.

I have also setup a project in Launchpad for translating the plug-in. Just visit http://bit.ly/95WyJ

== Screen shots ==
None

== Changelog ==
= Version 3.2.1 =
* Speed improvements in the admin section when there are a lot of categories and several Categories widgets.

= Version 3.2.0.1 =
* Bugfix: Forgot to add a directory into SVN.

= Version 3.2 =
* Compatibility issues with upcoming WordPress 3 resolved.
* Bugfix: Description of the groups didn't save.
* RFC: All widgets - Option to sort the categories by slug.
* RFC: Category Group widget - Ability to set the widget title per group.

= Version 3.1 =
* Wrap the group widget in a div with id = name of group. This enables CSS modification based on the group.
* Hierarchical now works with the option "Select Categories" as well.
* Bugfix: If the normal widget and group widget are displayed on the same page as dropdown, the selected option could be the wrong one.
* Bugfix: In a RTL-based theme the admin menu would flip back to the left, instead of staying right.
* Bugfix: Hierarchical works in the Category Group widget.
* Bugfix: Change div tags in widget from ID to class to comply to W3 validation.

= Version 3.0.2 =
* Bugfix: The plugin conflicts with the standard theme/plugin editor in WordPress
 
= Version 3.0.1 =
* Bugfix: Definition of the metabox for post/page in the wrong place

= Version 3.0 =
* Renamed the plug-in to AVH Extended Categories Widgets
* Added new widget: Category Group. You can create groups with categories and associate the group with a post. The widget will show the categories from the group.
* Added translation: Italian - Italiano (it_IT)
* Added css file for widgets. Using the CSS you can change the layout of the text.
* Redid settings. Settings are now a separate menu.
* Reduced memory foot print.
* Increased speed.
* Development improvements.
* Added uninstall capability.
* Bugfix: The hierarchy check mark in the widgets would disappear.
* Bugfix: In drop down list the hierarchy would appear despite the fact that "Show selected categories only" was selected.
* Note: Some of the translations are not yet complete with version 3.0.

= Version 2.3.3 =
* Bugfix: Validation error on drop down categories.

= Version 2.3.2 =
* Bugfix: Saving the option didn't work
* Added translation: Spanish - Español (es_ES)

= Version 2.3.1 =
* Bugfix: Undefined function

= Version 2.3 = 
* RFC: You can change the text Select Category, without editing any translation file.
* Bugfix: Selecting one parent wouldn't show it's children.
* You can now display only selected categories. This didn't work properly in an hierachical category structure.
* Added Czech translation.

= Version 2.2 =
* RFC: Internationalization of the plug-in.
* Bugfix: W3 Validation Errors when using drop down categories.
* Added option to exclude categories from displaying instead of including them. (Compliments to: Jose Luis Moya - http://www.alsur.es ) 

= Version 2.1 =
* RFC: The path for the RSS image can be URI.

= Version 2.0.3 =
* Bugfix: When selecting hierarchy and showing of all levels, the hierarchy wouldn't be shown.

= Version 2.0.2 =
* Top categories widget caused error in PHP4.

= Version 2.0.1 =
* Reported problem with calling a class by self ()

= Version 2.0 =
* Updated for WordPress 2.8. Unlimited amount of Extended Categories widgets is now possible.
* In WordPress 2.8 you have the options to select depth when showing hierarchy. See FAQ for more information.
* With WordPress 2.8 there is a new widget, AVH Extended Categories Top. This will show the top categories based on amount of posts.

= Version 1.5.1 =
* Bugfix: Compatibility issue with the plug-in wp-security-scan

= Version 1.5 =
* RFC: Option to show RSS feed after categories

= Version 1.4.1 =
* Bugfix: Problem when using multiple widgets with the drop down option.

= Version 1.4 =
* Ability to have up to 9 widgets.

= Version 1.3 =
* You can select which categories to show (Requires WordPress 2.5.1 or higher).

= Version 1.2 =
* When no category or an empty category is selected the dropdown menu shows Select Category, like the default category widget.

= Version 1.1 =
* Drop down menu didn't work. Page wasn't refreshed with selected category.

= Version 1.0 =
* Initial version
