Accordion Categories is a Wordpress widget that allows you to display categories in hierachical order

Description
------------

Accordion Categories allows you to show categories menu in a sidebar. Every instance of the widget can be configured according to your needs.
This widget helps visitors of your site to navigate through categories easily. Auto overflow style generation is supported.

Main Features
-------------

The major features of Accordion Categories include:

* Display categories hierarchically.
* Show/hide empty categories (without any post).
* Show/hide a category post count (number of post associated with a category) including all children categories
* Show categories icons (using filter)
* Auto overflow padding, used for creating styles dynamically in order to prevent text overflow

Installation
------------

1. Upload the entire `accordion-categories` folder to the `/wp-content/plugins/` directory.
2. Activate the plugin through the 'Plugins' menu in WordPress.
3. Use `Accordion Categories Menu` widget in any registered sidebar `Appearance->Widgets`

Frequently Asked Questions
--------------------------

#### Why doesn't the feature XX work ?

If you have found a bug, or the plugin doesn't work correctly, please feel free to contact me.
I will do my best to fix an issue.

#### How to use category icons ? 

If you need to have an icon associated with a category I'd suggest you to add a custom category field.
I have provided an example of adding a custom category field. You can find it in the `example/category-icon` folder.
Or you can use your own implementation. The plugin provides a specific filter for that purpose.
The name of the filter to hook - `accordion_category_icon`.


Screenshots
-----------

Widget appearance

<img alt="Widget appearance" src="./screenshot-1.png" width="35%">

Widget configuration

<img alt="Widget configuration" src="./screenshot-2.png" width="35%">

Show empty categories

<img alt="Show empty categories" src="./screenshot-3.png" width="35%">

Autoverflow padding

<img alt="Autoverflow padding" src="./screenshot-4.png" width="35%">

With category icons

<img alt="With category icons" src="./screenshot-5.png" width="35%">


License
-------

    Copyright 2017 Alexander Molochko

    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.
    You may obtain a copy of the License at

       http://www.apache.org/licenses/LICENSE-2.0

    Unless required by applicable law or agreed to in writing, software
    distributed under the License is distributed on an "AS IS" BASIS,
    WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
    See the License for the specific language governing permissions and
    limitations under the License.