jQuery Categories List Widget

Description

This plugin provides a widget and a filter to display a collapsible list of categories in your sidebar or posts by using jQuery.

Features

  1. Display a collapsed list of your categories to reduce space.
  2. It uses jQuery for effects and to make them work with most browsers.
  3. Select the symbol for expanding/collapsing categories
  4. Select categories to exclude, so it shows only the categories you want.
  5. Autoexpand selected category (including it parent or child).
  6. Support for multiple instances.
  7. Simple layout configuration
  8. Shortcode support [jQueryCategoriesList]
  9. Translated to Spanish, Italian Russian, Slovak, Czech.
  10. And more to come…

Configuration

  • Title: title of the widget.
  • Trigger Symbol: characters to be displayed as a bullet.
  • Symbol position: where to put the expand/collapse symbol.
  • Effect: jQuery’s effect to use.
  • Order by: display order of categories.
  • Expand: if list should be expanded or callapsed by default.
  • Show number of posts: display how many post are published in the category.
  • Show empty categories: display categories with no posts.
  • Categories to exclude: categories to be excluded from the list.

Screenshots

  • Here you can see a list of categories, those with sub-categories will habe a link on the right to expand its childs.
  • Here you can see a list of categories and its sub-categories expanded.

Installation

  1. Make a directory jquery-categories-list under /wp-content/plugins/
  2. Upload all downloaded files to /wp-content/plugins/jquery-categories-list/
  3. Activate plugin at the plugins section.
  4. Go to Presentation -> Widgets and drag the jQuery Categories List to your sidebar and configure it, if you want to display it inside a post then write [jQueryCategoriesList] at the location where it will be shown and save it.

FAQ

Why this plugin is not working?

By support experience, like 99% of problems are due to:

  • There’s a Javascript error caused by other plugin and it stops any further code execution, check your browser’s logs to find the problem and deactivate the conflict plugin.
  • Your template doesn’t have a wp_footer() function, this plugin requires this function to load JS code at the end of the website to improve speed.
  • You’re using a plugin that removes WordPress’ jQuery version and inserts an old one.
How I can send you a translation?

Send me the translated .mo file to migueluseche(a)skatox.com and indicate the language, I can read english or spanish, so please write me on these languages.

Can I use images as bullets or trigger symbols?

Yes, select ‘Empty Space’ as trigger symbol and Save, then you can add any custom background using CSS,
just play with the widget’s classes .jaw_category, .jcl_symbol, .jcl_link.

Can I show this list inside posts?

Yes, only write [jQueryCategoriesList] anywhere inside a post or page’s contest and it will be
replaced for the archive list when rendering the content. You can add the following parameters to change its behavior:

  1. showcount ( boolean ): Select if you want to show the count post inside category’s name
  2. ‘layout’ ( “right”, “left” ): where to display the symbol
  3. ex_sym: the expansion symbol.
  4. con_sym: the collapse symbol.
  5. fx_in (“none”, “slideDown”, “fadeIn”): the jQuery effect to implement.
  6. orderby (“name”,”id”, “count”): how to order categories.
  7. orderdir (“ASC”, “DESC”): the direction to order categories.
  8. show_empty’ ( boolean ): show categories with no posts.
  9. expand (“all”, “none”): expand or collapase all categories.
  10. exclude: IDs (comma separated) of the categories to exclude.
How can i add multiples instances?

Since 2.0 you can add as many instances as you want, but there’s another way to do it, just add a new Text widget only with the shortcode [jQueryCategoriesList] then it will have a new copy of the widget.

How I contribute to this plugin?

By using it, recommending it to other users, giving it 5 starts at plugin’s wordpress page, suggesting features or coding new features and finally by DONATING using plugin’s website’s donate link,
with the donation I can spend more time on this project.

Can I have different instances with different configuration?

Since 2.0 it’s possible. Each instance has its own configuration. Shortcode widgets are controlled by shortcode attributes.

Reviews

Really great plugin

I looked everywhere for a plugin that would do this and I was only satisfied when I got this one. It worked perfectly out of the box and has many configuration options. Really great work!

Nice and Simple

Works really well, especially to create a simple category page listing.

Recommended.

Good. Missing a feature.

I like this plugin very much.
Easy to use and simple.

It’ll be 5 star if the categories are collapsible to show the posts like in “jQuery Archive List Widget”.

Read all 15 reviews

Contributors & Developers

“jQuery Categories List Widget” is open source software. The following people have contributed to this plugin.

Contributors

Changelog

2.2.5

  • Shortcut has changed to [jQueryCategoriesList] because WordPress 4.4 doesn’t support spaces on shortcodes

2.2.4

  • Minor fixes to support WordPress 4.3 and preparing for 3.0
  • Solved accordion bug with Intenet Explorer 8

2.2.3

  • Solved bug of links not working when using shortcodes
  • Solved bug when a post doesn’t have multiple categories

2.2.2

  • Solved expansion/contraction bug when using sub-categories.
  • Added support for HTTPS, now the plugin generates the correct link if HTTPS is being used, thanks to bridgetwes for the patch.
  • Added ordering by category’s slug.

2.2.1

  • Fixed the problem of a warning message being shown when a post had a single category.
  • Added a CSS class to li elements with child categories.
  • Improved category HTML generation code to make future modifications easier.

2.2.

  • Fixed category’s post count when excluding some categories, now it uses the same algorithm as the standard WP widget.
  • Finally the list expands to the opened/click category! It remembers where you clicked! Just select the expand option to ‘Clicked Category’.
  • Wrapped post count (if activated) inside a span to apply CSS rules.
  • Added a active class for current category.
  • Fixed some spanish translations.
  • Plugin translated to Russian by Матвеев Валерий.

2.1

  • Added option to exclude categories when using shortcodes, just add categorie’s ID separated by commas in the exclude attribute.
  • Solved bug of not including JS file when using a filter without any widget.
  • Solved bug of not including JS in some WP installlations under Windows.

2.0

  • Huge update thanks to donations! If you upgrade to this version you’ll NEED to configurate the widget AGAIN, due to architecture rewriting configuration may get lost.
  • Added support for multiples instances, finally you can have as many widgets as you want without any hack 🙂
  • Added support for dynamic widgets
  • Added an option to not have any effect when expanding or collapsing.
  • Added an option to select if you want the symbol on the left or on the right.
  • Added an option to autoexpand all categories by default.
  • Removed dynamic generation of the JS file, now you don’t need write permissions on the folder.
  • Rewroted JS code, now it is a single JS file for all instances, improved perfomance and compatible with all cache plugins.
  • Updated translation files for Spanish, Czech, Slovak and Italian.

1.3.2

  • Fixed some several bugs, thanks to Marco Lizza who reviewed the code and fixed them. Plugin should be more stable and won’t throw errors when display_errors is on.
  • Added italian translation.

1.3.1

  • Added option to show or hide empty categories.
  • Improved shortcode, now parameters accepts yes, no, 1, or 0 as input.

1.3

  • Improved Javascript code (please save again the configuration to take effect)
  • Better shortcode/filter support. now it has attributes for different behavior on instances. (There’s no support for effect and symbol because it is managed through the JS filse )

1.2.5

  • Fixing i18n bug due to new wordpress changes, now it loads your language (if it was translated) correctly.

1.2.4

  • JS code is not generated dynamically, now it is generated in a separated file. For better performance and to support any minify plugins.

1.2.3

  • Improved generated HTML code to be more compatible when JS is off, also helps to search engines to navigate through archives pages.
  • Added Slovak translation.
  • Cleaned code and make it more readable for future hacks from developers.

1.2.2

  • Changed plugin’s JS file loading to the footer, so it doesn’t affect your site’s loading speed.
  • Added default value for widget’s title. And it is included in translation files, so this can be used in multi-language sites.
  • Plugin translated to Czech (CZ) thanks to Tomas Valenta.

1.2.1

  • Solving sorting bug, now you can choose the categories display order.

1.2

  • Added support for multiples instances (by writing [jQueryCategoriesList] on any Text widget).
  • Fixed a bug when no categories were selected to be filtered.
  • Improved compatibility with WordPress 3.x.

1.1

  • Added support to exclude categories when listing.

1.0

  • Initial public version.